Wprowadzenie do modułów natywnych

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 →

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 →

informacja

Native Module i Native Components to nasze stabilne technologie używane w starszej architekturze. Zostaną one wycofane w przyszłości, gdy Nowa Architektura stanie się stabilna. Nowa Architektura wykorzystuje Turbo Native Module i Fabric Native Components, aby osiągnąć podobne rezultaty.

Czasami aplikacja React Native potrzebuje dostępu do natywnego API platformy, które nie jest domyślnie dostępne w JavaScript, na przykład natywnych interfejsów API do obsługi Apple Pay lub Google Pay. Być może chcesz ponownie wykorzystać istniejące biblioteki Objective-C, Swift, Java lub C++ bez konieczności ich ponownego implementowania w JavaScripcie lub napisać wydajny, wielowątkowy kod do takich zadań jak przetwarzanie obrazów.

System NativeModule udostępnia instancje klas natywnych (Java/Objective-C/C++) w JavaScripcie (JS) jako obiekty JS, umożliwiając wykonywanie dowolnego kodu natywnego z poziomu JS. Chociaż nie oczekujemy, że ta funkcja będzie częścią typowego procesu rozwoju, jej istnienie jest niezbędne. Jeśli React Native nie eksportuje natywnego API, którego potrzebuje twoja aplikacja JS, powinieneś móc je samodzielnie wyeksportować!

Konfiguracja modułu natywnego

Istnieją różne sposoby tworzenia modułu natywnego dla twojej aplikacji React Native:

1. Utworzenie lokalnej biblioteki, którą można zaimportować w twojej aplikacji React Native. Przeczytaj przewodnik Tworzenie lokalnych bibliotek, aby dowiedzieć się więcej.

2. Bezpośrednio w projektach iOS/Android twojej aplikacji React Native

3. Jako pakiet NPM, który może być instalowany jako zależność w twoich/innych aplikacjach React Native.

Niniejszy przewodnik najpierw przeprowadzi cię przez proces implementacji modułu natywnego bezpośrednio w aplikacji React Native. Jednak moduł natywny, który zbudujesz w dalszej części, może być dystrybuowany jako pakiet NPM. Jeśli jesteś tym zainteresowany, zajrzyj do przewodnika Konfigurowanie modułu natywnego jako pakietu NPM.

Rozpoczęcie pracy

W kolejnych sekcjach przeprowadzimy cię przez przewodniki, jak zbudować moduł natywny bezpośrednio w aplikacji React Native. Jako wymaganie wstępne, będziesz potrzebować aplikacji React Native, w której będziesz pracować. Jeśli jeszcze jej nie masz, możesz postępować zgodnie z instrukcjami tutaj, aby skonfigurować aplikację React Native.

Wyobraź sobie, że chcesz uzyskać dostęp do natywnych interfejsów API kalendarza iOS/Android z poziomu JavaScript w aplikacji React Native, aby tworzyć wydarzenia w kalendarzu. React Native nie udostępnia interfejsu API w JavaScripcie do komunikacji z natywnymi bibliotekami kalendarza. Jednak za pomocą modułów natywnych możesz napisać natywny kod, który komunikuje się z natywnymi interfejsami API kalendarza. Następnie możesz wywołać ten natywny kod za pomocą JavaScriptu w swojej aplikacji React Native.

W kolejnych sekcjach utworzysz taki natywny moduł Kalendarz dla Androida i iOS.