Usar um relatório de pré-lançamento para identificar problemas

Para 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:

1. Abra Play Console > Notificações.
2. 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:

1. Abra Play Console> Relatório de pré-lançamento > Configurações.
2. 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.
3. Clique em Salvar.

1. Abra o Play Console.
2. Selecione um app.
3. No menu à esquerda, selecione Teste > Relatório de pré-lançamento > Configurações.
4. 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.
5. Clique em Salvar. Essas credenciais vão ser usadas para todos os testes futuros, a menos que sejam editadas.

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:

1. 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.
2. 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.

1. Abra o Play Console.
2. Selecione um app.
3. No menu à esquerda, selecione Teste > Relatório de pré-lançamento > Configurações.
4. Em "Teste seu app em idiomas específicos", selecione + Adicionar idioma.
5. 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.
6. Clique em Salvar.

Para ver um resumo do relatório de pré-lançamento, faça o seguinte:

1. Abra o Play Console.
2. Selecione um app.
3. Selecione Teste > Relatório de pré-lançamento > Visão geral.
4. Consulte cada seção:
   • Estabilidade
   • Desempenho
   • Acessibilidade
   • Segurança e confiabilidade
5. Se alguma seção tiver um problema, selecione Mostrar resumo para expandir as informações.
6. Selecione Acessar detalhes para mostrar informações mais detalhadas sobre os problemas.
7. 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:

1. Abra o Play Console.
2. Selecione um app.
3. Selecione Teste > Relatório de pré-lançamento > Detalhes.
4. 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.

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:

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

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.

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