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

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 fechado ou aberto. 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 o upload e publicar um APK ou pacote de apps 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.

 

Recolher tudo Expandir tudo

Gerar um relatório de pré-lançamento

Testar seu app

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ê recebe os resultados do teste em até uma hora após o upload do APK ou do pacote de apps. Às vezes, isso pode levar algumas horas.

Inscrever-se para receber e-mails do relatório de pré-lançamento

Para receber notificações por e-mail dos relatórios de pré-lançamento disponíveis, siga estas etapas:

  1. Abra o Play Console.
  2. Clique em Configuração > Notificações.
  3. Role a tela para baixo até o item 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.
Desativar relatórios de pré-lançamento

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 o Play Console.
  2. Selecione um app.
  3. Selecione Teste > Relatório de pré-lançamento > Configurações.
  4. Role a tela para baixo até "Preferências" e desmarque a caixa de seleção Ativar relatórios de pré-lançamento para desativar o relatório do seu app.
  5. 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: fornecer 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, será necessário fornecer as credenciais da conta. Você não precisará enviar as credenciais se o app tiver a opção "Fazer login com o Google", porque isso permite que o rastreador entre automaticamente.

Veja algumas informações importantes para testar credenciais:

  • As credenciais fornecidas 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".
Configurar credenciais
  1. Abra o Play Console.
  2. Selecione um app.
  3. No menu à esquerda, selecione Teste > Relatório de pré-lançamento > Configurações.
  4. Na seção "Credenciais da conta de teste", selecione Enviar credenciais.
  5. Digite o seguinte: 
    • Nome de usuário: o nome de usuário associado à conta de teste. 
    • Senha: insira a senha associada à conta de teste.
  6. Clique em Salvar. Essas credenciais serão usadas para todos os testes futuros, a menos que sejam editadas.
Editar ou remover credenciais
  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 serão 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:

  1. Grave o script usando a ferramenta Firebase no Android Studio (Android Studio > Tools > Firebase > Test Lab > Record Robo Script). Para ver detalhes, acesse a Central de Ajuda do Firebase.
    • Observação: não é necessário ter uma conta do Firebase para criar um script Robo.
  2. Quando o script estiver pronto, abra o Play Console.
  3. Selecione um app.
  4. 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.
  5. Clique em Salvar.
Inserir um loop de jogo para testar um app ou jogo OpenGL

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 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: visualizar relatórios de teste sobre idiomas específicos

Se você quiser ver 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 APK ou pacote de apps de teste. Por isso, você só poderá adicionar as preferências de idioma depois da conclusão do primeiro teste.  

Configurar preferências de idioma
  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.

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çamento

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 Ver detalhes para mostrar informações mais detalhadas sobre os problemas.
  7. Para visualizar 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 fazer o último teste, você verá a mensagem "Falha no teste". Para fazer um novo teste, publique outro APK ou pacote de apps.

Visualizar detalhes do relatório de pré-lançamento

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. Veja as guias Estabilidade, Desempenho, Acessibilidade, Capturas de tela e Segurança e confiabilidade. Em cada página, você verá 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 fazer o último teste, você verá a mensagem "Falha no teste". Para fazer um novo teste, publique outro APK ou pacote de apps.

Perguntas frequentes

Recolher tudo Expandir tudo

Testes de apps

Quanto tempo leva o teste?

Em geral, você recebe os resultados do teste em até uma hora após o upload do APK ou 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ó poderã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 APK ou pacote de apps 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:

É possível receber um relatório de pré-lançamento de um app que verifica se há dispositivos com acesso root?

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.

Há algo que preciso saber sobre o teste de apps com anúncios de display?

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 testes incluem a compra de assinaturas ou produtos no aplicativo?

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.

Existe uma maneira de pré-carregar dispositivos de teste com mídia ou outros apps pré-instalados?

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 analisar um app com dados pré-carregados, poderá publicar uma versão de teste do app com os arquivos de mídia incorporados no APK ou no pacote de apps.

E se o app usar um serviço de licenciamento do Google Play?

Se o app estiver em teste aberto ou tiver sido publicado para produção, as análises do relatório de pré-lançamento usarão um código que simula o licenciamento para o app.

Se o app não estiver em um teste aberto e não tiver um APK ativo publicado para produção, ele será reprovado na verificação de licenciamento. Você ainda receberá resultados do relatório de pré-lançamento, mas o app não estará licenciado. Para fazer testes nesses apps, publique uma versão fechada com a opção de serviços de licenciamento desativada.

Os dispositivos de teste funcionam com apps que usam a configuração de paisagem?

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.

E se eu tiver excluído alguns dispositivos da segmentação no manifesto do app?

Se você tiver excluído alguns dispositivos da segmentação no manifesto do app, o relatório de pré-lançamento também os excluirá nos testes, mas não segmentará dispositivos personalizados para o app.

É possível personalizar o conjunto de dispositivos de teste?

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.

É possível gerar relatórios de pré-lançamento em apps compilados para dispositivos x86?

Nosso conjunto de dispositivos limita-se à arquitetura ARM. Um APK x86 será exibido como incompatível com todos os dispositivos de teste.

É possível gerar relatórios de pré-lançamento em apps para Wear OS by Google, Auto, TV e versões mais antigas do Android?

Nosso conjunto de dispositivos está limitado a smartphones e tablets. Por isso, não é possível testar apps diretamente no Wear OS by Google, Auto ou TV. Nosso conjunto também não inclui dispositivos Android com versões anteriores à 4.1.1 (Jelly Bean).

Isso foi útil?
Como podemos melhorá-lo?

Precisa de mais ajuda?

Faça login e veja mais opções de suporte para resolver o problema rapidamente.