O que é TestFlight? Tutorial completo para iniciantes, do primeiro convite à instalação
Neste artigo
Informações verificadas em 17 de setembro de 2026. Este artigo se concentra no iPhone e no iPad. As interfaces e as regras da Apple podem mudar; consulte a documentação oficial nos links e as telas que aparecem para você.
Você criou um aplicativo e quer que seus amigos experimentem, mas ainda não está pronto para publicá-lo na App Store. Enviar o código-fonte não resolve; mesmo enviando um pacote de instalação, talvez a outra pessoa não consiga instalá-lo.
É esse o problema que o TestFlight resolve.
Quando alguém diz “TF”, geralmente está abreviando TestFlight. Ele é o serviço de distribuição de testes da Apple: desenvolvedores enviam uma versão de teste, convidam pessoas para instalá-la, coletam feedback e distribuem uma versão melhorada. Os testadores instalam um aplicativo que realmente funciona no dispositivo, não uma captura de tela ou demonstração na web.[1][2]
Para começar, guarde estas 3 ideias:
- O teste interno é voltado a membros com as permissões necessárias no App Store Connect.
- O teste externo é indicado para amigos, clientes e usuários da comunidade, sem precisar dar a eles acesso à área de administração do desenvolvedor.
- Cada compilação pode ser testada por até 90 dias, contados a partir do dia do envio. A aprovação na análise para teste não equivale à publicação na App Store.[1][3]
Se você apenas recebeu um link de outra pessoa, pode ir direto à seção 9, “Como os testadores instalam”. Se quer distribuir seu próprio aplicativo, comece do início.
1. O que são TestFlight, App Store Connect e App Store?
Pense em um aplicativo novo como uma loja que ainda está funcionando em fase experimental: o TestFlight ajuda a convidar pessoas para conhecer a experiência, enquanto a App Store é o canal de abertura oficial ao público. A fase experimental também tem prazos e regras; não é um atalho para escapar da análise.
Os 3 nomes se parecem, mas têm funções diferentes:
Se a tabela for larga, deslize para os lados. Com o teclado, coloque o foco na tabela e use as teclas de seta.
| Nome | Quem usa principalmente | Para que serve |
|---|---|---|
| App Store Connect | Responsáveis pela publicação e membros autorizados da equipe | Gerenciar informações do aplicativo, compilações enviadas, testadores, grupos e análises |
| TestFlight | Responsáveis configuram a distribuição; testadores instalam o aplicativo cliente | Aceitar convites, instalar versões de teste, atualizar e relatar problemas |
| App Store | Aplicativos lançados oficialmente e seus usuários | Encontrar, baixar ou comprar versões oficiais |
Na App Store, você baixa a ferramenta TestFlight e, por meio dela, instala os aplicativos que foi convidado a testar. Um aplicativo aparecer no TestFlight não significa que ele já possa ser encontrado na App Store.[1][3]
A Apple usa esse serviço para conectar as etapas de “distribuir uma versão — convidar para testar — coletar problemas — atualizar a versão”. Hoje, o TestFlight não exige que o desenvolvedor colete o identificador de dispositivo de cada testador nem crie um perfil de provisionamento individual para cada um.[2]
Mas ele não escreve o aplicativo por você, não comprova que todas as funções estão corretas e não transforma automaticamente uma versão de teste em versão oficial. Mesmo a aprovação na análise para teste não garante que o aplicativo esteja livre de falhas ou que não haverá perda de dados. Ao testar um aplicativo desconhecido, não arrisque a única cópia de informações importantes.


