Unity ゲームの Android のクラッシュと ANR をシンボリケートする

Android でクラッシュや ANR が発生すると、スタック トレースが生成されます。スタック トレースとは、クラッシュの時点までにゲームで行われた関数呼び出しを順番にネストしたスナップショットです。このスナップショットは、ソース内の問題を特定して修正するのに役立ちます。

ただし、リリースモードで Unity を使用してゲームをビルドした場合、シンボルは APK とパッケージ化されません。ゲームでクラッシュや ANR が発生した場合、コールスタックに表示されるのはメモリアドレスのみです。

次に例を示します。

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)

Google Play は、アプリの各バージョンに対応したデバッグ シンボル ファイルの Google Play Console へのアップグレードをサポートしています。これにより、クラッシュや ANR の分析と修正が容易になります。

Unity 2020.3 以降では、Unity のガイダンスに従って Android シンボル Google にシンボリケーション ファイルをアップロードします。 Google Play Console で、人が読める形式のスタック トレースを Android Vitals で確認 できます。

それ以外の場合は、Unity の Android のクラッシュをシンボリケートする方法についての記事に沿って、手動でスタック トレースを解決するか、Unity の以前のバージョン向けのシンボル ファイルを生成することができます。