Przejdź do treści głównej

Korzystanie z bibliotek

Nieoficjalne Tłumaczenie Beta

Ta strona została przetłumaczona przez PageTurner AI (beta). Nie jest oficjalnie zatwierdzona przez projekt. Znalazłeś błąd? Zgłoś problem →

React Native dostarcza zestaw wbudowanych Komponentów podstawowych i API gotowych do użycia w Twojej aplikacji. Nie jesteś ograniczony tylko do komponentów i API dołączonych do React Native. Framework ten ma społeczność tysięcy programistów. Jeśli Komponenty podstawowe i API nie oferują potrzebnej funkcjonalności, możesz znaleźć i zainstalować odpowiednią bibliotekę ze społeczności, aby rozszerzyć możliwości swojej aplikacji.

Wybór menedżera pakietów​

Biblioteki React Native są zazwyczaj instalowane z rejestru npm przy użyciu menedżera pakietów Node.js, takiego jak npm CLI lub Yarn Classic.

Jeśli masz Node.js zainstalowany na komputerze, to masz już dostęp do npm CLI. Niektórzy programiści preferują Yarn Classic ze względu na nieco szybszą instalację i dodatkowe funkcje jak Workspaces. Oba narzędzia doskonale współpracują z React Native. Dla uproszczenia w dalszej części przewodnika przyjmiemy, że korzystasz z npm.

uwaga

W społeczności JavaScript terminy "biblioteka" i "pakiet" są używane zamiennie.

Instalowanie biblioteki​

Aby zainstalować bibliotekę w swoim projekcie, przejdź do katalogu projektu w terminalu i uruchom polecenie instalacyjne. Przetestujmy to na przykładzie react-native-webview:

shell
npm install react-native-webview

Ta biblioteka zawiera kod natywny, więc przed użyciem musimy ją podlinkować z naszą aplikacją.

Linkowanie kodu natywnego w iOS​

React Native używa CocoaPods do zarządzania zależnościami w projektach iOS i większość bibliotek React Native stosuje tę samą konwencję. Jeśli używana biblioteka jest wyjątkiem, zapoznaj się z jej dokumentacją (README) w celu uzyskania szczegółowych instrukcji. W większości przypadków obowiązują poniższe kroki.

Uruchom pod install w katalogu ios projektu, aby podlinkować bibliotekę z natywną częścią aplikacji iOS. Skrót umożliwiający wykonanie tego bez przechodzenia do katalogu ios to npx pod-install.

bash
npx pod-install

Po zakończeniu tego procesu przebuduj binarną postać aplikacji, aby zacząć korzystać z nowej biblioteki:

shell
npm run ios

Linkowanie kodu natywnego w Androidzie​

React Native wykorzystuje Gradle do zarządzania zależnościami w projektach Android. Po zainstalowaniu biblioteki z natywnymi zależnościami, przebuduj binarną postać aplikacji, aby aktywować nową funkcjonalność:

shell
npm run android

Wyszukiwanie bibliotek​

React Native Directory to przeszukiwalna baza bibliotek stworzonych specjalnie dla React Native. To pierwsze miejsce, gdzie powinieneś szukać bibliotek do swojej aplikacji.

Wiele bibliotek w tym katalogu pochodzi od React Native Community lub Expo.

Biblioteki React Native Community rozwijane są przez wolontariuszy i specjalistów z firm korzystających z React Native. Zazwyczaj wspierają iOS, tvOS, Android i Windows, ale zakres wsparcia różni się między projektami. Wiele bibliotek w tej organizacji było wcześniej częścią rdzenia React Native.

Biblioteki stworzone przez Expo są pisane w TypeScript i tam, gdzie to możliwe, wspierają iOS, Android oraz react-native-web.

Jeśli nie znajdziesz odpowiedniej biblioteki w React Native Directory, kolejnym dobrym źródłem jest rejestr npm. To podstawowe repozytorium bibliotek JavaScript, jednak nie wszystkie z nich są kompatybilne z React Native. React Native to jedno z wielu środowisk JavaScript (obok Node.js, przeglądarek, Electrona itp.), a npm zawiera biblioteki przeznaczone dla wszystkich tych środowisk.

Sprawdzanie kompatybilności bibliotek​

Czy działa z React Native?​

Zazwyczaj biblioteki stworzone specjalnie dla innych platform nie będą działać z React Native. Przykłady to react-select przeznaczony dla webu i bezpośrednio korzystający z react-dom, oraz rimraf stworzony dla Node.js i operujący na systemie plików. Inne biblioteki jak lodash używają wyłącznie funkcjonalności języka JavaScript i działają w każdym środowisku. Z czasem nabierzesz wyczucia w tej kwestii, ale do tego czasu najprościej jest przetestować bibliotekę samodzielnie. Jeśli okaże się niezgodna, możesz ją usunąć poleceniem npm uninstall.

Czy działa na platformach obsługiwanych przez moją aplikację?​

React Native Directory umożliwia filtrowanie bibliotek pod kątem kompatybilności z platformami takimi jak iOS, Android, Web i Windows. Jeśli interesująca cię biblioteka nie jest tam wymieniona, sprawdź informacje w jej pliku README.

Czy działa z moją wersją React Native?​

Najnowsza wersja biblioteki zwykle jest kompatybilna z najnowszą wersją React Native. Jeśli używasz starszej wersji, sprawdź w pliku README, którą wersję biblioteki należy zainstalować. Konkretną wersję możesz zainstalować poleceniem npm install <library-name>@<version-number>, na przykład: npm install @react-native-community/netinfo@^2.0.0.