KappS Base de conhecimento · Blog

TestFlight em 2026: tutorial de teste interno e externo

Blog Tutorial

O TestFlight é o canal de distribuição pelo qual toda versão do iOS passa antes de chegar à App Store: ele coloca uma compilação nas mãos de testadores reais, em dispositivos reais, sem publicar nada ao público. Em 2026 a mecânica é estável e totalmente documentada — até 100 testadores internos que podem instalar cada compilação no momento em que ela termina o processamento, até 10.000 testadores externos que exigem que a primeira compilação do app seja analisada segundo as Diretrizes de Revisão da App Store, e uma janela rígida de 90 dias após a qual a compilação fica indisponível para todos. Os tutoriais dão errado quando tratam o TestFlight como compartilhamento de arquivos; ele é um ambiente de teste que, por acaso, vive dentro do App Store Connect, com seu próprio portão de revisão, suas próprias informações obrigatórias e seu próprio relógio de expiração.

Este tutorial segue a ordem que o Apple documenta na App Store Connect Ajuda: fornecer informações de teste, enviar o build e liberar a conformidade de exportação, convidar testadores internos, convidar testadores externos, passar pela revisão, distribuir convites, coletar feedback — e, por fim, encerrar o teste de forma deliberada em vez de deixar o relógio de 90 dias fazer isso por você. Cada limite e cada etapa abaixo vêm da documentação TestFlight do próprio Apple, e os números são citados, não parafraseados.


1. O que a TestFlight é — e o que ela não é

O TestFlight distribui builds beta do seu app, gerencia os testadores beta e coleta o feedback deles. Os testadores instalam o app TestFlight gratuito no iPhone, iPad, Mac, Apple TV, Apple Vision Pro ou Apple Watch, aceitam um convite e então recebem os builds que você atribui ao grupo deles. O Apple declara o objetivo sem rodeios: continuar melhorando o app e distribuindo builds até que os problemas sejam resolvidos, e então enviá-lo para revisão.

O que ele não é: uma forma de lançar um produto final fora do App Store. As builds beta continuam sujeitas às Diretrizes de revisão do app, a primeira build que seu app recebe em um grupo é revisada, e um app que existe apenas como build de TestFlight não é um canal de distribuição. O modelo mental que mantém as equipes longe de problemas é simples — o TestFlight é uma sala de ensaio com porteiro, não uma porta lateral.

2. Pré-requisitos — a conta, o registro do app e a compilação

  • Uma assinatura do Programa de Desenvolvedores Apple. TestFlight fica dentro de App Store Connect, então a conta precisa estar regular e a assinatura ativa.
  • Um papel do App Store Connect com acesso ao seu conteúdo. O teste interno é limitado a App Store Connect usuários com acesso ao seu conteúdo — até 100 deles. Na prática, são os papéis que você já usa no dia a dia: Admin, Gerente de App, Desenvolvedor, Marketing.
  • Um registro de app. TestFlight não consegue testar uma compilação sem registro de app; crie o app no App Store Connect primeiro.
  • Uma build elegível ao TestFlight. O Apple deixa explícito que as builds devem incluir identificadores de aplicação nos perfis de provisionamento. Uploads que falham na chegada geralmente são problemas de assinatura ou de Info.plist, não problemas do TestFlight.
  • TestFlight para Mac exige apps criados com o Xcode 13 ou posterior.
  • Contas Apple gerenciadas criadas em domínios reservados não podem ser usadas para testar builds — vale saber antes de convidar um endereço corporativo que nunca vai funcionar.

3. Etapa 1 — Forneça as informações de teste (obrigatório, não é detalhe cosmético)

Antes de qualquer convite, a App Store Connect quer as informações do teste beta que testadores e revisores realmente vão ler.

  • Descrição do app beta — obrigatória. Uma descrição curta da versão beta.
  • E-mail de feedback — obrigatório. Os testadores podem acessar este endereço de dentro do app TestFlight, e ele também é o endereço de resposta nos convites por e-mail que você envia.
  • O que testar — as instruções que os testadores veem na compilação. É o campo que transforma "teste a compilação 42" em feedback útil.
  • Experiência do convite — a caixa de seleção em Informações do app vem marcada por padrão, então suas capturas de tela aprovadas e a categoria do app aparecem no convite, puxadas da versão aprovada mais recente no estado Pronto para Distribuição. Desmarque se preferir mostrar um convite simples.

