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.
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).
1. Expo e PNPM: A Combinação Definitiva
Sección titulada «1. Expo y PNPM: La Combinación Definitiva»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.
2. Pré-requisitos do Ambiente
Sección titulada «2. Requisitos Previos del Entorno»Antes de inicializar qualquer aplicativo, é imprescindível ter as seguintes ferramentas instaladas no sistema:
Ferramentas de Base
Sección titulada «Herramientas de Base»- Node.js (LTS): Recomenda‑se a versão ativa de suporte a longo prazo.
- Gestor de Pacotes:
pnpm(Instalado globalmente mediantenpm i -g pnpmoucorepack 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)»- JDK (Java Development Kit): Instalar OpenJDK 17 ou superior.
- 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.
Para Emulação iOS (Exclusivo no macOS)
Sección titulada «Para Emulación iOS (Exclusivo en macOS)»- Xcode: Descargado directamente de la Mac App Store.
- Xcode Command Line Tools: Instalar ejecutando en la terminal:
Ventana de terminal xcode-select --install - Cocoapods: Gestor de dependencias de iOS (sudo gem install cocoapods).
3. Inicialização do Projeto com PNPM
Sección titulada «3. Inicialización del Proyecto con PNPM»Para crear un nuevo proyecto moderno de React Native con Expo utilizando PNPM, ejecuta el comando oficial interactivo en el directorio de trabajo:
# Crear proyecto con la plantilla por defecto recomendada usando PNPMpnpm dlx create-expo-app mi-app-ia --template tabsEstrutura de Diretórios Recomendada
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. 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:
cd mi-app-iapnpm expo startOpções de Lançamento Interativas no Console
Sección titulada «Opciones de Lanzamiento Interactivas en la Consola»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.
5. Lista de Verificação do Ambiente
Sección titulada «5. Lista de Verificación del Entorno»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:
pnpm dlx expo-doctorResultados de Diagnóstico e Estado
Sección titulada «Resultados de Diagnóstico y Estado»- 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.

