As falhas e ANRs no Android produzem um stack trace, que é um resumo da sequência de funções aninhadas chamadas no programa até o momento da falha. Esses resumos podem ajudar você a identificar e corrigir problemas na fonte.
Se o app ou jogo tiver sido desenvolvido com Java, e você usar o ProGuard para otimizar e ofuscar seu app, faça upload de um arquivo de mapeamento ProGuard para cada versão do app no Play Console. Se o app ou jogo for desenvolvido com código nativo, como C++, faça upload de um arquivo de símbolos de depuração para cada versão do app no Play Console. Isso facilita a análise e a correção de falhas e ANRs.
Importante: a desofuscação de apps compilados em Java só é possível com arquivos de mapeamento compatíveis com o ReTrace. Esse é o mesmo formato usado pelo ProGuard e R8.
Etapa 1: gerar um arquivo de desofuscação ou simbolização
Para desofuscar ou simbolizar falhas e ANRs em uma versão do app, primeiro é preciso gerar os arquivos necessários dessa versão. Gere e faça upload de um arquivo a cada nova versão do app para que os processos funcionem.
Etapa 2: fazer upload de um arquivo de desofuscação ou simbolização
Para desofuscar ou simbolizar as falhas e os ANRs do app para uma versão dele, é preciso fazer upload dos arquivos de desofuscação ou simbolização para cada versão.
Importante: essa etapa é obrigatória somente para os desenvolvedores que usam APKs. Se você usa um pacote de apps e o Plug-in do Android para Gradle 4.1 ou versões mais recentes, não precisará fazer nada. Pegaremos automaticamente o arquivo de desofuscação do pacote, e você poderá pular para a Etapa 3: visualizar os stack traces de falhas desofuscados. Saiba mais sobre os pacotes de apps no site para desenvolvedores Android.
Etapa 3: visualizar os stack traces de falhas desofuscados
Ao fazer upload de um arquivo de mapeamento ProGuard ou de símbolos de depuração para uma versão do app, as falhas e os ANRs que ocorrerem depois disso serão desofuscados. Na página Falhas e ANRs do app, revise os stack traces desofuscados para identificar os problemas individuais.
- Abra o Play Console.
- Selecione um app.
- No menu à esquerda, selecione Monitorar e melhorar > Android vitals > Falhas e ANRs.
- Selecione uma falha.
- Na seção "Stack traces", você verá o que está desofuscado e simbolizado.
Importante: somente as falhas e ANRs posteriores ao upload do arquivo de mapeamento da versão do app serão desofuscados. As falhas e ANRs de uma versão do app que ocorreram antes do upload do respectivo arquivo de mapeamento não serão desofuscados.