Simbolizar falhas do Android e o erro ANR para jogos Unity

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.

Exemplo:

05-26 18:06:51.311: A/libc(26986): Fatal signal 11 (SIGSEGV) at 0x000004e4 (code=1), thread 27024 (Worker Thread)
05-26 18:06:51.411: I/DEBUG(242): *** *** *** *** *** *** *** *** *** *** *** *** *** *** *** ***
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'
05-26 18:06:51.411: I/DEBUG(242): Revision: '0'
05-26 18:06:51.411: I/DEBUG(242): pid: 26986, tid: 27024, name: Worker Thread  >>> com.u.demo <<<
05-26 18:06:51.411: I/DEBUG(242): signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 000004e4
 I/DEBUG(242): backtrace:
 I/DEBUG(242):     #00  pc 006d4960  /data/app-lib/com.u.demo-1/libunity.so
 I/DEBUG(242):     #01  pc 006d4c0c  /data/app-lib/com.u.demo-1/libunity.so
 I/DEBUG(242):     #02  pc 006d4c0c  /data/app-lib/com.u.demo-1/libunity.so
 I/DEBUG(242):     #03  pc 006d4c0c  /data/app-lib/com.u.demo-1/libunity.so
 I/DEBUG(242):     #04  pc 006d4c0c  /data/app-lib/com.u.demo-1/libunity.so
 I/DEBUG(242):     #05  pc 001c5510  /data/app-lib/com.u.demo-1/libunity.so
 I/DEBUG(242):     #06  pc 001c595c  /data/app-lib/com.u.demo-1/libunity.so
 I/DEBUG(242):     #07  pc 001c4ec0  /data/app-lib/com.u.demo-1/libunity.so
 I/DEBUG(242):     #08  pc 0043a05c  /data/app-lib/com.u.demo-1/libunity.so
 I/DEBUG(242):     #09  pc 0000d248  /system/lib/libc.so (__thread_entry+72)
 I/DEBUG(242):     #10  pc 0000d3e0  /system/lib/libc.so (pthread_create+240)

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