Android シンボル
ビルドした Android アプリケーションのデバッグにヘルプシンボルを生成します。
読み終わるまでの所要時間 16 分最終更新 5日前
アプリケーションのデバッグをヘルプするために、Unity はネイティブの Unity ライブラリのデバッグメタデータを持つシンボルファイルを含むパッケージを生成できます。シンボルファイルには、シンボル表 () と呼ばれる実行ファイルセクションが含まれ、アクティブなメモリーアドレスをメソッド名などの情報に変換します。翻訳プロセスはシンボル化と呼ばれます。シンボルパッケージを google play コンソールにアップロードすると、人間が判読可能なスタックトレースが Android Vitals ダッシュボードに表示されます。
.symtab実行ファイル (ELF) セクションの詳細については、Wikipedia を参照してください。
Unity は以下のライブラリのシンボルファイルを生成します。
-
: Unity エンジンの初期ロード ロジックを担当します。シンボルファイルはプリコンパイルされます。
libmain -
: Unity のエンジンコード:
libunity- ストリップエンジンコードプロパティが無効の場合、シンボルファイルはプリコンパイルされます。
- ストリップエンジンコードプロパティが有効になっている場合、Unity はビルドプロセス中にシンボルファイルをコンパイルします。
-
: C# スクリプトが含まれています。
libil2cpp- プロジェクトをエクスポートしない場合、Unity はビルドプロセス中にシンボルファイルをコンパイルします。
- プロジェクトをエクスポートする場合、Gradle はシンボルファイルをコンパイルします。
Gradle は、共有ライブラリから 実行ファイルセクションと 実行ファイルセクションをストリッピングすることで、追加の共有ライブラリのシンボルファイルを生成します。共有ライブラリにこれらのセクションが含まれていない場合、Gradle はそのセクションのシンボルファイルを生成しません。
.symtab.debug*アプリケーションのビルド形式に応じて、Unity は 2 つの方法でシンボルファイルを生成します。
- または
apkの両方に対して生成できる zip ファイル。aab - シンボルファイルをに直接埋め込みます。Unity はシンボルファイルを
aabに埋め込みません。apk
UserBuildSettings.DebugSymbols.形式 API を使用して、シンボルパッケージの形式を設定します。
シンボルファイルの種類
Unity は Gradle の debugSymbolLevel プロパティを使用してシンボルファイルを生成します。シンボルファイルには 2 種類があります。
- Publicシンボルテーブルセクションを含む小さなファイル。詳細については、パブリックシンボル を参照してください。
- デバッグパブリックシンボルファイルに含まれるすべてと、より深度なデバッグに使用できる完全なデバッグ情報が含まれています。詳細は、「 デバッグシンボル 」を参照してください。
UserBuildSettings.DebugSymbols.level を使用して、必要な種類のシンボルファイルを生成します。
UserBuildSettings.DebugSymbols.形式 = DebugSymbolFormat.IncludeInBundle | DebugSymbolFormat.Zip | DebugSymbolFormat.LegacyExtensions;
パブリックシンボル
パブリックシンボルファイルには、機能アドレスを人間が読める文字列に解決する情報が含まれています。これらのファイルにはデバッグ情報は含まれません。これにより、パブリックシンボルファイルはデバッグシンボルファイルよりも小さくなります。
Debugging symbols (デバッグシンボル)
デバッグシンボルファイルには、完全なデバッグ情報とシンボル表セクションが含まれています。これを使用して以下を行います。
- スタックトレースを解決し、ソースコードを使用できるアプリケーションをデバッグする。
- アプリケーションにネイティブをアタッチ、設定、添付し、コードをデバッグします。
カスタムシンボル
Unity に追加のシンボル ファイルを含めるように指示できます。これは、共有ライブラリを使用していて、ローカルデバッガと google play でアプリケーションがクラッシュしたときに共有ライブラリのスタックトレースを解決したい場合に便利です。
Unity にカスタムシンボルファイルを含めるには、以下を行います。
- Project ウィンドウで、ファイル拡張子を持つプラグインを選択します。
.so - Inspector で、プラットフォーム設定セクションを見つけます。
- CPU をシンボル ファイルと互換性のある CPU アーキテクチャに設定します。
- 共有ライブラリタイプをシンボルに設定します。
Unity がシンボル パッケージを生成するたびに、シンボル パッケージに追加のシンボル ファイルを追加します。
Unity に C# スクリプトのカスタムシンボルファイルを含める場合は、UnityEditor.Android 名前空間に以下の API が含まれ、それぞれ CPU と共有ライブラリタイプを設定します。

Custom plug-in in the Inspector.
シンボルパッケージの生成
アプリケーションのシンボルパッケージ生成を有効にするには、2 つの方法があります。
- ビルドプロファイルウィンドウから。
- UserBuildSettings.DebugSymbols.level および UserBuildSettings.DebugSymbols.形式 API を使用。
ビルドプロファイルウィンドウでシンボルパッケージの生成を有効にするには、次の手順に従います。
-
ビルドプロファイルウィンドウ (メニュー:ファイル> ビルドプロファイル)。
-
「プラットフォーム」パネルのプラットフォームのリストから、Android を選択するか、Android プラットフォームのビルドプロファイルを作成します。
-
デバッグシンボルを以下のいずれかに設定します。
-
シンボル出力オプションを .zip に設定します。
シンボルパッケージの生成を有効にした後、プロジェクトを構築すると、およびライブラリのシンボルファイルを含むファイルが生成されます。スクリプティングバックエンドを に設定すると、にはライブラリのシンボルファイルも含まれます。Unity はこのシンボル パッケージを出力ディレクトリ内に配置します。シンボル パッケージ ファイルの名前は、 の形式です。例えば、 はアプリケーションビルドファイルの名前、 はバージョン、 はバンドルバージョンコードです。バージョンとバンドルのバージョンコードは、Android プレイヤー設定で設定します。
libmainlibunity.zipIL2CPP
?
.ziplibil2cpp<appbuildfilename>-<version>-v<bundle version code>-IL2CPP.symbols.zipMyApp-0.1-v100-IL2CPP.symbols.zip0.1100MyAppAndroid のビルド設定でエクスポートプロジェクトを有効にすると、Unity はプロジェクトをビルドしません。代わりに、プロジェクトを Android Studio 用にエクスポートし、とのシンボルを生成し、出力ディレクトリの 内に配置します。Android Studio からエクスポートしたプロジェクトをビルドすると、Gradle によってシンボルファイルが生成され、 および シンボルファイルとともに ディレクトリ内に配置されます。
libmainlibunityunityLibrary/symbols/<architecture>/libil2cpplibmainlibunityunityLibrary/symbols/<architecture>/google play コンソールでのシンボルの使用
埋め込まれたシンボル
Android アプリバンドル (aab) を作成する場合は、シンボルをに直接埋め込み、google play にアップロードできます。
aabUserBuildSettings.DebugSymbols.level = DebugSymbolLevel.SymbolTable;UserBuildSettings.DebugSymbols.format = DebugSymbolFormat.IncludeInBundle;
Zip 圧縮されたシンボル
圧縮されたシンボルパッケージを生成するには、以下のコードを使用します。
UserBuildSettings.DebugSymbols.level = DebugSymbolLevel.SymbolTable;UserBuildSettings.DebugSymbols.format = DebugSymbolFormat.Zip | DebugSymbolFormat.LegacyExtensions;
アプリケーションを google play にアップロードしたら、public symbols zip パッケージをアップロードできます。この方法については、Google のドキュメントを参照してください。クラッシュスタックトレースを解読または記号化します。