Desofuscar ou simbolizar stack traces de falhas

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.

  1. Abra o Play Console.
  2. Selecione um app.
  3. No menu à esquerda, selecione Monitorar e melhorar > Android vitals > Falhas e ANRs.
  4. Selecione uma falha.
  5. 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.

Perguntas frequentes

Isso foi útil?

Como podemos melhorá-lo?

Precisa de mais ajuda?

Siga as próximas etapas:

11560399568083906566
true
Pesquisar na Central de Ajuda
true
true
true
true
true
92637
Pesquisa
Limpar pesquisa
Fechar pesquisa
Menu principal
false
false
false