Ir al contenido

Środowisko React Native i Expo z PNPM

Profesjonalna konfiguracja środowiska deweloperskiego React Native przy użyciu Expo CLI i menedżera pakietów PNPM dla iOS i Androida.

0odwiedzin

Niniejszy przewodnik szczegółowo opisuje standardową procedurę techniczną przygotowania środowiska deweloperskiego dla React Native z wykorzystaniem Expo i menedżera zależności PNPM. Obejmuje wszystko, od wymagań wstępnych systemu po inicjalizację i lokalne wdrożenie nowoczesnego projektu z obsługą wielu platform (iOS i Android).


W obecnych czasach oficjalna dokumentacja Reacta i społeczność techniczna zdecydowanie polecają kombinację Expo i PNPM jako absolutne standardowe środowisko pracy:

  • Expo Router: Routing oparty na plikach (podobny do Next.js/Astro) w pełni zintegrowany i z typowaniem.
  • PNPM (Performant NPM): Rozwiązuje poważne problemy z wolnością i podatnością na ataki NPM dzięki architekturze opartej na linkach fizycznych (hard links) i magazynie adresowalnym przez zawartość.
  • EAS Build/Submit: Kompilacja binarnych plików natywnych w chmurze (.apk, .aab, .ipa) bez potrzeby kosztownego sprzętu lokalnego.

Przed zainicjalizowaniem dowolnej aplikacji niezbędne jest posiadanie następujących narzędzi zainstalowanych w systemie:

  • Node.js (LTS): Zalecana jest wersja z aktywnym wsparciem na długi okres.
  • Menedżer pakietów: pnpm (zainstalowany globalnie za pomocą npm i -g pnpm lub corepack enable).
  • Git: Do kontroli wersji projektu.
  1. JDK (Java Development Kit): Zainstaluj OpenJDK 17 lub nowszy.
  2. Android Studio: Zainstaluj Android Studio i skonfiguruj:
    • Android SDK: Upewnij się, że pobrano zalecaną wersję SDK przez ostatnią wersję Expo.
    • Narzędzia platformy Android SDK: Dodaj obowiązkowo do zmiennych środowiskowych systemu (PATH).
    • Wirtualne urządzenie (AVD): Utwórz emulator z usługami Google Play do testów lokalnych.
  1. Xcode: Pobrany bezpośrednio ze sklepu Mac App Store.
  2. Narzędzia wiersza poleceń Xcode: Zainstaluj, wykonując w terminalu:
    Ventana de terminal
    xcode-select --install
  3. Cocoapods: Menedżer zależności iOS (sudo gem install cocoapods).

Aby utworzyć nowy, współczesny projekt React Native z Expo przy użyciu PNPM, wykonaj oficjalne polecenie interaktywne w katalogu roboczym:

Ventana de terminal
# Crear proyecto con la plantilla por defecto recomendada usando PNPM
pnpm dlx create-expo-app mi-app-ia --template tabs
mi-app-ia/
├── app/ # Directorio de rutas (Expo Router)
│ ├── (tabs)/ # Grupo de pestañas de navegación inferior
│ │ ├── _layout.tsx # Definición del enrutador de pestañas
│ │ ├── index.tsx # Pantalla de inicio
│ │ └── explorar.tsx # Pantalla de exploración
│ ├── _layout.tsx # Enrutador raíz (Modales, Autenticación, etc.)
│ └── +not-found.tsx # Pantalla 404 de respaldo
├── assets/ # Imágenes, fuentes y recursos multimedia
├── components/ # Componentes UI reutilizables
├── constants/ # Colores, configuraciones globales y APIs
├── package.json # Dependencias y scripts del ciclo de vida
└── app.json # Configuración nativa del manifiesto de Expo

4. Uruchamianie w trybie deweloperskim

Sección titulada «4. Ejecución en Modo de Desarrollo»

Po ukończeniu instalacji zależności z PNPM, przejdź do folderu projektu i uruchom serwer deweloperski:

Ventana de terminal
cd mi-app-ia
pnpm expo start

Podczas uruchamiania serwera Expo, zostanie wyświetlony kod QR i opcje sterowania interaktywnego:

  • a Otwórz w Androidzie: Uruchamia aplikację na aktywnym emulatorze Android Studio lub urządzeniu podłączonym przez USB.
  • i Otwórz w iOS: Uruchamia aplikację w symulatorze iOS Xcode (wymaga systemu macOS).
  • w Otwórz w sieci: Inicjuje wersję sieciową aplikacji (użyteczna do szybkiej kompozycji).
  • r Przeładuj aplikację: Wymusza pełne odświeżenie interfejsu użytkownika na wszystkich podłączonych urządzeniach.

Upewnij się, że środowisko jest prawidłowo skonfigurowane przed rozpoczęciem rozwoju. Wykonaj polecenie automatycznej diagnostyki Expo za pomocą PNPM:

Ventana de terminal
pnpm dlx expo-doctor
  • ✓ Instalacja Node.js LTS: Wersja kompatybilna i optymalna.
  • ✓ Zmienne środowiskowe: ANDROID_HOME i JAVA_HOME przypisane poprawnie.
  • ✓ SDK Android: Minimalne składniki zainstalowane i rozpoznane przez adb.
  • ✓ Expo CLI: SDK zsynchronizowane z wersją React Native zadeklarowaną w package.json.
  • ✕ Cocoapods (Ostrzeżenie w systemie Windows): Pomyślnie zignorowane, jeśli nie rozwijasz aplikacji iOS na tej stacji roboczej.