Trilhas de Teste Interno

Trilhas de teste fechadas e abertas no Google Play - o guia para lançar builds do Expo SDK 57 para Android para testadores reais antes que os usuários de produção vejam regressões. As trilhas são canais de distribuição do Play Console; o EAS Submit envia AABs assinados para elas.

Receita

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

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

# Construir AAB de release
eas build --platform android --profile production
 
# Enviar para teste interno (ciclo de feedback mais rápido)
eas submit --platform android --profile production --latest
 
# Promover na UI do Play Console: interno → fechado → aberto → produção
# Ou enviar diretamente para alpha/beta com perfil eas.json correspondente
eas submit --platform android --profile closed-beta --latest

// app.config.ts - versionCode monotônico (necessário a cada upload)
export default {
  expo: {
    version: "2.4.0",
    android: {
      package: "com.example.shopapp",
      versionCode: 240012, // incrementar a cada upload para o Play
    },
  },
};

Quando usar isso:

• Primeiro lançamento na Play Store - a trilha interna valida a assinatura, a segurança de dados e a classificação de conteúdo antes da produção.
• O QA precisa de um build entregue pelo Play (não apenas um link interno de APK do EAS) para testar compras no aplicativo e App Links.
• Você deseja 500 testadores beta na trilha fechada antes do lançamento gradual de 5% em produção.
• Rejeição de política - corrija na trilha interna, envie novamente sem afetar os usuários de produção.

Exemplo de Trabalho

Etapa 1 - Criar aplicativo no Play e completar os dados básicos da listagem na loja

1. Play Console → Criar app.
2. Conclua as tarefas obrigatórias do Painel: política de privacidade, segurança de dados, classificação de conteúdo, público-alvo.
3. Ative a Assinatura de App do Play no primeiro upload.

Etapa 2 - Conta de serviço para EAS Submit

# Play Console → Usuários e permissões → Convidar usuário → Conta de serviço
# Google Cloud → IAM → Criar chave JSON → salvar como secrets/play-service-account.json
# Conceder Gerente de Lançamento (ou o mínimo: Lançar para trilhas de teste)

Etapa 3 - Primeiro upload para a trilha interna

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

Play Console → Testes → Teste interno → o lançamento aparece após o processamento (~minutos a horas).

Etapa 4 - Adicionar testadores

Compartilhe o link de opt-in em Testadores → Copiar link - os testadores aceitam o convite e, em seguida, instalam pela Play Store.

Etapa 5 - Promover após aprovação do QA

Play Console → Promover lançamento de interno → fechado → produção.

Ou envie um novo build diretamente para a trilha de produção com "track": "production" atualizado no eas.json quando estiver pronto.

Etapa 6 - Verificar App Links no build interno

# Após o lançamento interno estar ativo no Play (re-assinado com a chave de assinatura do app)
adb shell pm get-app-links com.example.shopapp

Use o SHA-256 da Assinatura de App do Play em assetlinks.json - veja Android App Links.

O que isso demonstra:

• Trilha interna - caminho mais rápido de eas submit para um build instalável do Play.
• Conta de serviço - uploads não interativos amigáveis para CI.
• versionCode - deve aumentar por upload em todas as trilhas.
• Fluxo de promoção - o mesmo artefato pode subir pelas trilhas sem reconstrução.

Mergulho Profundo

Como Funciona

• Trilhas são canais de lançamento do Play Console que compartilham um applicationId, mas têm públicos de testadores diferentes.
• Processamento de AAB - o Google gera APKs específicos para cada dispositivo após o upload; os testadores baixam via Play Store, não por sideload.
• Mesmo pipeline de assinatura - todas as trilhas recebem a Assinatura de App do Play; as diferenças são apenas visibilidade e regras de lançamento.
• EAS Submit - usa a API do Google Play Developer (edits.insert + bundles.upload) para colocar o AAB na trilha escolhida.
• Revisão - Testes internos geralmente pulam a revisão demorada; produção e, às vezes, testes abertos acionam a revisão de política.

Comparação de Trilhas

// Mapeamento de trilha eas.json (convenção comum)
// "alpha"  → Teste fechado
// "beta"   → Teste aberto
// "internal" → Teste interno

Regras de Versionamento

// eas.json - auto-incremento de versionCode no EAS Build
{
  "build": {
    "production": {
      "autoIncrement": true
    }
  }
}

O Que Testar por Trilha

Esboço do Pipeline de CI

# .github/workflows/android-release.yml (conceitual)
jobs:
  build-submit-internal:
    steps:
      - run: eas build --platform android --profile production --non-interactive
      - run: eas submit --platform android --profile production --latest --non-interactive

Portão para promoção em produção com checklist de QA e sessões sem falhas na trilha interna.

Armadilhas

• Mesmo versionCode no reenvio - O Play rejeita duplicatas. Correção: Incremente versionCode ou ative autoIncrement.
• Testadores não conseguem encontrar o app - Eles devem aceitar o link de opt-in com a conta Google no dispositivo. Correção: Reenvie o link; verifique a incompatibilidade de conta.
• Testando APK de depuração em vez de build do Play - IAP e App Links se comportam de maneira diferente. Correção: Instale pela trilha interna do Play após eas submit.
• Pular Segurança de Dados no teste interno - O painel pode bloquear todas as trilhas até que seja concluído. Correção: Conclua as tarefas de conformidade primeiro.
• Beta aberto antes da validação fechada - Avaliações públicas de uma estrela em builds beta. Correção: Trilha fechada com usuários avançados convidados primeiro.
• Promover build com defeito para produção - A promoção copia as notas de lançamento, não uma nova passagem de QA. Correção: Execute o checklist em cada promoção de trilha.

Alternativas

FAQs

Relacionados

• Assinatura e Assinatura de App do Play - chave de upload e Assinatura de App do Play
• Permissões e Política do Play - segurança de dados antes de qualquer trilha ser lançada
• Android App Links - verifique links HTTPS em builds internos
• Matriz de Dispositivos e Tamanho de Página de 16 KB - matriz de teste antes do beta aberto
• ../eas-build/eas-submit/eas-submit.md - detalhes de automação de envio
• ../store-operations/phased-release-and-rollback/phased-release-and-rollback.md - porcentagens de lançamento em produção

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