EAS Submit

Automatizando uploads para App Store Connect e Play Console - o guia para enviar artefatos do EAS Build para o TestFlight, App Review e trilhas do Google Play no Expo SDK 57.

Receita

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

# Compila e envia o último artefato
eas build --profile production --platform ios
eas submit --platform ios --latest
 
eas build --profile production --platform android
eas submit --platform android --latest
 
# Compilação + envio em uma única etapa
eas build --profile production --platform ios --auto-submit

// eas.json
{
  "submit": {
    "production": {
      "ios": {
        "appleId": "release@example.com",
        "ascAppId": "1234567890",
        "appleTeamId": "ABCDE12345"
      },
      "android": {
        "serviceAccountKeyPath": "./secrets/play-service-account.json",
        "track": "internal"
      }
    }
  }
}

# Envio em CI sem interação
eas submit --platform all --profile production --latest --non-interactive

Quando usar isso:

• QA passou em um build de pré-visualização - promova o artefato de produção para as lojas.
• CI deve enviar para o TestFlight / trilha interna do Play a cada merge no branch principal.
• Substituindo uploads manuais do Transporter.app ou do Play Console arrastando e soltando.
• Padronizando qual trilha do Play recebe o AAB de cada perfil.

Exemplo de Trabalho

iOS - App Store Connect

Etapa 1 - Criar chave da API App Store Connect

1. App Store Connect → Usuários e Acesso → Integrações → API do App Store Connect.
2. Gere uma chave com a função Gerente de App ou Admin.
3. Baixe o .p8 uma vez - armazene no cofre de segredos da equipe.

eas credentials --platform ios
# Configure a chave da API App Store Connect para envio

Etapa 2 - Configurar eas.json

{
  "submit": {
    "production": {
      "ios": {
        "ascAppId": "1234567890",
        "appleTeamId": "ABCDE12345"
      }
    }
  }
}

Encontre ascAppId em App Store Connect → Informações do App → Apple ID (numérico).

Etapa 3 - Compilar e enviar

eas build --profile production --platform ios
eas submit --platform ios --profile production --latest

Ou com auto-submit:

{
  "build": {
    "production": {
      "distribution": "store",
      "autoIncrement": true
    }
  }
}

eas build --profile production --platform ios --auto-submit

• Builds enviados aparecem no TestFlight em minutos - Distribuição TestFlight
• O envio para o App Review é uma etapa separada no App Store Connect após a validação do TestFlight
• Credenciais de assinatura vêm de Credenciais e Provisionamento iOS - o envio usa chaves de API diferentes

Android - Google Play Console

Etapa 1 - Criar conta de serviço

1. Google Cloud Console → crie uma conta de serviço sem funções padrão.
2. Play Console → Usuários e permissões → convide o e-mail da conta de serviço.
3. Conceda Lançar em produção, excluir dispositivos e usar a assinatura de app do Play (ou permissões de lançamento mais restritas para CI).
4. Baixe a chave JSON → ./secrets/play-service-account.json (ignorado pelo git).

Etapa 2 - Configurar trilhas do eas.json

{
  "submit": {
    "production": {
      "android": {
        "serviceAccountKeyPath": "./secrets/play-service-account.json",
        "track": "internal",
        "releaseStatus": "completed"
      }
    },
    "closed-beta": {
      "android": {
        "serviceAccountKeyPath": "./secrets/play-service-account.json",
        "track": "alpha"
      }
    }
  }
}

Etapa 3 - Compilar AAB e enviar

eas build --profile production --platform android
eas submit --platform android --profile production --latest

• track": "internal" - loop de QA mais rápido - Trilhas de Teste Interno
• Promova de interno → fechado → aberto → produção na interface do Play Console
• versionCode deve ser maior que todos os uploads anteriores - use autoIncrement no perfil de build

Perfis de Envio e CI

# .github/workflows/release.yml (excerto)
name: Release
on:
  push:
    tags: ["v*"]
jobs:
  submit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: 22 }
      - run: npm install -g eas-cli
      - run: eas submit --platform all --profile production --latest --non-interactive
        env:
          EXPO_TOKEN: ${{ secrets.EXPO_TOKEN }}

# Enviar um ID de build específico (não apenas --latest)
eas submit --platform ios --id <build-uuid>

• EXPO_TOKEN - token de máquina de expo.dev → Tokens de acesso
• Armazene o .p8 da Apple e o JSON do Play como segredos de CI - referencie os caminhos em eas.json ou substituições de variáveis de ambiente
• Controle o envio com base em fingerprint inalterado ou aprovação explícita de lançamento

Envio de Artefato Local

Envie IPAs ou AABs compilados fora do EAS:

eas submit --platform ios --path ./dist/ShopApp.ipa
eas submit --platform android --path ./dist/ShopApp.aab --profile production

Use quando:

• Migrando de CI legado que produz artefatos localmente
• Reenviando um build conhecido como bom após uma rejeição apenas de metadados

Erros Comuns

FAQs

Relacionados

• Noções Básicas do EAS Build - produzindo artefatos para lojas
• Credenciais e Provisionamento iOS - assinatura vs chaves de API de envio
• Keystores e Assinatura Android - alinhamento da chave de upload
• Distribuição Interna - caminhos internos do TestFlight e Play
• ../ios-platform/testflight-distribution/testflight-distribution.md - grupos de testadores e expiração de builds
• ../ios-platform/app-store-review-guidelines/app-store-review-guidelines.md - prontidão para revisão
• ../android-platform/internal-testing-tracks/internal-testing-tracks.md - fluxo de promoção de trilhas
• ../cng-prebuild/cng-in-ci/cng-in-ci.md - pipelines de build + submit em CI
• ../expo-rules/release-and-ota-rules/release-and-ota-rules.md - OTA após o envio para a loja

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).