Przejdź do treści głównej
Wersja: Następna

Konfiguracja środowiska

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 →

W tym przewodniku dowiesz się, jak skonfigurować swoje środowisko, aby uruchamiać projekt za pomocą Android Studio i Xcode. Dzięki temu będziesz mógł pracować z emulatorami Android i symulatorami iOS, lokalnie budować aplikację i nie tylko.

informacja

Ten przewodnik wymaga zainstalowanego programu Android Studio lub Xcode. Jeśli masz już jeden z tych programów, powinieneś być gotowy do pracy w ciągu kilku minut. Jeśli nie są zainstalowane, należy się spodziewać, że instalacja i konfiguracja zajmie około godziny.

Is setting up my environment required?

Setting up your environment is not required if you're using a Framework. With a React Native Framework, you don't need to set up Android Studio or Xcode as it will take care of building the native app for you

If you have constraints that prevent you from using a Framework, or you'd like to write your own Framework, then setting up your local environment is a requirement. After your environment is set up, learn how to get started without a framework.

System operacyjny do rozwoju​

Target OS​

Instalowanie zależności​

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 →

Będziesz potrzebować Node, interfejsu wiersza poleceń React Native, JDK oraz Android Studio.

Chociaż możesz używać dowolnego edytora do tworzenia aplikacji, musisz zainstalować Android Studio, aby skonfigurować narzędzia potrzebne do budowania aplikacji React Native na Androida.

Node

Postępuj zgodnie z instrukcjami instalacji dla Twojej dystrybucji Linuksa, aby zainstalować Node w wersji 20.19.4 lub nowszej.

Java Development Kit

React Native obecnie rekomenduje wersję 17 Java SE Development Kit (JDK). Używanie nowszych wersji JDK może powodować problemy. Możesz pobrać i zainstalować OpenJDK ze strony AdoptOpenJDK lub użyć menedżera pakietów Twojej dystrybucji.

Android development environment

Konfiguracja środowiska deweloperskiego może być dość żmudna, jeśli dopiero zaczynasz z rozwojem na Androida. Jeśli już znasz Android development, niektóre ustawienia mogą wymagać dostosowania. W obu przypadkach dokładnie postępuj zgodnie z kolejnymi krokami.

1. Install Android Studio

Pobierz i zainstaluj Android Studio. Podczas instalacji upewnij się, że zaznaczone są pola przy wszystkich poniższych elementach:

  • Android SDK

  • Android SDK Platform

  • Android Virtual Device

Następnie kliknij "Next", aby zainstalować wszystkie komponenty.

uwaga

Jeśli pola wyboru są wyszarzone, będziesz miał możliwość zainstalowania tych komponentów później.

Po zakończeniu instalacji i wyświetleniu ekranu powitalnego przejdź do następnego kroku.

2. Install the Android SDK

Android Studio domyślnie instaluje najnowszy Android SDK. Budowanie aplikacji React Native z natywnym kodem wymaga jednak konkretnego SDK Android 15 (VanillaIceCream). Dodatkowe SDK można zainstalować przez SDK Manager w Android Studio.

W tym celu otwórz Android Studio, kliknij przycisk "Configure" i wybierz "SDK Manager".

wskazówka

Menedżer SDK możesz również znaleźć w oknie "Ustawienia" Android Studio, w sekcji Języki i frameworki → Android SDK.

Wybierz zakładkę "SDK Platforms" w SDK Managerze, następnie zaznacz "Show Package Details" w prawym dolnym rogu. Odszukaj i rozwiń pozycję Android 15 (VanillaIceCream), po czym upewnij się, że następujące elementy są zaznaczone:

  • Android SDK Platform 35

  • Intel x86 Atom_64 System Image lub Google APIs Intel x86 Atom System Image

Następnie wybierz zakładkę "SDK Tools" i tutaj również zaznacz "Show Package Details". Odszukaj i rozwiń pozycję "Android SDK Build-Tools", następnie upewnij się, że zaznaczone są 36.0.0 oraz Android SDK Command-line Tools (latest).

Na koniec kliknij "Zastosuj", aby pobrać i zainstalować Android SDK oraz powiązane narzędzia kompilacji.

3. Configure the ANDROID_HOME environment variable

Narzędzia React Native wymagają ustawienia kilku zmiennych środowiskowych do budowania aplikacji z natywnym kodem.

Dodaj następujące linie do pliku konfiguracyjnego $HOME/.bash_profile lub $HOME/.bashrc (jeśli używasz zsh, to odpowiednio ~/.zprofile lub ~/.zshrc):

shell
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
uwaga

Plik .bash_profile jest specyficzny dla bash. Jeśli używasz innej powłoki, musisz edytować odpowiedni plik konfiguracyjny dla tej powłoki.

Wykonaj polecenie source $HOME/.bash_profile dla bash lub source $HOME/.zprofile, aby załadować konfigurację do bieżącej powłoki. Sprawdź, czy ANDROID_HOME jest ustawiona, wykonując echo $ANDROID_HOME, a odpowiednie katalogi zostały dodane do ścieżki poleceniem echo $PATH.

uwaga

Upewnij się, że podałeś poprawną ścieżkę do Android SDK. Rzeczywistą lokalizację SDK znajdziesz w oknie "Ustawienia" Android Studio, w sekcji Języki i frameworki → Android SDK.

Watchman

Postępuj zgodnie z instrukcją instalacji Watchmana, aby skompilować i zainstalować Watchman ze źródeł.

informacja

Watchman to narzędzie Facebooka do monitorowania zmian w systemie plików. Zdecydowanie zalecamy jego instalację dla lepszej wydajności i zwiększonej kompatybilności w niektórych przypadkach brzegowych (możesz próbować działać bez niego, ale wyniki bywają różne; instalacja teraz może zaoszczędzić ci bólu głowy później).

Preparing the Android device

Do uruchomienia aplikacji React Native na Androida potrzebujesz urządzenia z Androidem. Może to być fizyczne urządzenie lub, częściej, możesz użyć Android Virtual Device (AVD), które emuluje urządzenie z Androidem na twoim komputerze.

W obu przypadkach musisz przygotować urządzenie do uruchamiania aplikacji Androidowych w trybie deweloperskim.

Using a physical device

Jeżeli posiadasz fizyczne urządzenie z Androidem, możesz użyć go zamiast AVD, podłączając je do komputera kablem USB i postępując zgodnie z instrukcjami.

Using a virtual device

Jeżeli otworzysz ./AwesomeProject/android w Android Studio, listę dostępnych Android Virtual Devices (AVD) znajdziesz w "AVD Manager". Szukaj ikony wyglądającej tak:

Android Studio AVD Manager

Jeżeli niedawno zainstalowałeś Android Studio, prawdopodobnie będziesz musiał utworzyć nowe AVD. Wybierz "Create Virtual Device...", następnie dowolny telefon z listy i kliknij "Next", po czym wybierz obraz systemu VanillaIceCream na poziomie API 35.

wskazówka

Zalecamy skonfigurowanie przyspieszenia sprzętowego VM w twoim systemie, aby poprawić wydajność. Po wykonaniu tych instrukcji wróć do AVD Manager.

Kliknij "Next", a następnie "Finish", aby utworzyć swoje AVD. W tym momencie powinieneś móc kliknąć zielony trójkątny przycisk obok swojego AVD, aby je uruchomić.

That's it!

Gratulacje! Pomyślnie skonfigurowałeś swoje środowisko deweloperskie.

Now what?