Distribuição via TestFlight

Testadores internos/externos e gerenciamento de expiração de builds - o guia do TestFlight para enviar IPAs do Expo SDK 57 para QA, stakeholders e usuários beta antes do lançamento na App Store.

Receita

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

# Construir IPA com formato de produção para TestFlight
eas build --profile production --platform ios
 
# Enviar para o App Store Connect (aba TestFlight)
eas submit --platform ios --latest
 
# Ou construir + enviar em um único fluxo (eas.json)
eas build --profile production --platform ios --auto-submit

// eas.json - perfil de produção para TestFlight
{
  "build": {
    "production": {
      "distribution": "store",
      "ios": {
        "simulator": false
      }
    },
    "preview": {
      "distribution": "internal",
      "ios": {
        "simulator": false
      }
    }
  },
  "submit": {
    "production": {
      "ios": {
        "appleId": "you@example.com",
        "ascAppId": "1234567890",
        "appleTeamId": "ABCDE12345"
      }
    }
  }
}

Quando usar isso:

• O QA precisa de um build iOS instalável sem lançamento público na App Store.
• Validação de universal links, push, Sign in with Apple ou IAP em dispositivos reais.
• Demonstrações para stakeholders em iPhones físicos fora do seu cabo USB.
• Dogfooding de um candidato a lançamento antes do eas submit para o App Review.
• Gerenciamento de grupos beta entre equipes de marketing, QA e executivas.

Exemplo de Trabalho

Passo 1 - Configurar credenciais EAS

eas credentials --platform ios
# Certificado de distribuição + perfil de provisionamento da App Store para o ID do pacote

Certifique-se de que o App Store Connect tenha um registro de aplicativo que corresponda a ios.bundleIdentifier.

Passo 2 - Construir e enviar

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

App Store Connect → aba TestFlight → o build mostra Processando (5–30 minutos) e depois Pronto para Testar.

Passo 3 - Teste interno (caminho rápido)

1. TestFlight → Teste Interno → grupo padrão ou crie um grupo.
2. Adicionar builds - o último upload fica automaticamente disponível para o grupo interno.
3. Testadores instalam o aplicativo TestFlight da App Store → aceitam o convite → instalam o build.

Passo 4 - Teste externo (beta mais amplo)

1. TestFlight → Teste Externo → crie um grupo (por exemplo, Beta Pública).
2. Adicionar build → preencha as notas O que Testar para os revisores.
3. Enviar para o Beta App Review - geralmente horas, não dias.
4. Compartilhe o Link Público ou envie convites por e-mail.

Passo 5 - Lidar com a expiração de 90 dias

Build do TestFlight expira: 2026-04-08
Hoje: 2026-04-01
Ação: agendar eas build esta semana; notificar testadores antes da expiração

# Reconstruir a mesma tag git ou branch de lançamento
eas build --profile production --platform ios
eas submit --platform ios --latest
# Grupos externos: novo build pode precisar de Beta App Review se houver alterações materiais

Automatizar lembretes:

# .github/workflows/testflight-expiry-reminder.yml (conceitual)
# Analisar a API do Connect para o build com expiração mais próxima; enviar para o Slack quando faltarem < 14 dias

O que isso demonstra:

• O caminho interno pula o Beta App Review - o loop mais rápido para engenharia.
• O caminho externo escala para milhares com a validação da Apple.
• A expiração de 90 dias é rígida - planeje reconstruções para maratonas de QA.
• O perfil de produção corresponde à assinatura e às permissões da App Store.

Mergulho Profundo

TestFlight vs. outras distribuições iOS

Para universal links e push, prefira TestFlight (aps-environment de produção) em vez de clientes de desenvolvimento ao validar o comportamento de produção.

Estados de processamento

Upload recebido → Processando → Pronto para Testar → (Externo) Aguardando Revisão → Testando
                     ↓ falha
                  Binário Inválido / Conformidade Ausente

Conformidade Ausente: Responda às perguntas de criptografia no Connect - o mesmo que para a App Store.

Binário Inválido: Frequentemente o manifesto de privacidade (ITMS-91053) - corrija antes que os testadores vejam algo.

Experiência do testador

1. Receber e-mail ou link público.
2. Instalar o aplicativo TestFlight da Apple (se ausente).
3. Aceitar convite → Instalar → o aplicativo aparece na tela inicial.
4. TestFlight mostra as notas de lançamento O que Testar que você fornece.
5. Atualizações automáticas quando você atribui builds mais recentes ao grupo deles.

Logs de travamento e capturas de tela fluem de volta para o Connect → TestFlight → build → Travamentos.

Notas "O que Testar" (modelo)

Build 1.4.0 (42) - Beta de Março de 2026
 
Foco:
- Universal link: https://shop.example.com/orders/demo abre a tela de Pedido
- Push: habilite notificações ao fazer login; tocar na notificação direciona para a caixa de entrada
- Exclusão de conta: Configurações → Excluir Conta
 
Problemas conhecidos:
- Pequeno corte no layout do iPad no carrinho - correção agendada para 1.4.1
 
Credenciais: review@example.com / BetaDemo2026!

Emparelhamento com CI

# Envio de CI não interativo
EXPO_TOKEN=xxx eas build --profile production --platform ios --non-interactive
EXPO_TOKEN=xxx eas submit --platform ios --latest --non-interactive

Bloqueie o envio com base no expo-doctor, testes e tempo de imersão interna no TestFlight antes do beta externo.

Builds de simulador

"ios": { "simulator": true }

• Produz .app para Simulador - não pode ser enviado para o TestFlight.
• TestFlight requer IPAs de dispositivo (simulator: false).

Armadilhas

• Usar developmentClient: true para TestFlight - tipo de binário incorreto para distribuição na loja. Correção: perfil de produção sem a flag de cliente de desenvolvimento para a trilha do TestFlight.
• Esperar push no sandbox com build do TestFlight - TestFlight usa APNs de produção. Correção: chave de push de produção no provedor; aps-environment correto.
• Build expirou no meio do UAT - testadores não conseguem instalar ou atualizar. Correção: reconstruir antes do dia 90; comunicar no Slack.
• Beta externo bloqueado no primeiro travamento - Beta App Review rejeita builds instáveis. Correção: imersão interna primeiro.
• ID do pacote incorreto no Connect - o upload é bem-sucedido para o aplicativo errado. Correção: corresponder ascAppId no perfil de envio do eas.json.
• Universal links "funcionam no simulador" mas falham no TestFlight - AASA / appID incompatível com o ID do pacote de produção. Correção: Universal Links do iOS.

Alternativas

FAQs

Relacionados

• Diretrizes de Revisão da App Store - o que o Beta App Review verifica
• EAS Submit - automação de upload
• Distribuição Interna - alternativa ad hoc
• Credenciais e Provisionamento iOS - configuração de assinatura
• Teste em Dispositivo Físico - USB antes do TestFlight
• Universal Links do iOS - verificação em dispositivo
• Matriz de Teste de Deep Link - Casos de teste do TestFlight

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