2. A história do TestFlight: ele não foi criado pela Apple do zero
Conhecer a história ajuda a entender por que tutoriais antigos mostram nomes, limites de pessoas e procedimentos diferentes.
- Janeiro de 2011: lançamento público como serviço de terceiros. Na época, testar aplicativos de iPhone ainda não publicados costumava envolver identificadores de dispositivos, pacotes de instalação e perfis de provisionamento, além de sincronização pelo iTunes no computador. O TestFlight facilitou bastante a instalação sem fio. Esse marco é a passagem de um teste privado para um serviço público, não a data de constituição da empresa.[H1]
- Março de 2012: anúncio da aquisição pela Burstly. O TestFlight ainda era um produto de terceiros.[H2]
- Fevereiro de 2014: a Apple adquire a Burstly. O TestFlight passou a fazer parte da Apple junto com sua empresa controladora.[H3]
- Outubro de 2014: a Apple anuncia convites de teste por e-mail pelo iTunes Connect. O iTunes Connect foi o antecessor do atual App Store Connect. Na época, era possível convidar até 1.000 pessoas. Atenção: esse é um número histórico.[H4]
- Julho de 2017: o limite de testadores externos aumenta para 10.000.[H5]
- Setembro de 2018: a Apple lança links públicos de convite. Os desenvolvedores passam a poder recrutar testadores compartilhando um link, sem precisar coletar antes cada endereço de e-mail.[H6]
Hoje, ele abrange várias plataformas da Apple, incluindo iPhone, iPad, Mac, Apple Watch, Apple TV e Apple Vision Pro. Usamos o iPhone como exemplo neste artigo, mas isso não significa que ele sirva apenas para testar aplicativos de iPhone, nem que possa distribuir aplicativos Android.[2][3]
3. Conheça 5 termos: beta, versão, compilação, grupo e análise
Versão de teste (Beta): uma versão do aplicativo que ainda está sendo validada e melhorada, e pode apresentar problemas.
Versão (Version): um identificador como 1.0 ou 1.1, que indica uma etapa de lançamento para os usuários.
Compilação (Build): o aplicativo empacotado em uma ocasião específica. Por exemplo, 1.0 (12) significa versão 1.0, número de compilação 12. Depois de corrigir um problema, você pode enviar 1.0 (13): a versão continua igual, mas o conteúdo instalado já é diferente.[7]
Grupo (Group): define quais pessoas recebem quais compilações. Você pode criar os grupos “Equipe” e “Acesso antecipado” e oferecer a eles compilações iguais ou diferentes. Um grupo pode ter várias compilações, e a mesma compilação comum pode ser atribuída a vários grupos.[2][5][6]
Análise para teste (TestFlight App Review): a análise da Apple para testes externos, que não é a mesma análise exigida para o lançamento oficial na App Store.[1][6]
Para se orientar, lembre-se desta relação: o aplicativo é o projeto inteiro; a compilação é um conjunto específico de conteúdo a instalar; o grupo define quem pode testá-lo. O link público de convite pertence ao grupo externo, não fica vinculado para sempre a uma compilação específica.
4. O que responsáveis pela distribuição e testadores precisam preparar?
O que o responsável pela distribuição precisa
- Uma assinatura válida do Apple Developer Program. O preço padrão atual da Apple é de US$ 99 por ano, com possíveis variações regionais. Algumas organizações qualificadas podem solicitar isenção da taxa. O TestFlight faz parte dos serviços da assinatura; não é uma assinatura separada para testadores.[4]
- O registro correto do aplicativo no App Store Connect. O identificador, a assinatura e o conteúdo enviado precisam corresponder. Não é possível simplesmente adicionar o pacote de outro aplicativo.[7]
- Permissões suficientes, mas sem excessos. As funções de titular da conta, administrador, gerente de apps ou desenvolvedor podem enviar compilações; o gerenciamento de testes externos exige a função de titular da conta, administrador ou gerente de apps. Poder enviar não significa poder alterar todas as configurações de teste externo.[6][7]
- Informações para o teste. Inclua a descrição do aplicativo, um e-mail para feedback e o que você quer que as pessoas testem. A análise externa também exige dados de contato e uma forma de a equipe de análise efetivamente fazer login ou acessar as funções.[6][8]
- Dispositivos e tempo para testar. Um envio bem-sucedido não significa que a instalação e as principais funções já tenham sido verificadas.
Não envie sua senha da Apple a amigos. Para que alguém teste o aplicativo, envie um convite, em vez de compartilhar sua conta de administração.
O que um testador comum precisa
Basta ter uma Conta Apple, um dispositivo compatível, o TestFlight e um convite válido. Não é preciso pagar pelo programa de desenvolvedores nem acessar a área de administração.[1][3]
Na data de verificação deste artigo, a ajuda da Apple para testadores indicava iOS 16 e iPadOS 16 ou posterior como requisitos para iPhone e iPad. Porém, um aplicativo específico pode exigir um sistema mais recente, e convites públicos também podem filtrar dispositivos e versões do sistema. Conseguir instalar o TestFlight não significa conseguir instalar todos os aplicativos disponíveis nele.[3][6]
Se você usa uma Conta Apple Gerenciada fornecida pelo trabalho ou pela escola, confira sua elegibilidade com atenção: a ajuda da Apple sobre testes externos afirma expressamente que essas contas não podem ser usadas para testar compilações. Separadamente, a ajuda sobre testes internos informa que contas gerenciadas criadas em domínios reservados não podem ser usadas para testes. Nessas situações, consulte a página de ajuda correspondente e as políticas da organização, em vez de tratar o caso como defeito no link de convite.[5][6]
5. Qual é a diferença entre teste interno e externo?
A principal diferença está na identidade e nas permissões na área de administração, não no grau de proximidade entre vocês nem no fato de o convite ter sido enviado por e-mail.
Se a tabela for larga, deslize para os lados. Com o teclado, coloque o foco na tabela e use as teclas de seta.
| Pergunta | Teste interno | Teste externo |
|---|---|---|
| Para quem é | Usuários do App Store Connect com acesso ao aplicativo e função elegível | Pessoas convidadas para testar, sem necessidade de acesso à administração |
| Limite de pessoas | Até 100 testadores internos | Até 10.000 testadores externos por aplicativo |
| Precisa de permissões de conta na administração | Sim | Não |
| Permite convite por e-mail | Sim | Sim |
| Permite compartilhar um link público de convite | Não | Sim |
| Exige análise para teste externo | Não exige essa análise, mas ainda precisa cumprir os requisitos de processamento do envio e conformidade | O primeiro envio exige análise completa; compilações posteriores da mesma versão podem não precisar de análise completa |
| Uso comum | Você e colaboradores de confiança | Amigos, clientes, testes restritos ou testes públicos |
As funções elegíveis para testadores internos são: titular da conta (Account Holder), administrador (Admin), gerente de apps (App Manager), desenvolvedor (Developer) e marketing (Marketing). A pessoa também precisa ter acesso ao aplicativo.[2][5]
Mesmo ao convidar um amigo em particular por e-mail, normalmente a opção adequada continua sendo o teste externo. Externo não significa público: você pode convidar apenas algumas pessoas, sem ativar um link público.
Não dê permissão de administrador a testadores comuns só para evitar uma etapa de análise. Essa permissão não é um botão para liberar a instalação; ela concede poderes reais de administração.
Outro limite fácil de esquecer: uma conta individual de desenvolvedor pode adicionar no máximo 50 usuários ao App Store Connect. Portanto, o limite de “100 testadores internos” do TestFlight não significa que toda conta individual possa criar 100 membros adicionais na administração.[9]


