Crashlytics ダッシュボードで読み取り可能なクラッシュ レポートを取得する

iOS+ Android Flutter Unity

Crashlytics Unity SDK の最新バージョン（v12.4.1）を使用することをおすすめします。最新バージョンをダウンロードする。

iOS+（Apple プラットフォーム）

Apple プラットフォーム アプリで Crashlytics Unity SDK 8.2.0 以降を使用している場合は、Firebase Unity Editor プラグインによって Xcode プロジェクトが自動的に構成され、シンボルがアップロードされるようになります。最新バージョンをダウンロードする。

Android

Android アプリの場合、Crashlytics Unity SDK 8.6.1 以降には NDK クラッシュ レポートが自動的に含まれます。これにより、Crashlytics は Android 上で Unity IL2CPP のクラッシュを自動的に報告できます。ただし、Crashlytics ダッシュボードにネイティブ ライブラリのクラッシュのシンボリケートされたスタック トレースを表示するには、Firebase CLI を使用してビルド時にシンボル情報をアップロードする必要があります。

1. Crashlytics Unity SDK v8.6.1 以降を使用していることを確認します。最新バージョンをダウンロードする。

2. シンボルをアップロードするための環境設定とプロジェクト設定を行います。

   1. 手順に沿って Firebase CLI をインストールします。

      すでに CLI がインストールされている場合は、最新バージョンに更新してください。

   2. （Android API レベル 30 以上を使用するアプリの場合のみ）アプリの AndroidManifest.xml テンプレートを更新して、ポインタのタグ付けを無効にします。

      1. [Android Player Settings] > [Publishing Settings] > [Build] > [Custom Main Manifest] チェックボックスをオンにします。

      2. Assets/Plugins/Android/AndroidManifest.xml にあるマニフェスト テンプレートを開きます。

      3. （8.8.0 より前の SDK バージョンを使用しているアプリのみ）アプリケーション タグに次の属性を追加します。<application android:allowNativeHeapPointerTagging="false" ... />

3. プロジェクトをビルドして、シンボルをアップロードします。

   リリースビルドを作成するか、Firebase コンソールでシンボリケートされたスタック トレースを表示するビルドを作成するたびに、次の手順を行います。

   1. [Build Settings] ダイアログで、次のいずれかを行います。

      • Android Studio プロジェクトにエクスポートして、プロジェクトをビルドします。

      • APK を Unity Editor から直接ビルドします。
        ビルドする前に、[Build Settings] ダイアログで [Create symbols.zip] チェックボックスがオンになっていることを確認します。

   2. ビルドが完了したら、次の Firebase CLI コマンドを実行して、Crashlytics 互換のシンボル ファイルを生成し、Firebase サーバーにアップロードします。

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: Firebase Android アプリ ID（パッケージ名ではありません）
        Firebase Android アプリ ID の例: 1:567383003300:android:17104a2ced0c9b9b

        Firebase アプリ ID を確認する方法

        次の 2 つの方法で Firebase アプリ ID を確認することができます。

        • google-services.json ファイル内の mobilesdk_app_id の値がアプリ ID です。

        • Firebase コンソールで、[プロジェクトの設定] に移動します。下にスクロールして [マイアプリ] カードを表示し、目的の Firebase アプリをクリックしてアプリ ID を確認します。

      • PATH/TO/SYMBOLS: CLI によって生成されたシンボル ファイルへのパス

        • Android Studio プロジェクトにエクスポートした場合: PATH/TO/SYMBOLS は unityLibrary/symbols ディレクトリであり、Gradle または Android Studio でアプリをビルドすると、エクスポートされたプロジェクトのルートに作成されます。

        • Unity から直接 APK をビルドした場合: PATH/TO/SYMBOLS は、ビルドが完了した際に、プロジェクトのルート ディレクトリに生成される、圧縮されたシンボル ファイルのパスです（例: myproject/myapp-1.0-v100.symbols.zip）。

      Firebase CLI コマンドでシンボル ファイルの生成とアップロードを行う際に使用される高度なオプションを表示する

      フラグ	説明
      --generator=csym	デフォルトの Breakpad ジェネレーターではなく、古い cSYM シンボル ファイル ジェネレーターを使用します。 このオプションの使用は推奨されません。デフォルトの Breakpad シンボル ファイル ジェネレーターを使用することをおすすめします。
      --generator=breakpad	Breakpad シンボル ファイル ジェネレーターを使用します。 デフォルトのシンボル ファイル生成は Breakpad です。このフラグは、ビルド構成に symbolGenerator { csym() } を追加したが、それをオーバーライドして Breakpad を使用する場合のみ使用します。
      --dry-run	シンボル ファイルを生成するがアップロードは行いません。 このフラグは、送信されるファイルの内容を調べる場合に役立ちます。
      --debug	追加のデバッグ情報が提供される