Ś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.
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).
1. Expo i PNPM: Ostateczna kombinacja
Sección titulada «1. Expo y PNPM: La Combinación Definitiva»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.
2. Wymagania wstępne środowiska
Sección titulada «2. Requisitos Previos del Entorno»Przed zainicjalizowaniem dowolnej aplikacji niezbędne jest posiadanie następujących narzędzi zainstalowanych w systemie:
Narzędzia podstawowe
Sección titulada «Herramientas de Base»- 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 pnpmlubcorepack enable). - Git: Do kontroli wersji projektu.
Dla emulacji Androida (Windows/macOS/Linux)
Sección titulada «Para Emulación Android (Windows/macOS/Linux)»- JDK (Java Development Kit): Zainstaluj OpenJDK 17 lub nowszy.
- 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.
Dla emulacji iOS (Wyłącznie na macOS)
Sección titulada «Para Emulación iOS (Exclusivo en macOS)»- Xcode: Pobrany bezpośrednio ze sklepu Mac App Store.
- Narzędzia wiersza poleceń Xcode: Zainstaluj, wykonując w terminalu:
Ventana de terminal xcode-select --install - Cocoapods: Menedżer zależności iOS (
sudo gem install cocoapods).
3. Inicjalizacja projektu z PNPM
Sección titulada «3. Inicialización del Proyecto con PNPM»Aby utworzyć nowy, współczesny projekt React Native z Expo przy użyciu PNPM, wykonaj oficjalne polecenie interaktywne w katalogu roboczym:
# Crear proyecto con la plantilla por defecto recomendada usando PNPMpnpm dlx create-expo-app mi-app-ia --template tabsZalecana struktura katalogów
Sección titulada «Estructura de Directorios Recomendada»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 Expo4. 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:
cd mi-app-iapnpm expo startOpcje uruchamiania interaktywnego w konsoli
Sección titulada «Opciones de Lanzamiento Interactivas en la Consola»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.
5. Lista kontrolna środowiska
Sección titulada «5. Lista de Verificación del Entorno»Upewnij się, że środowisko jest prawidłowo skonfigurowane przed rozpoczęciem rozwoju. Wykonaj polecenie automatycznej diagnostyki Expo za pomocą PNPM:
pnpm dlx expo-doctorWyniki diagnostyki i stan
Sección titulada «Resultados de Diagnóstico y Estado»- ✓ Instalacja Node.js LTS: Wersja kompatybilna i optymalna.
- ✓ Zmienne środowiskowe:
ANDROID_HOMEiJAVA_HOMEprzypisane 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.

