Noções Básicas de CLI para RN

Os 20 comandos de terminal que você executa diariamente construindo aplicativos Expo SDK 57 - Metro, prebuild, execuções nativas locais e fluxos de trabalho na nuvem EAS. Trate esta página como um cartão de referência de receitas; a depuração específica da plataforma está em xcrun simctl e adb.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

# Inicialização matinal (cliente de desenvolvimento no simulador)
npx expo start --dev-client
npx expo run:ios --simulator "iPhone 16 Pro"   # ou: npx expo run:android
 
# Verificação de integridade antes de um PR ou lançamento
npx expo-doctor
npm run lint && npx tsc --noEmit && npm test -- --ci
 
# Compilação na nuvem + envio (após eas.json configurado)
eas build --profile production --platform all --non-interactive
eas submit --platform all --latest --non-interactive

Quando recorrer a isto:

• Você precisa do sinalizador exato para tunnel vs LAN vs dev-client sem abrir a documentação.
• Um novo membro da equipe pergunta "o que devo executar após git clone?"
• Scripts de CI devem espelhar comandos do laptop - sem verbos YAML de caso especial.
• Você está decidindo entre expo run:* local e eas build na nuvem.

Exemplo de Trabalho

Dia típico do SDK 57 - do clone a um binário com formato TestFlight:

# 1. Instalar dependências (orientado por lockfile)
npm ci
 
# 2. Verificar alinhamento do SDK
npx expo-doctor
 
# 3. Iniciar Metro para um cliente de desenvolvimento (não Expo Go)
npx expo start --dev-client --clear
 
# 4. Compilar e instalar o shell nativo (primeira vez ou após alteração de dependência nativa)
npx expo run:ios --simulator "iPhone 16 Pro"
# npx expo run:android   # caminho paralelo para Android
 
# 5. Adicionar um pacote com capacidade nativa da maneira Expo
npx expo install expo-camera
npx expo prebuild --platform ios   # apenas quando o plugin altera o projeto nativo
npx expo run:ios
 
# 6. Portão de qualidade pré-merge (o mesmo que CI)
npm run lint
npx tsc --noEmit
npm test -- --ci
 
# 7. Compilação na nuvem com formato de produção
eas build --profile production --platform ios --non-interactive --wait
eas build:list --limit 1 --json > /tmp/last-build.json   # veja a página jq para análise

O que isso demonstra:

• npm ci - instalações determinísticas; CI e laptops compartilham o mesmo grafo.
• expo-doctor - captura desvios de versão React/RN/Expo antes da compilação nativa.
• expo start --dev-client - emparelha com um build de desenvolvimento personalizado, não apenas o Expo Go.
• expo install - resolve semver compatível para módulos SDK 57.
• eas build --wait - bloqueia até que o URL do artefato esteja pronto para repasse de QA.

Mergulho Profundo

Os 20 Comandos Diários

Famílias de Comandos

┌──────────────────────────────────────────────────────────────┐
│ Metro / Loop JS     │ expo start*, expo export, eas update │
├─────────────────────┼────────────────────────────────────────┤
│ Shell Nativo        │ expo prebuild, expo run:ios/android    │
├─────────────────────┼────────────────────────────────────────┤
│ Portões de Qualidade│ expo-doctor, lint, tsc, jest --ci      │
├─────────────────────┼────────────────────────────────────────┤
│ Envio na Nuvem      │ eas build*, eas submit, eas credentials│
└──────────────────────────────────────────────────────────────┘

• Comandos Metro são baratos - execute dezenas de vezes por dia.
• Comandos de execução nativa são caros - execute após alterações de dependência nativa ou entitlements.
• Comandos EAS consomem minutos de build - reserve para perfis que correspondem à assinatura da loja.

Flags que Valem a Pena Memorizar

# Direcionamento para simulador / dispositivo
npx expo run:ios --simulator "iPhone 16 Pro"
npx expo run:ios --device
npx expo run:android --device
 
# CI não interativo (sempre emparelhar com EXPO_TOKEN)
eas build --profile preview --platform android --non-interactive --wait
eas submit --platform ios --latest --non-interactive
 
# Inspecionar último build como JSON (alimenta receitas jq)
eas build:list --limit 5 --json --status finished

Notas do Bash

# Prefira npx para CLIs Expo/EAS de uso único - evita desvios de versão global
npx expo-doctor
npx eas-cli@latest build --profile production --platform all
 
# Exportar token para shells de CI (GitHub Actions define secrets.EXPO_TOKEN)
export EXPO_TOKEN="seu-token-de-robô"
eas whoami   # verificar autenticação antes de builds --non-interactive
 
# Encadear portões como a CI faz - falhar rapidamente
npx expo-doctor && npm run lint && npx tsc --noEmit && npm test -- --ci

Armadilhas

• npm install expo-camera em vez de npx expo install - a versão pode não corresponder ao SDK 57; a compilação nativa falha no CocoaPods ou Gradle. Correção: sempre use npx expo install <pkg>.
• expo start sem --dev-client em um build nativo personalizado - o launcher não consegue encontrar a entrada correta ou o menu de desenvolvimento. Correção: npx expo start --dev-client após expo run:*.
• Executar eas build sem eas login / EXPO_TOKEN em CI - prompts interativos travam o trabalho. Correção: eas login localmente; token de robô em CI - veja Noções Básicas de EAS Build.
• Pular expo-doctor após mesclar dependabot - TypeScript verde, mas etapa de link nativo vermelha. Correção: execute o doctor antes de cada expo run:* ou eas build.
• expo prebuild em cada salvamento de JS - apaga arquivos nativos editados manualmente sob CNG. Correção: execute prebuild apenas quando app.config.ts, plugins ou módulos nativos mudarem.
• Assumir que eas update substitui entitlements ou módulos nativos - OTA é apenas para JS. Correção: use eas build quando o código nativo ou plugins de configuração mudarem.
• Comandos diferentes localmente vs CI - falhas de lançamento "funciona na minha máquina". Correção: scripts npm como fonte única da verdade; CI chama alvos npm run.

Alternativas

FAQs

Relacionados

• xcrun simctl e Simuladores iOS - inicialização, instalação, logs, capturas de tela
• adb e Dispositivos Android - logcat, reversão de porta, instalação de APK
• jq, rg e Logs JSON - analisar eas build:list --json em CI
• Noções Básicas de EAS Build - perfis, eas.json, primeiro build na nuvem
• Noções Básicas de iOS para Desenvolvedores RN - quando expo run:ios o leva ao Xcode
• Noções Básicas de Android para Desenvolvedores RN - modelo mental de adb e Gradle

Versões da Stack: Esta página foi escrita para React 19.2.3, React Native 0.86.0 e Expo SDK 57 (expo ~57.0.4).