Este artigo explica como configurar e gerar um relatório de pré-lançamento. Se você já tiver feito isso, saiba como interpretar o relatório.
Um relatório de pré-lançamento é gerado automaticamente quando um app é publicado para teste aberto, fechado ou interno. Isso ajuda a identificar problemas proativamente antes que o app chegue aos usuários. Ele inclui os seguintes testes:
- Problemas de estabilidade
- Problemas de compatibilidade com o Android
- Problemas de desempenho
- Problemas de acessibilidade
- Vulnerabilidades de segurança
- Problemas de privacidade
Como o relatório de pré-lançamento funciona
Depois de você fazer upload e publicar um Android App Bundle de teste, ele é instalado 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. O app também é desinstalado de todos os dispositivos.
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.
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 de relógio.
Gerar um relatório de pré-lançamento
Testar seu appPara gerar o relatório de pré-lançamento do seu app, publique-o em uma faixa de teste fechada ou aberta.
Você receberá um relatório de pré-lançamento automaticamente para qualquer app publicado em uma faixa de teste, a menos que o desative. 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.
Para receber notificações por e-mail dos relatórios de pré-lançamento disponíveis, siga estas etapas:
- Abra Play Console > Notificações.
- Role a tela para baixo até "Relatório de pré-lançamento" e marque a caixa ao lado dele. Escolha se você prefere receber e-mails sobre todos os testes ou somente as notificações referentes a problemas.
Os relatórios de pré-lançamento são gerados automaticamente quando você publica um app em uma faixa de teste fechada ou aberta. Para desativar todos os relatórios de pré-lançamento do seu app:
- Abra Play Console> Relatório de pré-lançamento > Configurações.
- Role a tela para baixo até "Preferências" e desmarque a caixa "Ativar relatório de pré-lançamento" para desativar o relatório do seu app.
- Clique em Salvar.
Personalizar os testes
Personalize seus testes e deixe o relatório de pré-lançamento mais abrangente e relevante para o app.
Etapa 1: enviar as credenciais da conta de teste se o app tiver uma tela de login
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, selecione Teste > Relatório de pré-lançamento > Configurações.
- 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, selecione Teste > Relatório de pré-lançamento > Configurações.
- Faça as alterações:
- 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.
Etapa 2: inserir um script Robo ou loop de jogo
Se você quiser controlar as etapas que o rastreador executa ao testar o app, insira um script Robo ou loop de jogo.
Inserir um script Robo para personalizar o caminho de teste de um app JavaÉ 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.
- Selecione 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.
- Publique a versão do jogo com o loop em uma faixa de teste aberta ou fechada. O rastreador vai detectar e executar automaticamente o loop de jogo.
Etapa 3: personalizar o ponto de partida do teste com links diretos
É 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.
Etapa 4: conferir relatórios de teste sobre idiomas específicos
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.
Configurar preferências de idioma- Abra o Play Console.
- Selecione um app.
- No menu à esquerda, selecione 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.
Visualizar o resumo do relatório de pré-lançamentoPara ver um resumo do relatório de pré-lançamento, faça o seguinte:
- Abra o Play Console.
- Selecione um app.
- Selecione 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.
- Selecione Teste > Relatório de pré-lançamento > Detalhes.
- Consulte as guias Estabilidade, Desempenho, Acessibilidade, Capturas de tela e Segurança e confiabilidade. 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.
Perguntas frequentes
Testes de apps
Quanto tempo leva o teste?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.
Apps que executam validação no lançamento
É possível gerar um relatório de pré-lançamento para um app que realiza validação de país?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:
- Você pode autorizar os blocos de endereços IP documentados na visão geral do Firebase Test Lab.
- Marcar a opção Modify instrumented test behavior for Test Lab adicionando uma variável do sistema
A plataforma de testes não é compatível com apps que verificam se um dispositivo tem controle privilegiado (acesso root) no Android.
Apps com anúncios ou opções de compra
Meu app tem anúncios. Como garantir que o teste do relatório de pré-lançamento não interfira nas impressões e cliques, já que isso pode ser um problema para minha rede de publicidade?Os anúncios do Google já excluem o tráfego dos intervalos de endereços do relatório de pré-lançamento. Para outras redes de publicidade, você precisa especificar os intervalos de endereços IP a serem excluídos.
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.
Outros comportamentos de apps
Meu código está ofuscado (Java) ou teve os símbolos de depuração removidos (nativo). Ainda é possível usar os relatórios de pré-lançamento?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.
Seleção de dispositivo
Como vocês decidem quais dispositivos usarão para testar meu app?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 computadores como Chromebooks. Não é possível testar apps diretamente em dispositivos Android Auto ou Android TV.
Nosso conjunto de dispositivos inclui Android 9 e versões mais recentes.