Ir al contenido

Ambiente React Native ed Expo con PNPM

Configurazione professionale dell'ambiente di sviluppo React Native utilizzando Expo CLI e il gestore di pacchetti PNPM per iOS e Android.

0letture

Questa guida descrive la procedura tecnica standard per preparare un ambiente di sviluppo professionale per React Native utilizzando Expo e il gestore di dipendenze PNPM. Copre dai requisiti preliminari del sistema all'inizializzazione e distribuzione locale di un progetto moderno con supporto multi-piattaforma (iOS e Android).


Attualmente, la documentazione ufficiale di React e la comunità tecnica raccomandano la combinazione di Expo e PNPM come ambiente di lavoro standard assoluto:

  • Expo Router: Routing basato su file (simile a Next.js/Astro) completamente integrato e tipizzato.
  • PNPM (Performant NPM): Risolve i gravi problemi storici di lentezza e vulnerabilità di NPM mediante un'architettura basata su collegamenti fisici (hard links) e archiviazione indirizzabile per contenuto.
  • EAS Build/Submit: Compilazione in cloud di binari nativi (.apk, .aab, .ipa) senza la necessità di hardware locale costoso.

Prima di inizializzare qualsiasi applicazione, è essenziale avere i seguenti strumenti installati nel sistema:

  • Node.js (LTS): Si raccomanda la versione attiva con supporto a lungo termine.
  • Gestore di pacchetti: pnpm (Installato globalmente tramite npm i -g pnpm o corepack enable ).
  • Git: Per il controllo di versione del progetto.

Per l'Emulazione Android (Windows/macOS/Linux)

Sección titulada «Para Emulación Android (Windows/macOS/Linux)»
  1. JDK (Java Development Kit): Installare OpenJDK 17 o superiore.
  2. Android Studio: Installare Android Studio e configurare:
    • Android SDK: Assicurarsi di aver scaricato la versione dell'SDK raccomandata dall'ultima release di Expo.
    • Android SDK Platform-Tools: Aggiunto obbligatoriamente alle variabili di ambiente del sistema (PATH).
    • Dispositivo Virtual (AVD): Creare un emulatore con Google Play Services per test locali.
  1. Xcode: Scaricato direttamente dal Mac App Store.
  2. Strumenti della riga di comando di Xcode: Installare eseguendo nel terminale:
    Ventana de terminal
    xcode-select --install
  3. Cocoapods: Gestore delle dipendenze per iOS (sudo gem install cocoapods).

Per creare un nuovo progetto moderno di React Native con Expo utilizzando PNPM, esegui il comando ufficiale interattivo nella directory di lavoro:

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

Una volta completata l'installazione delle dipendenze con PNPM, accedi alla cartella del progetto e avvia il server di sviluppo:

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

All'avvio del server Expo, verranno mostrati un codice QR e delle opzioni di controllo interattive:

  • a Apri in Android: Avvia l'applicazione in un emulatore Android attivo di Android Studio o dispositivo collegato via USB.
  • i Apri su iOS: Avvia l'applicazione nel simulatore iOS di Xcode (richiede macOS).
  • w Apri sul Web: Inizializza la versione web dell'applicazione (utile per il layout rapido).
  • r Ricarica Applicazione: Forza il refresh completo dell'interfaccia utente su tutti i dispositivi connessi.

Assicurati del corretto stato del tuo ambiente prima di iniziare lo sviluppo. Esegui il comando di diagnostica automatizzata di Expo tramite PNPM:

Ventana de terminal
pnpm dlx expo-doctor
  • ✓ Installazione di Node.js LTS: Versione compatibile e ottimale.
  • ✓ Variabili d'Ambiente: ANDROID_HOME e JAVA_HOME assegnate correttamente.
  • ✓ SDK di Android: Componenti minimi installati e riconosciuti da adb.
  • ✓ Expo CLI: SDK in sincronia con la versione di React Native dichiarata in package.json.
  • ✕ Cocoapods (Avviso su Windows): Ignorato con successo se non sviluppi per iOS su questa stazione di lavoro.