アプリケーションのデバッグを支援するために、Unity のネイティブライブラリのシンボルファイルを含むパッケージを生成することができます。シンボルファイルには、アクティブなメモリアドレスをメソッド名などの使用可能な情報に変換するテーブルが含まれています。この変換プロセスをシンボル化と呼びます。シンボルパッケージを Google Play Console にアップロードすると、Android Vitals ダッシュボードで人間が読めるスタックトレースを表示できます。
シンボルファイルには 2 種類あります。
以下のライブラリのシンボルファイルを生成することができます。
libmain
: 最初の Unity エンジンのロードロジック関連。libunity
: Unity のエンジンコード。libil2cpp
: C++ コードに変換したプロジェクトからの C# スクリプトを含みます。Unity は、libmain
と libunity
のシンボルファイルを生成します。Gradle は、libil2cpp
のシンボルファイルを生成します。
パブリックシンボルファイルには、関数のアドレスを人間が読める文字列に解決する情報が含まれています。Unity は --strip-debug
パラメーターを使用して、詳細なデバッグ情報を削除したパブリックシンボルを作成します。これにより、パブリックシンボルファイルとパッケージは、デバッグシンボル ファイルとパッケージよりも小さくなります。
デバッグシンボルファイルには、完全なデバッグ情報とシンボルテーブルが含まれています。それを使って以下を行えます。
Unity は、--only-keep-debug
パラメーターを使用して、デバッグシンボルを作成します。詳細については、Linux ユーザーマニュアルの–only-keep-debug を参照してください。
ノート: デバッグシンボルが利用できない場合、Unity はビルド時に パブリックシンボル ファイルをプロジェクトに配置します。libmain
と libunity
のライブラリではデバッグシンボルは利用できないため、Unity は常にパブリックシンボルファイルを生成します。
追加のシンボルファイルを加えるように Unity に指示できます。これは、アプリケーションがクラッシュした場合に、共有ライブラリを使用し、ローカルデバッガや Google Play で共有ライブラリのスタックトレースを解決したい場合に便利です。
Unity にカスタムシンボルファイルを加えるには、以下を行います。
.so
のプラグインを選択します。Unity がシンボルパッケージを生成するたびに、追加シンボルファイルがシンボルパッケージに追加されます。
C# スクリプトからカスタムシンボルファイルを加える場合、UnityEditor.Android 名前空間には CPU と Shared Library Type を設定するため、それぞれ以下の API が含まれています。
ノート: シンボルファイル名は、シンボルファイルの対象となる共有ライブラリの名前と一致する必要があります。例えば、共有ライブラリの名前が mylibrary.so の場合、シンボルファイルの名前もmylibrary.so でなければなりません。ファイル名の衝突を避けるため、シンボルファイルと共有ライブラリは別々のディレクトリに置く必要があります。
重要: シンボルファイルが最新で、実行コードを含む共有ライブラリと互換性があることを確認してください。そうしないと、ローカルデバッガと Google Play は、共有ライブラリ内のコードのスタックトレースを解決できません。
アプリケーションのシンボルパッケージ生成を有効にするには、2 つの方法があります。
Build Settings ウィンドウでシンボルパッケージ生成を有効にするには、以下を行います。
Build Settings ウィンドウを開きます (メニュー: File > Build Settings)。
Android プラットフォームを選択します。
Create symbols.zip に以下のいずれかを設定します。
シンボルパッケージの生成を有効にした後、プロジェクトをビルドし、libmain
、libunity
、libil2cpp
ライブラリ用のシンボルファイルを含む .zip
ファイルを生成します。スクリプティングバックエンド を IL2CPP に設定すると、.zip
には libil2cpp
ライブラリのシンボルファイルも含まれます。Unity はこのシンボルパッケージを出力ディレクトリ内に配置します。
Android Build 設定で Export Project を有効にすると、Unity はプロジェクトのビルドを行いません。代わりに、Android Studio 用にプロジェクトをエクスポートし、libmain
と libunity
用のシンボルを作成し、出力ディレクトリの unityLibrary/symbols/<architecture>/
内に配置します。Android Studio からエクスポートされたプロジェクトをビルドすると、Gradle は libil2cpp
シンボルファイルを生成し、libmain
と libunity
シンボルファイルとともに unityLibrary/symbols/<architecture>/
ディレクトリ内に配置します。
アプリケーションを Google Play にアップロードした後、パブリックシンボル パッケージをアップロードできます。この方法については、Google のドキュメント Deobfuscate or symbolicate crash stack traces を参照してください。
ノート: Google Play では、シンボルパッケージをアップロードする前にアプリケーションが受けたクラッシュはシンボル化されません。
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.