Godot Androidビルド：デバッグシンボル生成とPlay Consoleへのアップロード手順

GodotエンジンでAndroid向けゲームを開発し、Google Play Consoleにアップロードする際、クラッシュスタックトレースを人間が読める形（シンボリケーション）にするには、ビルドと完全に一致するネイティブデバッグシンボルが必要です。この記事では、Windows環境でそのデバッグシンボルを生成し、Play Consoleにアップロードする手順を詳しく説明します。

前提条件

• Android SDKのインストール: Android SDKがインストールされていることを確認します。

• 環境変数の設定: 環境変数 ANDROID_HOME をAndroid SDKのパスに設定します。

  コマンドプロンプトの場合:

  bat

  set ANDROID_HOME=C:\Users\YourName\AppData\Local\Android\Sdk

• Godotソースコードのクローン: 使用しているGodotエディタ/エクスポートテンプレートと同じバージョンのソースコードをクローンします。デバッグシンボルはリリースするエクスポートビルドと対応していなければなりません。

  bat

  git clone https://github.com/godotengine/godot.git
  cd godot
  git checkout 4.x

Windowsでのビルド手順（指定フラグ使用）

Godotソースコードのルートディレクトリで、以下のSConsコマンドを実行します。指定されたフラグは、Godotのビルドシステムが対応している場合に使用します。

デバッグテンプレートのビルド（テスト用）

scons platform=android target=template_debug generate_android_binaries=yes debug_symbols=yes gradle_do_not_strip=yes

Sentryのドキュメントでも、Androidエクスポートテンプレートを target=template_debug、platform=android、arch=arm32、debug_symbols=yes でコンパイルする方法が示されています。

リリーステンプレートのビルド（Play Console提出用）

Play Consoleに提出するビルドには、リリーステンプレートを使用することを強くお勧めします。

scons platform=android target=template_release generate_android_binaries=yes debug_symbols=yes gradle_do_not_strip=yes

シンボルを分離する場合

シンボルを別ファイルとして生成するには、separate_debug_symbols=yes を追加します。

scons platform=android target=template_release generate_android_binaries=yes debug_symbols=yes gradle_do_not_strip=yes separate_debug_symbols=yes

Play Consoleにアップロードするファイル

• シンボルの一致: アップロードするAAB/APKと完全に同じビルドから生成されたデバッグシンボルを使用します。異なるバージョンのシンボルは機能しません。
• 公式シンボルの利用: Godotが提供する公式エクスポートテンプレートをそのまま使う場合、Godotのリリースページからダウンロードできる公式デバッグシンボルを使用するのが最も安全です。
• ZIPファイルの構造: Play Consoleが受け付けるネイティブシンボルのZIP構造について、現時点の情報では詳細が不足しています。手動でパッケージングする必要がある可能性があります。

重要な注意点

• バージョンの一致: 異なるGodotバージョンやエクスポートテンプレートのシンボルを混在させないでください。デバッグシンボルはエクスポートしたゲームビルドと完全に対応している必要があります。
• カスタムビルドの場合: Godotのソースコードを変更したり、独自にテンプレートをビルドした場合は、公式シンボルではなく、自分でビルドしたシンボルを使用してください。
• 出力ファイルの場所: Windowsでの出力ファイルの正確な場所やPlay Console用ZIPのパッケージング手順について、現在のエビデンスでは十分な情報が得られていません。

以上の手順に従えば、Windows環境でGodotのAndroidビルド用デバッグシンボルを生成し、Play Consoleにアップロードする準備が整います。