Łączenie 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 →

Nie każda aplikacja wykorzystuje wszystkie natywne możliwości, a dołączanie kodu obsługującego wszystkie te funkcje zwiększyłoby rozmiar pliku binarnego... Nadal jednak chcemy umożliwić dodawanie tych funkcji, gdy tylko są potrzebne.

Mając to na uwadze, udostępniliśmy wiele z tych funkcji jako niezależne biblioteki statyczne.

W przypadku większości bibliotek będzie to tak proste jak przeciągnięcie dwóch plików, czasem konieczny będzie trzeci krok, ale nie więcej.

uwaga

Wszystkie biblioteki dostarczane z React Native znajdują się w folderze Libraries w głównym katalogu repozytorium. Niektóre z nich to czysty JavaScript - wystarczy użyć require. Inne biblioteki wykorzystują też kod natywny - w takim przypadku trzeba dodać te pliki do aplikacji, w przeciwnym razie aplikacja zgłosi błąd przy próbie użycia biblioteki.

Oto kroki do łączenia bibliotek zawierających kod natywny

Automatyczne łączenie

Zainstaluj bibliotekę z zależnościami natywnymi:

shell

npm install <library-with-native-dependencies> --save

informacja

Flaga --save lub --save-dev jest kluczowa w tym kroku. React Native połączy twoje biblioteki na podstawie wpisów dependencies i devDependencies w pliku package.json.

To wszystko! Przy kolejnym budowaniu aplikacji kod natywny zostanie połączony dzięki mechanizmowi automatycznego łączenia.

Ręczne łączenie

Krok 1

Jeśli biblioteka zawiera kod natywny, w jej folderze musi znajdować się plik .xcodeproj. Przeciągnij ten plik do projektu w Xcode (zwykle do grupy Libraries);

Krok 2

Kliknij główny plik projektu (ten z rozszerzeniem .xcodeproj), wybierz Build Phases i przeciągnij bibliotekę statyczną z folderu Products w importowanej bibliotece do sekcji Link Binary With Libraries.

Krok 3

Nie każda biblioteka wymaga tego kroku. Rozważ następujące pytanie:

Czy muszę znać zawartość biblioteki podczas kompilacji?

Oznacza to: czy używasz tej biblioteki po stronie natywnej czy tylko w JavaScript? Jeśli tylko w JavaScript, nie jest potrzebny żaden dodatkowy krok!

Jeśli potrzebujesz wywołać ją z poziomu kodu natywnego, musimy znać nagłówki biblioteki. W tym celu przejdź do ustawień projektu, wybierz Build Settings i wyszukaj Header Search Paths. Tam dodaj ścieżkę do swojej biblioteki. (Wcześniejsza dokumentacja zalecała użycie recursive, ale nie jest to już polecane, gdyż może powodować subtelne błędy kompilacji, szczególnie przy użyciu CocoaPods.)