Este artigo explica como os relatórios de pré-lançamento funcionam. Se você já gerou um relatório desse tipo e quer saber como interpretar os resultados, acesse Como funciona o relatório de pré-lançamento.
Os relatórios de pré-lançamento são gerados automaticamente quando você faz upload de um pacote de app ou APK, sujeito à capacidade do nosso laboratório de dispositivos. Quando os relatórios de pré-lançamento são gerados, testamos cada artefato quando ele é enviado e salvo na produção para identificar problemas proativamente antes que o app chegue aos usuários. Isso inclui os seguintes testes:
- Problemas de estabilidade
- Problemas de compatibilidade com o Android
- Problemas de desempenho
- Problemas de acessibilidade
Como o relatório de pré-lançamento funciona
Após você fazer upload de um pacote de app ou salvar uma versão na faixa de produção, a instalação é feita em um conjunto de dispositivos Android no nosso laboratório de teste. Em seguida, o app é inicializado e rastreado automaticamente por vários minutos. O rastreador realiza ações básicas, como digitar, tocar e deslizar. Você também pode fornecer testes personalizados ou credenciais de conta para o rastreador usar.
Após a conclusão do rastreamento, os resultados são compilados no relatório de pré-lançamento. Também desinstalamos o app de todos os dispositivos do laboratório de testes.
Avaliar a adequação do app para um relatório de pré-lançamento
O relatório de pré-lançamento funciona desde que seja possível instalar e "rastrear" o app. No entanto, alguns apps podem precisar de pequenas modificações no código. Alguns exemplos disso são os apps que exigem validação de país ou de instalação. Para saber mais, acesse as Perguntas frequentes.
Observação: os dispositivos de teste não podem analisar apps que não tenham uma atividade de inicialização principal, incluindo telas de início, widgets, teclados e mostradores do relógio.
Recolher tudo Abrir tudo
Gerar um relatório de pré-lançamento
Geramos relatórios de pré-lançamento automaticamente com base na capacidade geral do nosso laboratório de dispositivos. Isso acontece no upload do pacote de app ou ao salvar uma versão de produção.
Personalizar os testes
Personalize seus testes e deixe o relatório de pré-lançamento mais abrangente e relevante para o app.
Se o app tiver uma tela de login e você quiser que o rastreador teste o processo de login ou o conteúdo por trás dela, vai ser necessário enviar as credenciais da conta.
Observação: isso não será necessário se o app tiver a opção "Fazer login com o Google", porque isso permite que o rastreador faça login automaticamente, ou se você já as informou na página Conteúdo do app.
Confira algumas informações importantes para testar credenciais:
- As credenciais enviadas são usadas somente para fins de teste.
- Fazemos o melhor para manter as credenciais de teste seguras, mas recomendamos que você não adicione uma credencial oficial ao relatório de pré-lançamento. Em vez disso, crie um nome de usuário e uma senha para a conta de teste.
- As credenciais só podem ser inseridas automaticamente em apps para Android que usam widgets padrão desse sistema operacional. As credenciais não podem ser usadas em apps que usam o OpenGL para renderizar controles nem apps personalizados que usam um WebView para um fluxo de autenticação baseado na Web.
- O Google fará login automaticamente se o app tiver a opção de "Fazer login com o Google".
- Abra o Play Console.
- Selecione um app.
- No menu à esquerda, acesse a página Configurações do relatório de pré-lançamento (Testar e lançar
> Teste > Relatório de pré-lançamento > Configurações). Na seção "Credenciais da conta de teste", selecione "Enviar credenciais". Na seção "Credenciais da conta de teste", selecione Enviar credenciais.
- Digite o seguinte:
- Nome de usuário: o nome de usuário associado à conta de teste.
- Senha: insira a senha associada à conta de teste.
- Clique em Salvar. Essas credenciais vão ser usadas para todos os testes futuros, a menos que sejam editadas.
- Abra o Play Console.
- Selecione um app.
- No menu à esquerda, acesse a página Configurações do relatório de pré-lançamento (Testar e lançar
> Teste > Relatório de pré-lançamento > Configurações).
- Faça as mudanças:
- Para editar credenciais: na seção "Credenciais da conta de teste", insira suas credenciais atualizadas nos campos de nome de usuário e senha.
- Para remover credenciais: na seção "Credenciais da conta de teste", selecione Não enviar credenciais.
- Observação: se você remover as credenciais de teste do app, será necessário adicionar novas antes que os testes futuros possam fazer login no app.
- Clique em Salvar. Essas credenciais vão ser usadas para todos os testes futuros, a menos que sejam editadas.
Se você quiser controlar as etapas que o rastreador executa ao testar o app, insira um script Robo ou loop de jogo.
É possível controlar as etapas que o rastreador executa ao testar o app inserindo um script Robo para realizar ações específicas, como testar uma jornada comum do usuário ou uma nova seção do app.
Quando você faz um teste com um script anexado, o rastreador primeiro executa suas ações programadas para depois explorar normalmente o app.
Para fazer o upload de um script para o relatório de pré-lançamento:
- Grave o script usando a ferramenta Firebase no Android Studio (Android Studio > Tools > Firebase > Test Lab > Record Robo Script). Para conferir detalhes, acesse a Central de Ajuda do Firebase.
- Observação: não é necessário ter uma conta do Firebase para criar um script Robo.
- Quando o script estiver pronto, abra o Play Console.
- Selecione um app.
- No menu à esquerda, acesse a página Configurações do relatório de pré-lançamento (Testar e lançar
> Teste > Relatório de pré-lançamento > Configurações). Na seção "Controle a forma como o relatório de pré-lançamento explora seu app", faça upload do script. É possível arrastar e soltar o arquivo ou selecionar Fazer upload.
- Clique em Salvar.
Se você estiver testando um jogo ou app que usa o OpenGL, precisará inserir um loop de jogo para gerar um bom relatório de pré-lançamento. Um loop de jogo define as ações que você quer que o rastreador realize. É possível testar mais de um loop de jogo no mesmo app.
Para usar loops de jogo no relatório de pré-lançamento, faça o seguinte:
- Modifique o jogo para fazer o seguinte:
- Iniciar o loop.
- Executar o loop.
- Fechar o loop (opcional). Essas modificações são feitas no ambiente para desenvolvedores. Para ver detalhes, acesse a Central de Ajuda do Firebase.
- Observação: não é necessário ter uma conta do Firebase para usar loops de jogo no relatório de pré-lançamento.
- Faça upload da versão do jogo. O rastreador vai detectar e executar automaticamente o loop de jogo.
É possível adicionar até três links diretos ao relatório de pré-lançamento para testar pontos de entrada adicionais do app.
O rastreador funciona normalmente por vários minutos, depois fecha o app e visita cada link direto por vez, rastreando por mais 30 segundos. Os problemas encontrados durante esses rastreamentos adicionais são incluídos no relatório normalmente.
Para saber como criar e testar links diretos do app, visite o site para desenvolvedores Android.
Se você quiser analisar os resultados do teste de idiomas específicos, defina as preferências de idioma na página Configurações do relatório de pré-lançamento. É possível selecionar até cinco idiomas.
Dica: o relatório de pré-lançamento é gerado automaticamente após o upload de um pacote de app de teste. Por isso, você só pode adicionar as preferências de idioma depois da conclusão do primeiro teste.
- Abra o Play Console.
- Selecione um app.
- No menu à esquerda, acesse a página Configurações do relatório de pré-lançamento (Testar e lançar
> Teste > Relatório de pré-lançamento > Configurações).
- Em "Teste seu app em idiomas específicos", selecione + Adicionar idioma.
- Selecione até cinco idiomas. Você verá somente os resultados desses idiomas em testes futuros.
- Observação: se você não selecionar idiomas, aqueles em que o app tiver mais instalações serão escolhidos automaticamente.
- Clique em Salvar.
Ver o relatório de pré-lançamento
Quando o relatório estiver disponível, será possível ver um resumo do teste, que inclui o número de erros, avisos e problemas menores encontrados durante o processo, categorizados por tipo de problema. Também será exibida uma recomendação de lançamento com base nos resultados do teste do app.
Para ver um resumo do relatório de pré-lançamento, faça o seguinte:
- Abra o Play Console.
- Selecione um app.
- Selecione Testar e lançar
> Teste > Relatório de pré-lançamento > Visão geral.
- Consulte cada seção:
- Estabilidade
- Desempenho
- Acessibilidade
- Segurança e confiabilidade
- Se alguma seção tiver um problema, selecione Mostrar resumo para expandir as informações.
- Selecione Acessar detalhes para mostrar informações mais detalhadas sobre os problemas.
- Para conferir relatórios de pré-lançamento anteriores, role até a tabela na seção "Detalhes do relatório", na parte inferior da página.
Observação: a mensagem "Teste em andamento" significa que a análise mais recente ainda não terminou. Caso não tenha sido possível executar o último teste, você verá a mensagem "Falha no teste". Para fazer um novo teste, publique outro pacote de apps.
Para ver resultados detalhados do relatório de pré-lançamento, faça o seguinte:
- Abra o Play Console.
- Selecione um app.
- No menu à esquerda, acesse a página Detalhes do relatório de pré-lançamento ( Testar e lançar
> Teste > Relatório de pré-lançamento > Detalhes).
- Consulte as guias Estabilidade, Desempenho, Acessibilidade e Capturas de tela. Em cada página, você pode conferir detalhes completos dos resultados do teste mais recente, incluindo stack traces, capturas de tela e gráficos.
Observação: a mensagem "Teste em andamento" significa que a análise mais recente ainda não terminou. Caso não tenha sido possível executar o último teste, você verá a mensagem "Falha no teste". Para fazer um novo teste, publique outro pacote de apps.
Recolher tudo Expandir tudo
Em geral, você receberá os resultados do teste em até uma hora após o upload do pacote de apps. Às vezes, isso pode levar algumas horas. Se o relatório não for concluído após dois dias, tente fazer o upload do artefato novamente. Isso acionará um novo relatório.
Você ainda poderá receber um relatório de pré-lançamento se pequenas modificações no código não forem um problema.
Os dispositivos de teste estão nos Estados Unidos. Se o app usar geolocalização ou tiver restrições de conteúdo com base no país, os dispositivos de teste só vão mostrar o que estiver disponível para o local deles.
Se for preciso testar o app em uma geolocalização fora da região dos dispositivos de teste, publique um pacote de app que remova os requisitos de local para fins de teste. Há duas maneiras de detectar se os relatórios de pré-lançamento são gerados no Test Lab:
A plataforma de testes não é compatível com apps que verificam se um dispositivo tem controle privilegiado (acesso root) no Android.
Para saber mais detalhes sobre como reduzir a receita de anúncios fraudulentos com testes de app automatizados, confira o site do Google Developers.
Os dispositivos de teste não podem realizar compras durante os testes. Caso o app ofereça assinaturas ou produtos no aplicativo para acessar algumas partes do app, os cenários de teste poderão ser limitados.
Sim. Os testes do relatório de pré-lançamento serão executados independentemente disso.
No entanto, se o código for ofuscado ou tiver os símbolos de depuração removidos, todas as falhas ou ANRs encontrados durante o teste terão stack traces que também serão ofuscados ou estarão sem esses símbolos. Para facilitar a depuração dos stack traces, é recomendável fazer o upload de um arquivo de desofuscação ou simbolização.
Saiba mais sobre o upload de arquivos de desofuscação ou simbolização.
Não. A plataforma de teste não é compatível com o pré-carregamento de dispositivos com mídia ou apps pré-instalados.
No entanto, se você quiser fazer testes em um app com dados pré-carregados, publique uma versão de teste com os arquivos de mídia incorporados no pacote de apps.
Se o app estiver em teste aberto ou tiver sido publicado para produção, as análises do relatório de pré-lançamento vão usar um ID que simula o licenciamento para o app.
Se o app não estiver em um teste aberto e não tiver um pacote de app ativo publicado para produção, ele vai ser reprovado na verificação de licenciamento. Você ainda vai receber resultados do relatório de pré-lançamento, mas o app não vai estar licenciado. Para fazer testes nesses apps, publique uma versão fechada com a opção de serviços de licenciamento desativada.
Os dispositivos são predefinidos para executar os testes com a orientação de página fixa no modo retrato por padrão. No entanto, se o app estiver configurado em paisagem, você verá vídeos e capturas de tela nesse modo.
Escolhemos dispositivos de teste que proporcionam uma boa cobertura em todo o ecossistema e consideramos a popularidade do dispositivo, a frequência de falhas, as resoluções de tela, os fabricantes, a versão do SO Android e muito mais. A seleção de dispositivos de teste pode variar.
Se você tiver excluído alguns dispositivos da segmentação no manifesto do app, o relatório de pré-lançamento também vai excluir esses dispositivos nos testes, mas não vai segmentar outros dispositivos para o app.
O relatório de pré-lançamento é criado pelo Firebase Test Lab. Para personalizar os dispositivos testados, faça seus próprios testes no Console do Firebase.
Sim, vamos executar o app em um emulador e fazer o rastreamento como em um dispositivo físico.
Nosso conjunto de dispositivos abrange smartphones, tablets, Wear OS e dispositivos desktop como Chromebooks. Não é possível testar apps diretamente em dispositivos Android Automotive OS ou Android TV.
Nosso conjunto de dispositivos inclui Android 9 e versões mais recentes.