6. Como adicionar uma compilação? Entenda a diferença entre enviar e adicionar a um grupo de teste
Na verdade, são 2 operações:
- Enviar uma compilação: transferir o aplicativo já empacotado da ferramenta de desenvolvimento ou compilação para a Apple.
- Adicionar uma compilação a um grupo: escolher, entre as compilações enviadas e disponíveis, aquela que será oferecida ao grupo.
A opção “Adicionar compilações (Add Builds)” nos grupos de teste do App Store Connect não gera um aplicativo automaticamente ao arrastar o código-fonte, nem serve para enviar um arquivo local.[5][6][7]


É a primeira distribuição e o aplicativo ainda não existe na administração?
Com a função de titular da conta, administrador ou gerente de apps, acesse Apps (Apps) → “+” → Novo app (New App). Escolha a plataforma e preencha os dados exigidos, como nome do aplicativo, idioma principal, identificador do aplicativo (Bundle ID) e SKU para gerenciamento interno. Depois, defina quais membros terão acesso e crie o registro. O identificador precisa corresponder ao projeto. Se você ainda não sabe qual usar, confirme com a pessoa responsável por empacotar o aplicativo; não escolha ao acaso o identificador de outro aplicativo.
Se não conseguir criar o registro, verifique se o titular da conta aceitou os contratos mais recentes. Criar o registro apenas estabelece um ponto de gerenciamento na administração; não significa que o aplicativo já tenha sido enviado ou publicado.[15]
Caminho básico para enviar pelo Xcode
Se você já tem um projeto iOS, siga esta sequência:
- Confira se o identificador do aplicativo e a equipe de assinatura correspondem ao registro no App Store Connect.
- Defina um número de compilação ainda não utilizado para este envio, por exemplo, passando de
1.0 (12)para1.0 (13). - Selecione um destino para distribuição em dispositivos reais e clique em Product → Archive para criar um arquivo de distribuição, em vez de enviar uma versão para simulador.
- Em Window → Organizer → Archives, selecione o arquivo e clique em Distribute App. Para o TestFlight comum e um futuro lançamento oficial, escolha TestFlight & App Store; no fluxo personalizado, a opção correspondente é a distribuição pelo App Store Connect. Siga as telas para concluir a assinatura e o envio.[16]
- Depois do envio, acesse App Store Connect → Apps (Apps) → seu aplicativo → TestFlight para conferir.
- Aguarde o processamento da Apple. Se surgirem perguntas sobre conformidade de exportação, responda de acordo com a criptografia realmente usada no aplicativo; não selecione sempre “não usa criptografia” só para avançar.
- Quando o processamento terminar e a compilação estiver disponível, adicione-a a um grupo de teste interno ou externo.
Ferramentas como Xcode Cloud e Transporter também podem participar do envio. Usar outra ferramenta não permite pular o processamento, a conformidade, os grupos nem a análise externa da Apple.[7] Os requisitos mínimos de SDK e das ferramentas de envio podem mudar; ao realizar o procedimento, consulte os requisitos atuais de envio da Apple. A versão do SDK usada na compilação não é a mesma coisa que a versão mínima do sistema em que o aplicativo pode ser instalado.[18]
Cuidado com a opção “somente teste interno”
TestFlight Internal Only é uma restrição definida pela forma de envio: essas compilações só podem entrar em grupos internos, não podem ser usadas em testes externos nem no lançamento para usuários finais. Se depois você precisar de teste externo ou lançamento oficial, terá de enviar uma nova compilação pelo método adequado; não basta mudar a compilação original de grupo.[5][6]
Por outro lado, adicionar uma compilação comum primeiro a um grupo interno não a transforma automaticamente em uma compilação “somente teste interno”. Não confunda “oferecer agora aos membros internos” com “este envio está restrito exclusivamente ao uso interno”.
Se você desenvolve o aplicativo no AirBuild
Você pode pedir ao AirBuild ajuda para preparar uma compilação distribuível, assinar, enviar, configurar grupos de teste e fazer convites. Primeiro, deixe claro que quer “enviar para o TestFlight” e diga se é para membros da equipe ou amigos externos. Depois, conecte ou confirme uma equipe de desenvolvedores Apple com as permissões necessárias e confirme as instruções de teste, o e-mail para feedback, o contato para análise e se haverá link público.
As regras da Apple para processamento, análise externa, número de pessoas e validade continuam valendo. Na entrega, diferencie a versão e o número de compilação exatos, o grupo em que já estão disponíveis e se a análise externa ainda está pendente. A ajuda do AirBuild no processo não permite contornar a análise da Apple, nem significa que a validação no simulador cubra todos os comportamentos de dispositivos reais.
Essa é uma explicação de como o AirBuild trabalha, não uma exigência da Apple de usar uma ferramenta específica. Não ter o Xcode local em um Mac também não significa que você precise aprender todos os detalhes de empacotamento para colaborar com outras pessoas na distribuição.
7. Como adicionar testadores internos? Atenção: são 2 convites
Indicado para você e colaboradores que realmente precisam de acesso à administração do aplicativo.
Primeiro: tornar a pessoa um usuário autorizado da administração
A adição de usuários deve ser feita por alguém com a função de titular da conta (Account Holder), administrador (Admin) ou gerente de apps (App Manager):
- Acesse Usuários e acesso (Users and Access) → Pessoas (People).
- Clique em “+” e informe o nome e o e-mail.
- Atribua uma função adequada. Quando a função permitir restringir o acesso por aplicativo, conceda apenas os acessos necessários. Não escolha administrador por padrão. Administradores, usuários de finanças e usuários com acesso a recursos adicionais, como relatórios ou certificados, não podem ter o acesso limitado a um único aplicativo. Confira o alcance antes de escolher as permissões.[9]
- Envie o convite e peça que a pessoa o aceite para ativar o acesso à administração.
Segundo a documentação atual da Apple, esse convite de usuário da administração expira após 3 dias e pode ser reenviado. Ele não é o convite do TestFlight que vem depois, nem tem relação com o prazo de 90 dias da compilação.[9]
Se a pessoa já tem uma função elegível e acesso ao aplicativo, pule essa etapa.
Segundo: adicionar a pessoa e a compilação ao grupo de teste interno
- Acesse Apps → seu aplicativo → TestFlight.
- Clique no “+” ao lado de Teste interno (Internal Testing) e crie um grupo, como “Equipe”.
- Abra o grupo e selecione Convidar testadores (Invite Testers) ou o “+” ao lado da lista de testadores.
- Marque os membros elegíveis da administração e adicione-os ao grupo.
- Clique em Adicionar compilações (Add Builds) e selecione uma compilação processada e disponível para teste.
- Preencha O que testar (What to Test) e adicione.
- Peça que a pessoa instale o TestFlight no dispositivo, aceite o convite de teste e instale o aplicativo.[5]
Ter um nome na lista não basta para considerar o processo concluído. É necessário haver uma compilação disponível, e a pessoa precisa realmente aceitar o convite e instalar.
Não encontrou a pessoa que quer convidar? Primeiro, verifique se ela aceitou o convite para a administração, tem uma função elegível e tem acesso ao aplicativo. Não reenvie o aplicativo de imediato.
Alguns grupos internos permitem ativar a distribuição automática, mas não presuma que compilações de qualquer origem entrarão automaticamente em todos os grupos. A ajuda atual da Apple destaca que compilações criadas pelo Xcode Cloud precisam ser adicionadas manualmente aos grupos no App Store Connect.[5]
8. Como adicionar testadores externos?
Indicado para amigos, clientes, primeiros usuários e testadores da comunidade. Em geral, é a opção mais adequada ao compartilhar o aplicativo com outras pessoas pela primeira vez.
Primeiro, prepare um grupo externo para receber compilações
O procedimento deve ser realizado por alguém com a função de titular da conta, administrador ou gerente de apps:
- Se ainda não houver um grupo interno, crie um primeiro. O tutorial atual da Apple para teste externo lista a criação prévia de um grupo interno como requisito. Isso não significa que seja necessário publicar oficialmente antes, nem que os testadores externos precisem primeiro se tornar membros internos.[6]
- Acesse Apps → seu aplicativo → TestFlight.
- Em Informações de teste (Test Information), preencha a descrição da versão beta, o e-mail para feedback e os dados de contato exigidos para análise. Se houver login, forneça uma forma válida de acesso para a análise e instruções de uso, garantindo que os servidores necessários estejam disponíveis. Não use dados privados de usuários reais como material de demonstração.[6][8][14]
- Clique no “+” ao lado de Teste externo (External Testing) e crie um grupo, como “Acesso antecipado”.
- Entre no grupo, clique em Adicionar compilações e escolha a plataforma, a versão e a compilação específica.
- Preencha O que testar, por exemplo: “Crie um registro, feche e abra novamente o aplicativo e verifique se o registro continua lá”, em vez de apenas “teste à vontade”.
- Marque Notificar testadores automaticamente (Automatically notify testers) se necessário.
- Conforme o estado da página, escolha enviar para análise ou iniciar o teste e aguarde a conclusão de qualquer análise necessária.
- Convide testadores por e-mail, link público ou ambos.[6]
Depois da primeira aprovação, não há mais análise?
Não é bem assim.
A primeira compilação enviada para teste externo exige análise completa. Compilações posteriores da mesma versão podem não precisar de análise completa, mas não há garantia de dispensa permanente. A Apple também exige que atualizações importantes da versão beta sejam enviadas para análise de teste antes da distribuição.[6][14]
O tempo de análise varia. Não prometa que “vai dar para instalar poucos minutos depois do envio” ou que “a aprovação é garantida em 24 horas”.
Se você não marcou a notificação automática ao adicionar a compilação, depois da aprovação ainda será necessário usar Notificar testadores (Notify Testers): em Compilações (Builds), no menu à esquerda do TestFlight, selecione a plataforma e a versão e clique na opção de notificação na barra de status da compilação. Estar aprovada, estar distribuída e estar instalada pela pessoa são 3 coisas diferentes.[6]
Opção 1: convidar por e-mail
Abra o grupo externo e clique no “+” ao lado de Testadores (Testers). Você pode informar o e-mail de novos testadores, selecionar testadores existentes ou importar uma lista.[6]
A pessoa recebe um convite para testar; isso não concede permissões administrativas no App Store Connect.
Opção 2: criar e compartilhar um link público
Abra a página de testadores do grupo externo e selecione Criar link público (Create Public Link):
- Escolha Aberto a todos (Open to Anyone) ou Filtrar por critérios (Filter by Criteria).
- Se necessário, defina o limite de recrutamento pelo link entre 1 e 10.000 pessoas, sempre respeitando o limite total de testadores externos do aplicativo.
- Se optar por filtrar, configure as condições de dispositivo e versão do sistema.
- Confirme, copie o link realmente gerado e envie a amigos ou compartilhe em comunidades, e-mails ou sites.[6]
O link geralmente começa com https://testflight.apple.com/join/…. Copie o link real gerado pela Apple: não invente o código final e não use o endereço da página administrativa do App Store Connect como link de instalação.
Um código QR também pode conter esse mesmo link, mas não é uma forma diferente de distribuição e não contorna a análise.
Antes de compartilhar o link, confira 4 pontos
- O grupo externo de destino contém a compilação que você quer compartilhar.
- As análises necessárias foram aprovadas e a distribuição já começou.
- A compilação não expirou e é compatível com o dispositivo de destino.
- O link está ativado, ainda há vagas e os filtros não excluem os usuários desejados.[3][6]
Conseguir abrir o link não significa que seja possível instalar a nova versão. Uma compilação antiga continuar disponível também não significa que a mais recente já tenha sido distribuída para esse grupo.
Links públicos podem ser repassados; não são uma lista confidencial. Se quiser convidar apenas algumas pessoas específicas, prefira convites por e-mail e configure o controle de acesso nas permissões de conta do próprio aplicativo.
Por padrão, o nome e o e-mail de quem entra por um link público não aparecem na lista de testadores do TestFlight, mas informações como data de instalação, sessões de uso e falhas continuam visíveis. A pessoa também pode fornecer o e-mail ao enviar feedback voluntariamente. Isso não significa anonimato completo perante a Apple ou o sistema de login do próprio aplicativo.[3][6]
Ao atualizar a compilação, normalmente é possível reutilizar o link do mesmo grupo externo, sem recrutar todos novamente a cada vez. Em Gerenciar (Manage), você também pode alterar os filtros, o limite de pessoas ou desativar o link. Desativar o link interrompe a entrada de novas pessoas; não remove instalações existentes, não exclui contas do aplicativo nem apaga dados dos servidores.[6]
9. Como os testadores instalam, atualizam, enviam feedback e saem do teste?
Depois de receber o convite, faça o seguinte no iPhone ou iPad usado para o teste:
- Instale o TestFlight oficial da Apple pela App Store.
- Abra o e-mail de convite ou o link público.
- Siga as instruções para entrar no TestFlight, selecione Aceitar (Accept) e depois Instalar (Install).
- Leia o que deve ser testado e comece a usar.
- Quando houver uma nova compilação, atualize pelo TestFlight ou ative as atualizações automáticas. Quem já participa pode ver diretamente Atualizar (Update) ou Abrir (Open).[3]
Para um teste externo comum, você não precisa da senha do desenvolvedor, de uma função na administração nem de criar antes uma conta específica de sandbox.
Se a versão oficial já estiver no celular, serão instaladas 2 cópias?
Normalmente, não. A versão de teste do TestFlight substitui a versão da App Store do mesmo aplicativo no dispositivo.[3]
Por isso, faça backup ou exporte os dados importantes antes. A versão de teste pode alterar o formato dos dados, e uma versão antiga talvez não consiga ler os dados gravados pela nova. Não considere a troca de versões uma operação com garantia de não perder dados.
Se o desenvolvedor ainda oferecer outras compilações válidas, você poderá selecioná-las em Compilações anteriores (Previous Builds). Essa opção não é um repositório permanente para baixar todas as versões históricas.[3]
Como enviar um feedback fácil de entender?
Abra a página do aplicativo no TestFlight e toque em Enviar feedback sobre o beta (Send Beta Feedback). Em sistemas compatíveis, também é possível tirar uma captura de tela no aplicativo em teste e enviá-la como feedback. Após uma falha, pode aparecer um convite para compartilhar informações adicionais.[3]
Em vez de “não funciona”, uma descrição mais útil seria:
Uso [modelo do dispositivo] com [versão do sistema], e o aplicativo está na [versão e número de compilação]. Abri as configurações, troquei o idioma e voltei à tela inicial. Esperava que os textos também mudassem, mas a tela inicial continuou no idioma anterior. Repeti 2 vezes e o problema ocorreu nas 2. Segue a captura de tela.
Não inclua senhas, informações de pagamento ou dados privados de outras pessoas nas capturas. O feedback enviado pelo TestFlight também é compartilhado com a Apple; um canal de feedback criado pelo próprio aplicativo é uma via separada.[3]
E se eu não quiser mais testar?
Abra a página de informações do aplicativo no TestFlight e selecione Parar de testar (Stop Testing). Se já houver uma versão oficial, você poderá baixá-la ou comprá-la na App Store. Um aplicativo que só existe em teste e ainda não foi lançado oficialmente pode não ter uma versão oficial para a qual voltar.[3]
Parar de testar não exclui a conta que você criou no aplicativo. A conta e os dados na nuvem devem ser tratados conforme as regras do próprio aplicativo.
10. Os pagamentos no TestFlight cobram dinheiro de verdade?
Em aplicativos instalados pelo TestFlight, as transações de teste feitas pelo sistema de compras dentro do aplicativo da Apple usam o sandbox e não geram cobranças reais. Isso também inclui testes de assinaturas com StoreKit.[3][10]
Pense no “sandbox” como um ambiente de ensaio do fluxo de compra: o aplicativo pode consultar informações de produtos, iniciar compras de teste, restaurar compras e processar notificações de transações, mas essas operações não geram receita real de vendas.[10]
O ponto que mais causa confusão é o alcance desse sandbox.
Não haver cobrança não significa que a versão oficial será gratuita para sempre
A Apple deixa claro que as compras dentro do aplicativo realizadas durante o teste não são transferidas como compras para a versão oficial da App Store. Não prometa aos testadores que “basta comprar agora para ter uma assinatura permanente depois do lançamento”.[3]
Se o desenvolvedor decidir conceder benefícios na conta do aplicativo por conta própria, essa será uma decisão do negócio, não uma regra automática do TestFlight.
O tempo das assinaturas de teste também não é o tempo real de cobrança
Para assinaturas com renovação automática, a orientação atual da Apple aos testadores do TestFlight é: independentemente do período original da assinatura, durante o teste a renovação acontece diariamente, com no máximo 6 renovações em 1 semana. Os controles avançados com contas de sandbox também permitem ajustar a velocidade de renovação. Não aplique diretamente ao teste comum do TestFlight parâmetros como “5 minutos” ou “12 vezes” encontrados em outros cenários de sandbox.[3][10]
Essas regras aceleradas servem para testar renovação e expiração; não representam o ciclo de cobrança dos usuários da versão oficial.
Só o canal de compras da Apple entra automaticamente no sandbox, não o aplicativo inteiro
Um aplicativo do TestFlight ainda pode:
- Conectar-se a servidores de produção e alterar registros reais;
- Enviar e-mails ou mensagens reais;
- Excluir contas ou dados reais;
- Abrir uma página que cobra dinheiro de verdade;
- Usar métodos de pagamento que não sejam compras dentro do aplicativo da Apple.
Pagamentos na web, Apple Pay e compras dentro do aplicativo com StoreKit são coisas diferentes. O fato de o aplicativo vir do TestFlight não significa que um pagamento na web ou uma operação real não custará dinheiro. O desenvolvedor precisa configurar separadamente os dados de teste, os servidores e os demais ambientes de pagamento.[10]; explicação dos limites entre os sistemas do aplicativo


