Simbolizar falhas do Android e o erro ANR para jogos do Unity
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
As falhas e os ANRs no Android geram um stack trace, que é um resumo da
sequência de funções aninhadas chamadas no jogo até o momento da falha.
Esses resumos podem ajudar você a identificar e corrigir problemas na fonte.
No entanto, quando você cria o jogo com o Unity no modo de lançamento, os símbolos
não são empacotados com o APK. Se o jogo falhar ou tiver ANRs, a pilha de chamadas vai mostrar
apenas o endereço da memória.
O Google Play tem suporte ao 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.
No Unity 2020.3 e versões mais recentes, você pode seguir as orientações do Unity para gerar
Símbolos do Android
e depois faça upload do arquivo de simbolização para o Google
Confira no Play Console um stack trace legível por humanos no Android vitals
mais avançado.
Caso contrário, consulte o artigo
Simular falhas do Android (link em inglês)
para resolver manualmente o stack trace ou gerar arquivos de símbolos para versões
anteriores do Unity.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Symbolicate Android crashes and ANR for Unity games\n\nCrashes and ANRs on Android produce a stack trace, which is a snapshot of the\nsequence of nested functions called in your game up to the moment it crashed.\nThese snapshots can help you identify and fix any problems in the source.\n\nHowever, when you build your game with Unity in release mode, the symbols are\nnot packed with the APK. If your game crashes or has ANRs, the call stack only\nshows the memory address.\n\nFor example:\n\u003e\n\u003e 05-26 18:06:51.311: A/libc(26986): Fatal signal 11 (SIGSEGV) at 0x000004e4 (code=1), thread 27024 (Worker Thread)\n\u003e 05-26 18:06:51.411: I/DEBUG(242): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***\n\u003e 05-26 18:06:51.411: I/DEBUG(242): Build fingerprint: 'Xiaomi/cancro_wc_lte/cancro:4.4.4/KTU84P/V6.7.1.0.KXDCNCH:user/release-keys'\n\u003e 05-26 18:06:51.411: I/DEBUG(242): Revision: '0'\n\u003e 05-26 18:06:51.411: I/DEBUG(242): pid: 26986, tid: 27024, name: Worker Thread \u003e\u003e\u003e com.u.demo \u003c\u003c\u003c\n\u003e 05-26 18:06:51.411: I/DEBUG(242): signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 000004e4\n\u003e I/DEBUG(242): backtrace:\n\u003e I/DEBUG(242): #00 pc 006d4960 /data/app-lib/com.u.demo-1/libunity.so\n\u003e I/DEBUG(242): #01 pc 006d4c0c /data/app-lib/com.u.demo-1/libunity.so\n\u003e I/DEBUG(242): #02 pc 006d4c0c /data/app-lib/com.u.demo-1/libunity.so\n\u003e I/DEBUG(242): #03 pc 006d4c0c /data/app-lib/com.u.demo-1/libunity.so\n\u003e I/DEBUG(242): #04 pc 006d4c0c /data/app-lib/com.u.demo-1/libunity.so\n\u003e I/DEBUG(242): #05 pc 001c5510 /data/app-lib/com.u.demo-1/libunity.so\n\u003e I/DEBUG(242): #06 pc 001c595c /data/app-lib/com.u.demo-1/libunity.so\n\u003e I/DEBUG(242): #07 pc 001c4ec0 /data/app-lib/com.u.demo-1/libunity.so\n\u003e I/DEBUG(242): #08 pc 0043a05c /data/app-lib/com.u.demo-1/libunity.so\n\u003e I/DEBUG(242): #09 pc 0000d248 /system/lib/libc.so (__thread_entry+72)\n\u003e I/DEBUG(242): #10 pc 0000d3e0 /system/lib/libc.so (pthread_create+240)\n\nGoogle Play supports uploading a debug symbols file for each version of your app\nin Play Console. This makes it easier to analyze and fix your crashes and ANRs.\n\nFrom Unity 2020.3 and higher, you can follow Unity's guidance to generate\n[Android symbols](https://docs.unity3d.com/2020.3/Documentation/Manual/android-symbols.html)\nand then [upload the symbolication file](https://support.google.com/googleplay/android-developer/answer/9848633?#zippy=%2Cupload-files-using-play-console) to Google\nPlay Console to see a human-readable stack trace on the Android Vitals\ndashboard.\n\nOtherwise, you can follow the\n[Symbolicate Android crash](https://support.unity.com/hc/en-us/articles/115000292166-Symbolicate-Android-crash) article from\nUnity to manually resolve the stack trace or generate symbol files for lower\nversions of Unity."]]