Przejdź do treści głównej
Wersja: 0.80

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.

uwaga

Ten przewodnik wymaga Android Studio lub Xcode. Jeśli masz już jeden z tych programów zainstalowany, powinieneś móc uruchomić wszystko w ciągu kilku minut. Jeśli nie są zainstalowane, należy spodziewać się, ż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 18.18 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 kreatora instalacji upewnij się, że zaznaczone są pola przy wszystkich następujących elementach:

  • Android SDK

  • Android SDK Platform

  • Android Virtual Device

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

Jeśli pola wyboru są wyszarzone, będziesz mógł zainstalować te komponenty 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".

Menedżer SDK możesz również znaleźć w oknie "Settings" Android Studio, w sekcji Languages & Frameworks → 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 opcję "Show Package Details". Odszukaj i rozwiń pozycję "Android SDK Build-Tools", a następnie upewnij się, że wybrano 35.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

.bash_profile jest specyficzne dla bash. Jeśli używasz innej powłoki, musisz edytować odpowiedni plik konfiguracyjny dla Twojej 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.

Upewnij się, że podałeś poprawną ścieżkę do Android SDK. Rzeczywistą lokalizację SDK znajdziesz w oknie "Settings" Android Studio, w sekcji Languages & Frameworks → Android SDK.

Watchman

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

Watchman to narzędzie Facebooka do śledzenia 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ć pracować bez niego, ale rezultaty bywają różne; instalacja teraz może uchronić Cię przed problemami 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.

Zalecamy skonfigurowanie przyspieszania sprzętowego maszyny wirtualnej w Twoim systemie, aby poprawić wydajność. Po wykonaniu tych instrukcji wróć do Menedżera AVD.

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?