As informações de teste podem ser atualizadas a qualquer momento e as alterações aparecem no app TestFlight. Preencha-as corretamente antes da primeira revisão externa: uma descrição fraca é uma das poucas causas autoprovocadas de uma revisão lenta e confusa.

4. Etapa 2 — Enviar a compilação e resolver a conformidade de exportação

Envie a compilação para o App Store Connect — Xcode, Transporter ou seu pipeline de CI — e aguarde o processamento. Envio e processamento são estados distintos, e convidar testadores para uma compilação que ainda não terminou de processar simplesmente não funciona.

Depois, trate a criptografia, a etapa que silenciosamente bloqueia mais usuários de primeira viagem do TestFlight do que qualquer outra. O Apple pergunta, a cada build, se o seu app usa criptografia e como. Há três formas documentadas de responder:

  1. Responda às perguntas exigidas por build, usando Gerenciar ao lado dessa build na seção TestFlight.
  2. Envie a documentação de criptografia do app já aprovada, ou siga Ir para a página de criptografia do app, insira o valor da chave que Apple fornece em Xcode e pare de responder às perguntas para esse app.
  3. Declare no Info.plist do app que ele não usa criptografia, ou que está isento de documentação — o propósito declarado do Apple para essa configuração é justamente eliminar a pergunta a cada submissão.

Um build que fica em análise sem revisor atribuído muitas vezes é um build aguardando conformidade de exportação. Verifique o status de criptografia do build antes de abrir um chamado de suporte.

5. Etapa 3 — Teste interno: até 100 testadores, sem revisão, no ar em minutos

O teste interno é o ciclo mais rápido de toda a cadeia de lançamento e o único sem etapa de revisão.

  1. No App Store Connect, abra o app e selecione a aba TestFlight.
  2. Na barra lateral, em Teste interno, crie ou selecione um grupo.
  3. Adicione até 100 testadores internos — App Store Connect usuários com acesso ao seu conteúdo — e clique em Adicionar.
  4. Atribua a compilação ao grupo. Os testadores recebem um convite por e-mail e o aceitam no app TestFlight, ou com o código de resgate presente no convite.

Vale ler duas vezes o texto do Apple sobre o prazo: testadores internos podem baixar e testar todas as compilações por 90 dias. Observe também o que significa remoção: se você remove uma compilação de um grupo, os testadores que já a usam mantêm o acesso até trocarem de compilação ou pararem de testar. "Removido" não é o mesmo que "revogado".

6. Etapa 4 — Teste externo: até 10.000 testadores e a revisão da primeira compilação

O teste externo é onde o TestFlight encontra a revisão do app. Você pode convidar até 10.000 testadores externos por app, de fora da sua organização. A troca é uma barreira:

  • Quando você adiciona a primeira compilação do seu app a um grupo, essa compilação é enviada à revisão do app para confirmar que segue as Diretrizes de revisão do app.
  • A revisão é obrigatória apenas para a primeira compilação; as compilações seguintes podem não exigir uma revisão completa. É por isso que equipes maduras tratam a primeira compilação externa de uma versão como um marco, e não como uma formalidade.
  • O teste começa quando a compilação é aprovada. Após a aprovação, clique em Notificar testadores na linha da compilação e o status muda para Em teste; os testadores são então notificados para aceitar o convite no app TestFlight.
  • Se uma compilação beta for rejeitada, o caminho documentado da Apple é um recurso à TestFlight App Review — não uma nova conta de desenvolvedor, e não um novo upload carregando o mesmo problema.

A revisão externa é mais leve que a revisão do App Store, mas não é um atalho: as mesmas diretrizes se aplicam, e uma build beta é o lugar errado para testar se um problema de política será tolerado.

7. Etapa 5 — Convites: e-mail, códigos de resgate e links públicos

Os testadores instalam primeiro o app TestFlight gratuito e depois aceitam.

  • Convites por e-mail. Os testadores adicionados recebem um convite por e-mail com um código de resgate, e os convites podem ser reenviados pela lista de testadores para quem nunca aceitou.
  • Links públicos. Um link público permite que qualquer pessoa com a URL entre em um grupo sem convite por e-mail — a forma padrão de abrir um beta para uma comunidade. O Apple observa que definir critérios específicos para convites por link público pode limitar o número de testadores externos que podem testar seu app, e os testadores por link público ainda contam dentro do mesmo teto de 10.000 pessoas.
  • Compilações reduzidas. Os testadores baixam variantes reduzidas para o dispositivo deles, então o que instalam não é byte a byte a compilação universal que você enviou.

