Ir al contenido

Entorno de React Native y Expo con PNPM

Configuración profesional del entorno de desarrollo de React Native utilizando Expo CLI y el gestor de paquetes PNPM para iOS y Android.

0lecturas

Esta guía detalla el procedimiento técnico estándar para preparar un entorno de desarrollo profesional para React Native utilizando Expo y el gestor de dependencias PNPM. Cubre desde los requisitos previos del sistema hasta la inicialización y despliegue local de un proyecto moderno con soporte multiplataforma (iOS y Android).


En la actualidad, la documentación oficial de React y la comunidad técnica recomiendan la combinación de Expo y PNPM como el entorno de trabajo estándar absoluto:

  • Expo Router: Enrutamiento basado en archivos (similar a Next.js/Astro) completamente integrado y tipado.
  • PNPM (Performant NPM): Resuelve los graves problemas históricos de lentitud y vulnerabilidad de NPM mediante una arquitectura basada en enlaces físicos (hard links) y almacenamiento direccionable por contenido.
  • EAS Build/Submit: Compilación en la nube de binarios nativos (.apk, .aab, .ipa) sin necesidad de hardware local costoso.

Antes de inicializar cualquier aplicación, es imprescindible disponer de las siguientes herramientas instaladas en el sistema:

  • Node.js (LTS): Se recomienda la versión activa de soporte a largo plazo.
  • Gestor de Paquetes: pnpm (Instalado globalmente mediante npm i -g pnpm o corepack enable).
  • Git: Para el control de versiones del proyecto.

Para Emulación Android (Windows/macOS/Linux)

Sección titulada «Para Emulación Android (Windows/macOS/Linux)»
  1. JDK (Java Development Kit): Instalar OpenJDK 17 o superior.
  2. Android Studio: Instalar Android Studio y configurar:
    • Android SDK: Asegurar tener descargada la versión del SDK recomendada por la última release de Expo.
    • Android SDK Platform-Tools: Agregado obligatoriamente a las variables de entorno del sistema (PATH).
    • Dispositivo Virtual (AVD): Crear un emulador con Google Play Services para pruebas locales.
  1. Xcode: Descargado directamente de la Mac App Store.
  2. Xcode Command Line Tools: Instalar ejecutando en la terminal:
    Ventana de terminal
    xcode-select --install
  3. Cocoapods: Gestor de dependencias de iOS (sudo gem install cocoapods).

Para crear un nuevo proyecto moderno de React Native con Expo utilizando PNPM, ejecuta el comando oficial interactivo en el directorio de trabajo:

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 vez completada la instalación de dependencias con PNPM, accede a la carpeta del proyecto e inicia el servidor de desarrollo:

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

Opciones de Lanzamiento Interactivas en la Consola

Sección titulada «Opciones de Lanzamiento Interactivas en la Consola»

Al arrancar el servidor de Expo, se mostrará un código QR y opciones de control interactivas:

  • a Abrir en Android: Lanza la aplicación en un emulador activo de Android Studio o dispositivo conectado por USB.
  • i Abrir en iOS: Lanza la aplicación en el simulador de iOS de Xcode (requiere macOS).
  • w Abrir en Web: Inicializa la versión web de la aplicación (útil para maquetación rápida).
  • r Recargar Aplicación: Fuerza el refresco completo de la UI en todos los dispositivos conectados.

Asegura el correcto estado de tu entorno antes de iniciar el desarrollo. Ejecuta el comando de diagnóstico automatizado de Expo a través de PNPM:

Ventana de terminal
pnpm dlx expo-doctor
  • ✓ Instalación de Node.js LTS: Versión compatible y óptima.
  • ✓ Variables de Entorno: ANDROID_HOME y JAVA_HOME asignadas correctamente.
  • ✓ SDK de Android: Componentes mínimos instalados y reconocidos por adb.
  • ✓ Expo CLI: SDK en sincronía con la versión de React Native declarada en package.json.
  • ✕ Cocoapods (Advertencia en Windows): Ignorado con éxito si no desarrollas para iOS en esta estación de trabajo.