アプリケーションのデバッグを支援するために、Unity のネイティブライブラリのシンボルファイルを含むパッケージを生成することができます。シンボルファイルには、アクティブなメモリアドレスをメソッド名などの使用可能な情報に変換するテーブルが含まれています。この変換プロセスをシンボル化と呼びます。シンボルパッケージを Google Play Console にアップロードすると、Android Vitals ダッシュボードで人間が読めるスタックトレースを表示できます。
シンボルファイルには 2 種類あります。
以下のライブラリのシンボルファイルを生成することができます。
libmain
: 最初の Unity エンジンのロードロジック関連。libunity
: Unity のエンジンコード。libil2cpp
: C++ コードに変換したプロジェクトからの C# スクリプトを含みます。Unity は、libmain
と libunity
のシンボルファイルを生成します。Gradle は、libil2cpp
のシンボルファイルを生成します。
パブリックシンボルファイルには、関数のアドレスを人間が読める文字列に解決する情報が含まれています。Unity は --strip-debug
パラメーターを使用して、詳細なデバッグ情報を削除したパブリックシンボルを作成します。これにより、パブリックシンボルファイルとパッケージは、デバッグシンボル ファイルとパッケージよりも小さくなります。
パブリックシンボルファイルは、.sym.so
というファイル拡張子を使用します。
デバッグシンボルファイルには、完全なデバッグ情報とシンボルテーブルが含まれています。それを使って以下を行えます。
Unity は、--only-keep-debug
パラメーターを使用して、デバッグシンボルを作成します。詳細については、Linux ユーザーマニュアルの–only-keep-debug を参照してください。
デバッグシンボルファイルは、.dbg.so
というファイル拡張子を使用します。
ノート: デバッグシンボルが利用できない場合、Unity はビルド時に パブリックシンボル ファイルをプロジェクトに配置します。libmain
と libunity
のライブラリではデバッグシンボルは利用できないため、Unity は常にパブリックシンボルファイルを生成します。
アプリケーションのシンボルパッケージ生成を有効にするには、以下を行います。
シンボルパッケージの生成を有効にした後、プロジェクトをビルドし、libmain
、libunity
、libil2cpp
ライブラリ用のシンボルファイルを含む .zip
ファイルを生成します。Unity は、libil2cpp
ライブラリのパブリックシンボルとデバッグシンボルの両方を生成し、libmain
と libunity
ライブラリのパブリックシンボルを生成します。Unity は、このシンボルパッケージを出力ディレクトリ内に置きます。
Android Build 設定で Export Project を有効にすると、ビルドプロセスを実行する際にUnity はプロジェクトのビルドやシンボルの生成を行いません。代わりに、Android Studio 用にプロジェクトをエクスポートし、出力ディレクトリの unityLibrary/symbols
に空のディレクトリを作成します。エクスポートされたプロジェクトを Android Studio からビルドすると、Gradle は libil2cpp
シンボルファイルを生成して、unityLibrary/symbols/<architecture>/
ディレクトリに配置します。libmain
と libunity
のシンボルファイルを取得してシンボルパッケージを完成させるには、手動でそれらを見つけて unityLibrary/symbols/<architecture>/
ディレクトリにコピーする必要があります。これらのファイルの場所は、 Strip Engine Code Player 設定を有効にしているかどうかによって異なります。
libunity
: <project-path>/Temp/StagingArea/symbols/<architecture>/
ノート: Unity は、エディターを終了すると、Temp
ディレクトリを削除します。つまり、プロジェクトをエクスポートした後、エディターを終了する前にシンボルファイルをコピー/移動する必要があります。libmain
: <editor>/PlaybackEngines/AndroidPlayer/Variations/<scripting backend>/<build type>/Symbols/<architecture>/
libunity
and libmain
: <editor>/PlaybackEngines/AndroidPlayer/Variations/<scripting backend>/<build type>/Symbols/<architecture>/
パブリックまたはデバッグシンボルファイルを使用する前に、ファイル拡張子の一部を削除する必要があります。パブリックシンボルファイルの場合、これは .sym
です。デバッグシンボルファイルの場合、.dbg
です。
アプリケーションを 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.