Duas regras práticas: nunca deixe um link público em um lugar permanente, porque é um canal de teste e não uma página de download; e planeje o convite junto com a revisão, porque um link que aponta para um build não revisado não serve para nada.

8. Passo 6 — Feedback, métricas e encerrar os testes de propósito

  • Feedback. Testadores no TestFlight 2.3 ou superior no iOS, macOS e visionOS podem enviar feedback de dentro do app TestFlight, ou tirando uma captura de tela no seu app beta; ele chega à seção TestFlight Feedback do App Store Connect. Testadores no tvOS ou em versões anteriores do iOS usam o E-mail de feedback que você informou.
  • Métricas. O App Store Connect relata sessões e falhas por compilação, e é assim que você distingue "os testadores não usaram" de "os testadores usaram e quebrou".
  • Expirar um build. Quando o teste terminar, expire o build para encerrá-lo. O Apple avisa que, se você não expirar um build e depois enviá-lo à App Store, os testadores convidados ainda poderão testá-lo mesmo após ele entrar no ar.

9. O relógio de 90 dias: como a expiração da compilação define seu calendário de envios

Todo build da TestFlight pode ser testado por até 90 dias, após os quais fica indisponível para os testadores. Esse único número decide questões reais de agendamento:

  • Um programa beta que dura mais de 90 dias precisa de um novo upload antes que a build antiga desapareça — planeje o upload, não o lembrete.
  • A expiração se aplica à compilação, não ao testador: o mesmo testador continua testando enquanto houver uma compilação ativa atribuída ao grupo.
  • Expirar uma build de propósito também é como você encerra um beta de forma limpa e corta o canal de teste antes que a versão App Store entre no ar.

Regra prática: trate o dia 75 como prazo. Se a data de lançamento estiver além dele, envie a próxima compilação beta cedo — o modo de falha, testadores abrindo o TestFlight e encontrando uma compilação expirada, é invisível até virar um constrangimento.

10. As regras que importam para um build beta

TestFlight é um ambiente de teste dentro do ecossistema do Apple, e é regido como tal:

  • As diretrizes se aplicam aos betas. A primeira build que você adiciona a um grupo externo é revisada segundo as Diretrizes de revisão do app, e um beta rejeitado é uma rejeição de verdade, com um caminho de recurso de verdade.
  • Teste, não distribuição. Usar o TestFlight para entregar um app pronto a um público grande fora do App Store contraria o propósito da revisão e não é um uso aceitável do programa.
  • Sua conta, seu app, seu build. Builds do TestFlight precisam ser assinados e enviados pela conta de desenvolvedor proprietária do app. Usar a conta, os documentos de identidade ou os ativos de assinatura de outro desenvolvedor para distribuir um build é uma violação que coloca as duas contas em risco — e não é algo que oferecemos ou recomendamos.
  • Proteja os dados dos testadores. Testadores beta são pessoas, não tráfego: as mesmas expectativas de privacidade se aplicam, e e-mails de feedback costumam conter informações pessoais.

11. Onde o KappS se encaixa

O TestFlight fica na frente da cadeia de lançamento, e é por isso que um erro evitável ali custa caro: a conta de desenvolvedor, o registro do app, os ativos de assinatura, o perfil fiscal e bancário e a submissão precisam estar alinhados antes que uma build possa ser testada, muito menos publicada. O KappS ajuda desenvolvedores a preparar e enviar material em conformidade ao longo dessa cadeia — conferindo se a conta, o app e a build descrevem o mesmo publisher real e corrigindo as divergências antes que um revisor, ou um prazo de 90 dias, as encontre.

O que não fazemos é fabricar um canal de teste a partir da conta de outra pessoa, nem usar o TestFlight para contornar a revisão do app. Um programa beta é tão confiável quanto a conta por trás dele, e essa conta precisa ser sua.

Fontes (Apple documentação oficial): App Store Connect Ajuda — visão geral do TestFlight; Fornecer informações de teste; Adicionar testadores internos; Convidar testadores externos; Fornecer informações de conformidade de exportação para builds beta; Interromper o teste de um build; Diretrizes de revisão do app. (developer.apple.com)

Gerencia contas de desenvolvedor em escala? Cuidamos do lado operacional.

Clique para escolher um arquivo · clique com o botão direito → Colar, ou pressione Ctrl/⌘+V para colar uma captura de tela

Você também pode arrastar um arquivo para esta caixa.

Respondemos ao e-mail que você fornecer. Seus dados ficam com KappS.

✔ Enviado

Recebemos sua mensagem e responderemos em até 24 horas.


← Voltar para editar