Ir al contenido

Ambiente de React Native e Expo com PNPM

Configuração profissional do ambiente de desenvolvimento de React Native utilizando Expo CLI e o gestor de pacotes PNPM para iOS e Android.

0lecturas

Este guia detalha o procedimento técnico padrão para preparar um ambiente de desenvolvimento profissional para React Native utilizando Expo e o gestor de dependências PNPM. Cobre desde os pré-requisitos do sistema até a inicialização e implantação local de um projeto moderno com suporte multiplataforma (iOS e Android).


Atualmente, a documentação oficial do React e a comunidade técnica recomendam a combinação de Expo e PNPM como o ambiente de trabalho padrão absoluto:

  • Expo Router: Roteamento baseado em arquivos (similar ao Next.js/Astro) completamente integrado e tipado.
  • PNPM (Performant NPM): Resolve os graves problemas históricos de lentidão e vulnerabilidade do NPM mediante uma arquitetura baseada em links físicos (hard links) e armazenamento endereçável por conteúdo.
  • EAS Build/Submit: Compilação na nuvem de binários nativos (.apk, .aab, .ipa) sem necessidade de hardware local caro.

Antes de inicializar qualquer aplicativo, é imprescindível ter as seguintes ferramentas instaladas no sistema:

  • Node.js (LTS): Recomenda‑se a versão ativa de suporte a longo prazo.
  • Gestor de Pacotes: pnpm (Instalado globalmente mediante npm i -g pnpm ou corepack enable).
  • Git: Para o controle de versões do projeto.

Para Emulação Android (Windows/macOS/Linux)

Sección titulada «Para Emulación Android (Windows/macOS/Linux)»
  1. JDK (Java Development Kit): Instalar OpenJDK 17 ou 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

4. Execução em Modo de Desenvolvimento

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

Uma vez concluída a instalação de dependências com PNPM, acesse a pasta do projeto e inicie o servidor de desenvolvimento:

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

Ao iniciar o servidor do Expo, será exibido um código QR e opções de controle interativas:

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

Garanta o estado correto do seu ambiente antes de iniciar o desenvolvimento. Execute o comando de diagnóstico automatizado do Expo através do 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 (Aviso no Windows): Ignorado com sucesso se você não estiver desenvolvendo para iOS nesta estação de trabalho.