Todo testador precisa criar uma conta de sandbox?
Não. Para a instalação e os testes comuns de compra no TestFlight, é possível usar a Conta Apple do dia a dia.[10]
Somente quando forem necessários controles como limpar o histórico de compras ou ajustar configurações avançadas de teste é que o desenvolvedor precisa configurar uma Sandbox Apple Account conforme a documentação da Apple. As etapas avançadas podem envolver sair de “Mídia e Compras”, afetando o acesso ao conteúdo comprado no dispositivo. Isso não é uma exigência para testadores comuns antes da instalação, e muito menos um motivo para pedir que saiam do iCloud do dispositivo inteiro sem necessidade. A Apple sugere considerar o uso de um dispositivo dedicado a testes.[10]
Se a compra aparecer como concluída, mas o aplicativo não liberar a função, informe o desenvolvedor. A configuração dos produtos, a verificação das transações, a concessão de benefícios, a restauração de compras e o processamento das renovações precisam ser implementados corretamente. Uma compra bem-sucedida no sandbox não comprova que o pagamento em produção, o recebimento da receita e toda a lógica de assinaturas estejam corretos.
11. Quais são os limites do TestFlight?
Se a tabela for larga, deslize para os lados. Com o teclado, coloque o foco na tabela e use as teclas de seta.
| Regra | O que significa para você | Fonte |
|---|---|---|
| Até 100 testadores internos | Precisam de função elegível na administração e acesso ao aplicativo; também se aplicam as regras de quantidade de usuários da conta | [2][5][9] |
| Até 10.000 testadores externos por aplicativo | Criar mais grupos não multiplica o total de vagas do aplicativo | [6] |
| Limite do link público configurável de 1 a 10.000 pessoas | É possível recrutar menos pessoas, mas sem ultrapassar o limite total do aplicativo | [6] |
| Até 90 dias por compilação | Contados a partir do envio, não da aprovação, do convite ou da instalação | [3] |
| Até 30 dispositivos por testador | As condições do dispositivo, do aplicativo e do convite ainda precisam ser compatíveis | [2][3] |
| Compartilhamento de até 100 compilações | É possível testar várias compilações em paralelo; isso não significa enviar 100 para análise ao mesmo tempo | [2] |
| Até 6 compilações enviadas para TestFlight App Review a cada 24 horas | É um limite de submissões para análise de teste, não um limite de 6 envios de arquivo por dia | [6] |
| Apenas 1 compilação por versão em análise para teste ao mesmo tempo | Depois da aprovação, é possível submeter outras compilações da mesma versão | [6] |
| Envios somente para teste interno | A mesma compilação restrita não pode ser usada para teste externo nem lançamento oficial | [5][6] |
Reenviar o convite depois dos 90 dias resolve?
Não. O prazo pertence à compilação, não ao testador. Quem entra depois não ganha um novo período completo de 90 dias. Após a expiração, a versão de teste deixa de abrir, e o desenvolvedor precisa disponibilizar uma nova compilação válida.[3]
Para evitar interrupções no teste, envie e distribua uma nova compilação antes de a anterior expirar e lembre os participantes de atualizar. A nova compilação tem seu próprio prazo; ela não prolonga a validade da antiga.
Posso usar o TestFlight continuamente para vender aplicativos ou vagas?
Não o trate como um canal de vendas para contornar o lançamento oficial.
A diretriz 2.2 de análise da Apple exige que aplicativos de teste sigam as regras de análise e tenham como objetivo o lançamento público. Ela também proíbe trocar a distribuição de testes pelo TestFlight por qualquer forma de contrapartida, inclusive como recompensa de financiamento coletivo. Em termos simples, “pague para entrar no grupo e receber a versão de teste” não é uma forma normal de distribuição pelo TestFlight.[14]
12. Problemas comuns: por que a outra pessoa não consegue instalar?
Se a tabela for larga, deslize para os lados. Com o teclado, coloque o foco na tabela e use as teclas de seta.
| Situação | O que conferir primeiro |
|---|---|
| O envio terminou, mas a compilação não aparece na administração | Se a Apple ainda está processando, se houve e-mail de falha no processamento e se você está no aplicativo e na versão corretos |
| Aparece binário inválido (Invalid Binary) | Consulte o erro específico de envio informado pela Apple, corrija e envie uma nova compilação |
| Aparece falta de informações de conformidade (Missing Compliance) | Complete os dados de conformidade de exportação conforme o aplicativo; não basta continuar aguardando análise |
| Uma pessoa não aparece na lista de convites internos | Se ela aceitou o convite para a administração, tem função elegível e acesso ao aplicativo |
| Não é possível adicionar a compilação ao grupo externo | Se o processamento terminou, a conformidade está completa e o envio não foi marcado por engano como somente teste interno |
| Está aguardando análise ou em análise de teste | O teste externo ainda não recebeu a aprovação necessária; estar disponível internamente não substitui essa etapa |
| A análise foi aprovada, mas ninguém recebeu a atualização | Se a compilação foi adicionada ao grupo de destino e se ainda é preciso notificar os testadores manualmente |
| O link não aceita mais testadores | Se foi desativado, se o limite do link ou do aplicativo foi atingido e se há uma compilação disponível |
| O link abre, mas não há versão para instalar | Confira sistema, dispositivo, filtros, validade e a compilação realmente presente no grupo |
| Os convites foram enviados, mas não há dados de uso | Diferencie convite enviado, aceito e instalação concluída. As métricas de teste podem levar até 24 horas para aparecer após a instalação; não conclua imediatamente que a pessoa não conseguiu instalar [17] |
| A pessoa não vê a nova função | Confira a versão instalada e o número da compilação entre parênteses, não apenas o nome do aplicativo |
| Depois de aceitar o convite, o aplicativo ainda pede login | A permissão para instalar não equivale a uma conta no aplicativo; o desenvolvedor precisa fornecer instruções de cadastro ou login separadamente |
| Depois de algum tempo, o aplicativo para de abrir | Primeiro, veja os dias restantes e o estado de expiração no TestFlight; depois, fale com o desenvolvedor |
| A compra no sandbox funcionou, mas não há assinatura na versão oficial | Compras de teste não viram automaticamente benefícios de compras reais; isso não comprova a perda do registro de um pagamento real |
Esses são caminhos de investigação, não diagnósticos definitivos a partir de uma única mensagem de erro.[3][5][6][11]
Atenção especial: o status verde “Em teste (Testing)” na administração também pode significar apenas que um grupo interno está usando a compilação. Para saber se usuários externos conseguem instalar, confira o grupo externo de destino, a compilação específica e sua disponibilidade nesse grupo.[11]
“Pronto para envio (Ready to Submit)”, “Aguardando análise (Waiting for Review)”, “Em análise beta (In Beta Review)” e “Pronto para testar (Ready to Test)” também são etapas diferentes. Em especial, o estado pronto para testar ainda pode exigir adicionar testadores ou concluir a notificação manual.[11]
13. Onde o desenvolvedor vê o feedback e como distribui novas versões?
Acesse Apps → seu aplicativo → TestFlight → Feedback (Feedback) para ver Capturas de tela (Screenshots) e Falhas (Crashes) e filtrar por versão, dispositivo e outros critérios. As configurações do grupo também influenciam a possibilidade de enviar feedback de dentro do aplicativo.[12]
Primeiro, resolva os problemas que podem ser reproduzidos. Depois, inicie a próxima rodada:
- Corrija os problemas, empacote com um novo número de compilação e envie.
- Aguarde o processamento e cumpra os requisitos de conformidade necessários.
- Adicione a nova compilação ao grupo de destino e conclua a análise externa necessária.
- Atualize o que deve ser testado e notifique os testadores conforme as configurações.
- Peça às pessoas do grupo de destino que confirmem a versão e a compilação realmente instaladas e tentem reproduzir o problema original.
O registro de envio, a lista do grupo e a aprovação na análise são importantes, mas, no fim, ainda é preciso confirmar: as pessoas certas realmente instalaram a compilação certa.
Uma captura de tela do teste interno não comprova que todos os usuários externos também conseguem instalar. Da mesma forma, funcionar no simulador não substitui o resultado da instalação em um dispositivo.
14. Como encerrar o teste ou publicar oficialmente?
Primeiro, veja exatamente o que você quer encerrar ou fazer:
- Parar de recrutar novos usuários: desative o link público de convite do grupo externo.
- Ajustar quem recebe quais compilações: gerencie testadores, grupos e atribuições de compilações.
- Interromper novas instalações de uma compilação: abra os detalhes da compilação e selecione Expirar compilação (Expire Build). Não interprete isso como remover remotamente o aplicativo de todos os celulares ou apagar contas na nuvem.[6][13]
- Lançar oficialmente: prepare as informações necessárias para a versão oficial na App Store, selecione uma compilação elegível e envie separadamente para a análise de lançamento.[1][2]
Uma compilação elegível já enviada pelo fluxo comum do TestFlight pode ser selecionada para a análise oficial. Não é necessariamente preciso empacotar de novo apenas porque chegou a hora de publicar. Porém, se o código mudou, é preciso enviar uma nova compilação, e envios “somente teste interno” não podem ser usados no lançamento oficial.[2][5]
A aprovação na análise do TestFlight não publica automaticamente o aplicativo na App Store. No sentido inverso, o lançamento oficial também não encerra automaticamente uma versão de teste ainda válida. O fim dos testes e a migração dos usuários precisam ser planejados separadamente.[1]
15. Mensagem pronta para enviar aos primeiros testadores
Queria pedir sua ajuda para testar uma versão inicial do [nome do aplicativo].
Primeiro, instale o TestFlight oficial da Apple pela App Store. Depois, abra [link real do convite] no iPhone, aceite o convite e instale.
Nesta rodada, gostaria que você focasse em: [1 ou 2 tarefas específicas]. Dispositivos e sistemas compatíveis: [requisitos reais].
Esta é uma versão de teste e pode apresentar problemas. Faça backup dos dados importantes antes. Se encontrar algo estranho, use “Enviar feedback sobre o beta” no TestFlight para contar o que fez, o que esperava e o que realmente aconteceu. Se possível, inclua uma captura de tela e o número da versão.
Substitua os trechos entre colchetes por informações reais. Envie a mensagem apenas depois de confirmar que a compilação do grupo externo de destino pode ser instalada. Não compartilhe em massa um link que ainda aguarda análise dizendo que já está disponível.
Antes de distribuir, confira estes 10 itens
- Escolhi teste interno ou externo de acordo com as permissões da conta, sem dar permissões excessivas por conveniência.
- A compilação de destino terminou de ser processada e não tem impedimentos de distribuição pendentes.
- O grupo de destino realmente contém essa compilação.
- A análise externa necessária foi aprovada e as notificações necessárias foram enviadas.
- Conferi o método de convite: os e-mails foram enviados às pessoas certas; se houver link público, ele está ativado e tem vagas. Os dispositivos e sistemas de destino cumprem os requisitos.
- A descrição do teste, o e-mail para feedback e as instruções sobre o que testar são verdadeiros e úteis.
- Os testadores sabem que é uma versão de teste e que ela pode substituir a versão oficial.
- Diferenciei compras em sandbox de servidores reais, pagamentos na web e operações reais.
- Conferi a data de expiração da compilação e planejei as próximas atualizações.
- Alguém do público de destino confirmou que realmente instalou a compilação pretendida, e não apenas abriu a página do convite.
Ao distribuir um aplicativo pela primeira vez, o verdadeiro ponto de chegada não é “envio concluído”. É quando as pessoas certas instalam a versão certa, sabem o que testar e sabem como relatar os problemas a você.
Fontes e leituras adicionais
As fontes abaixo foram verificadas em 17 de setembro de 2026. Os marcos históricos usam reportagens da época ou anúncios da Apple daquele ano; as regras atuais se baseiam principalmente na ajuda oficial da Apple. A interface pode variar conforme o idioma e a versão.
[1] Apple: visão geral do TestFlight. https://developer.apple.com/help/app-store-connect/test-a-beta-version/testflight-overview/ ↑
[2] Apple: apresentação do TestFlight. https://developer.apple.com/testflight/ ↑
[3] Apple: ajuda para testadores do TestFlight, incluindo instalação, prazo de 90 dias, assinaturas, privacidade e saída do teste. https://testflight.apple.com/ ↑
[4] Apple: inscrição e taxas do Developer Program. https://developer.apple.com/programs/enroll/ ↑
[5] Apple: adicionar testadores internos. https://developer.apple.com/help/app-store-connect/test-a-beta-version/add-internal-testers/ ↑
[6] Apple: convidar testadores externos. https://developer.apple.com/help/app-store-connect/test-a-beta-version/invite-external-testers/ ↑
[7] Apple: enviar compilações. https://developer.apple.com/help/app-store-connect/manage-builds/upload-builds/ ↑
[8] Apple: fornecer informações de teste. https://developer.apple.com/help/app-store-connect/test-a-beta-version/provide-test-information/ ↑
[9] Apple: adicionar e editar usuários. https://developer.apple.com/help/app-store-connect/manage-your-team/add-and-edit-users/ ↑
[10] Apple: testar compras dentro do aplicativo com sandbox. https://developer.apple.com/documentation/storekit/testing-in-app-purchases-with-sandbox ↑
[11] Apple: estados das compilações de aplicativos. https://developer.apple.com/help/app-store-connect/reference/app-uploads/app-build-statuses/ ↑
[12] Apple: visualizar o feedback dos testadores. https://developer.apple.com/help/app-store-connect/test-a-beta-version/view-tester-feedback/ ↑
[13] Apple: interromper o teste de uma compilação. https://developer.apple.com/help/app-store-connect/test-a-beta-version/stop-testing-a-build/ ↑
[14] Apple: diretrizes de análise de aplicativos, especialmente a seção 2.2, testes beta. https://developer.apple.com/app-store/review/guidelines/#beta-testing ↑
[15] Apple: adicionar um novo aplicativo. https://developer.apple.com/help/app-store-connect/create-an-app-record/add-a-new-app/ ↑
[16] Apple: distribuir seu aplicativo para testes beta e lançamentos. https://developer.apple.com/documentation/xcode/distributing-your-app-for-beta-testing-and-releases ↑
[17] Apple: visualizar e gerenciar informações dos testadores. https://developer.apple.com/help/app-store-connect/test-a-beta-version/view-and-manage-tester-information/ ↑
[18] Apple: próximos requisitos, incluindo os requisitos atuais de SDK e envio. https://developer.apple.com/news/upcoming-requirements/ ↑
Fontes históricas:
[H1] Macworld, 2011-01-21, TestFlight facilita muito o teste de aplicativos iOS. https://www.macworld.com/article/210218/testflight.html ↑
[H2] MacStories, 2012-03-05, TestFlight é adquirido pela Burstly. https://www.macstories.net/news/testflight-acquired-by-burstly-launches-testflight-live/ ↑
[H3] The Verge, 2014-02-21, Apple compra a empresa por trás da plataforma de testes de iOS TestFlight. https://www.theverge.com/apps/2014/2/21/5434060/apple-buys-maker-of-the-ios-testing-platform-testflight ↑
[H4] Apple, 2014-10-23, testes beta com TestFlight para todos. https://developer.apple.com/news/?id=10232014a ↑
[H5] Apple, 2017-07-31, ampliação dos limites de testadores no TestFlight. https://developer.apple.com/news/?id=07312017a ↑
[H6] Apple, 2018-09-26, convide testadores com um link público. https://developer.apple.com/news/?id=09262018a ↑