Conceptos básicos de CLI para RN

Los 20 comandos de terminal que ejecutas diariamente construyendo apps Expo SDK 57 - Metro, prebuild, ejecuciones nativas locales y flujos de nube EAS. Trata esta página como una tarjeta de referencia de recetas; la depuración específica de plataforma vive en xcrun simctl y adb.

Receta

Tarjeta de referencia de receta rápida - lista para copiar y pegar.

# Inicio de sesión por la mañana (dev client en simulador)
npx expo start --dev-client
npx expo run:ios --simulator "iPhone 16 Pro"   # o: npx expo run:android
 
# Verificación de salud antes de un PR o lanzamiento
npx expo-doctor
npm run lint && npx tsc --noEmit && npm test -- --ci
 
# Compilación en nube - envío (después de configurar eas.json)
eas build --profile production --platform all --non-interactive
eas submit --platform all --latest --non-interactive

Cuándo usar esto:

• Necesitas la bandera exacta para tunnel vs LAN vs dev-client sin abrir documentos.
• Un nuevo compañero pregunta "¿qué ejecuto después de git clone?"
• Los scripts CI deben reflejar comandos de laptop - sin verbos YAML especiales.
• Estás decidiendo entre expo run:* local y eas build en nube.

Ejemplo Funcional

Día típico SDK 57 - desde clone hasta binario tipo TestFlight:

# 1. Instalar deps (impulsado por lockfile)
npm ci
 
# 2. Verificar alineación SDK
npx expo-doctor
 
# 3. Iniciar Metro para un dev client (no Expo Go)
npx expo start --dev-client --clear
 
# 4. Compilar e instalar shell nativa (primera vez o después de cambio de dep nativa)
npx expo run:ios --simulator "iPhone 16 Pro"
# npx expo run:android   # ruta paralela Android
 
# 5. Añadir un paquete capaz de nativo de la forma Expo
npx expo install expo-camera
npx expo prebuild --platform ios   # solo cuando el plugin cambia el proyecto nativo
npx expo run:ios
 
# 6. Puerta de calidad previa a fusión (igual que CI)
npm run lint
npx tsc --noEmit
npm test -- --ci
 
# 7. Compilación en nube con forma de producción
eas build --profile production --platform ios --non-interactive --wait
eas build:list --limit 1 --json > /tmp/last-build.json   # ver página jq para análisis

Qué demuestra esto:

• npm ci - instalaciones deterministas; CI y laptops comparten el mismo gráfico.
• expo-doctor - detecta incompatibilidad de versión React/RN/Expo antes de compilación nativa.
• expo start --dev-client - se empareja con una compilación de desarrollo personalizada, no solo Expo Go.
• expo install - resuelve semver compatible para módulos SDK 57.
• eas build --wait - bloquea hasta que la URL del artefacto esté lista para entrega QA.

Análisis Profundo

Los 20 Comandos Diarios

Familias de Comandos

┌──────────────────────────────────────────────────────────────┐
│ Metro / JS loop     │ expo start*, expo export, eas update │
├─────────────────────┼────────────────────────────────────────┤
│ Native shell        │ expo prebuild, expo run:ios/android    │
├─────────────────────┼────────────────────────────────────────┤
│ Quality gates       │ expo-doctor, lint, tsc, jest --ci      │
├─────────────────────┼────────────────────────────────────────┤
│ Cloud ship          │ eas build*, eas submit, eas credentials│
└──────────────────────────────────────────────────────────────┘

• Comandos Metro son baratos - ejecuta docenas de veces al día.
• Comandos de ejecución nativa son caros - ejecuta después de cambios de dep nativa o derecho.
• Comandos EAS cuestan minutos de compilación - reserva para perfiles que coincidan con firma de store.

Banderas Que Vale la Pena Memorizar

# Orientación simulador / dispositivo
npx expo run:ios --simulator "iPhone 16 Pro"
npx expo run:ios --device
npx expo run:android --device
 
# CI no interactivo (siempre emparejar con EXPO_TOKEN)
eas build --profile preview --platform android --non-interactive --wait
eas submit --platform ios --latest --non-interactive
 
# Inspeccionar última compilación como JSON (alimenta recetas jq)
eas build:list --limit 5 --json --status finished

Notas Bash

# Prefiere npx para CLIs Expo/EAS únicos - evita deriva de versión global
npx expo-doctor
npx eas-cli@latest build --profile production --platform all
 
# Exportar token para shells CI (GitHub Actions establece secrets.EXPO_TOKEN)
export EXPO_TOKEN="your-robot-token"
eas whoami   # verifica auth antes de compilaciones --non-interactive
 
# Encadena puertas de la forma que CI hace - falla rápido
npx expo-doctor && npm run lint && npx tsc --noEmit && npm test -- --ci

Errores comunes

• npm install expo-camera en lugar de npx expo install - la versión puede no coincidir con SDK 57; la compilación nativa falla en CocoaPods o Gradle. Arreglo: siempre npx expo install <pkg>.
• expo start sin --dev-client en una compilación nativa personalizada - el lanzador no puede encontrar la entrada correcta o menú dev. Arreglo: npx expo start --dev-client después de expo run:*.
• Ejecutar eas build sin eas login / EXPO_TOKEN en CI - los mensajes interactivos cuelgan el trabajo. Arreglo: eas login localmente; token robot en CI - ver EAS Build Basics.
• Saltar expo-doctor después de fusionar dependabot - TypeScript verde pero paso de enlace nativo rojo. Arreglo: doctor antes de cada expo run:* o eas build.
• expo prebuild en cada guardado JS - borra archivos nativos editados a mano bajo CNG. Arreglo: prebuild solo cuando app.config.ts, plugins, o módulos nativos cambien.
• Asumiendo eas update reemplaza derechos o módulos nativos - OTA es solo JS. Arreglo: eas build cuando cambia código nativo o plugins de config.
• Comandos diferentes localmente vs CI - "funciona en mi máquina" fallos de lanzamiento. Arreglo: npm scripts como única fuente de verdad; CI llama destinos npm run.

Alternativas

FAQs

Relacionado

• xcrun simctl & iOS Simulators - arrancar, instalar, logs, capturas de pantalla
• adb & Android Devices - logcat, port reverse, instalación APK
• jq, rg & JSON Logs - analiza eas build:list --json en CI
• EAS Build Basics - perfiles, eas.json, primera compilación en nube
• iOS Basics for RN Devs - cuando expo run:ios te lleva a Xcode
• Android Basics for RN Devs - adb y modelo mental Gradle

Versiones de Stack: Esta página fue escrita para React 19.2.3, React Native 0.86.0, y Expo SDK 57 (expo ~57.0.4).