ドキュメント

Unity Engine

Unity Engine

Android クラッシュの処理

アプリケーションがクラッシュした場合に何が起こるかを定義するクラッシュハンドラーのチェーンを理解します。
読み終わるまでの所要時間 10 分最終更新 5日前

Android での Unity アプリケーションのクラッシュ処理は、クラッシュ ハンドラのチェーンとして機能します。チェーン開始時のクラッシュ ハンドラーが最初にクラッシュを受信し、クラッシュを処理して、チェーン内の次のクラッシュ ハンドラーにフォワードすることもできます。チェーン内のクラッシュハンドラーの順序は、それらがインストールされた順序によって定義されます。最初にインストールされたクラッシュ ハンドラーは、最後にインストールされたクラッシュ ハンドラーで、最後にインストールされたクラッシュ ハンドラーは最初にクラッシュを受信します。デフォルトでは、Unity はチェーンの最初のクラッシュ ハンドラーとして機能します。クラッシュを処理し、チェーン内の次のクラッシュ ハンドラーに転送します。デフォルトでは Android システム クラッシュ ハンドラーです。
クラッシュに対して異なる反応を示すように Unity を設定し、独自のカスタムクラッシュハンドラーをチェーンに追加することもできます。このページでは、Unity がクラッシュの処理に使用するメソッドの指定方法と、カスタムクラッシュハンドラーの作成方法について説明します。

Unity がクラッシュを処理する方法を指定します。

Unity のデフォルトのクラッシュ処理動作を使用しない場合は、
-androidChainedSignalHandlerBehavior
コマンドライン引数を使用して、Unity のクラッシュに対する反応を変更できます。この引数は、以下のいずれかの値を取ります。

動作値

説明

legacy
ネイティブのクラッシュが発生すると、Unity はクラッシュをラップして Java 例外としてスローします。Unity は、インストールされているクラッシュ ハンドラやデフォルト システムにクラッシュをフォワードしません。

**ノート:**この動作値は GameActivity ではサポートされていないため、Unity の今後のバージョンでは削除される予定です。
disabled
ネイティブのクラッシュが発生すると、Unity はそれを無視して、Android はクラッシュをチェーン内の次のクラッシュ ハンドラーに直接転送します。これは、カスタム クラッシュ ハンドラーがインストールされている場合はそのハンドラーで、インストールされていない場合はデフォルト システムです。

ノート:この値を使用すると、Unity Cloud Diagnostics などの Unity Services はクラッシュを処理しなくなり、レポートも行われなくなります。
このコマンドライン引数を Unity に渡す方法については、「 Specify Unity 開始引数 」を参照してください。

カスタムクラッシュハンドラーの作成と設定

このセクションでは、独自のクラッシュ ハンドラーの作成および設定方法の例を紹介します。これが正しく機能するためには、Unity の古い機能のクラッシュ処理動作を使用しないでください。詳細については、「 Specify how Unity handle crashes 」を参照してください。

クラッシュハンドラーの作成

以下のコードサンプルは、カスタムクラッシュハンドラーを示しています。IL2CPP スクリプティングバックエンドを使用する場合は、このサンプル
cpp
ファイルを Unity プロジェクトに直接配置できます。その後、Unity は
libil2cpp.cpp
の一部としてそれをコンパイルします。Mono スクリプティングバックエンドを使用する場合は、独自の共有ライブラリをコンパイルおよびリンクする必要があります。詳細については、Android 用ネイティブプラグインの作成 を参照してください。
android_crash_handler.cpp
#include <android/log.h>#include <jni.h>#include <signal.h>struct sigaction s_PreviousHandler;bool s_SignalHandlerInstalled;静的 void MyCustomHandler(int sig, siginfo_t* info, void* ucontext){ __android_log_print(ANDROID_LOG_VERBOSE, "CustomCrashHandler", "Handling signal %d", sig); s_PreviousHandler.sa_sigaction(sig, info, ucontext);}extern "C" void InstallCustomSignalHandlers(){ struct sigaction アクション = {}; Action.sa_sigaction = MyCustomHandler; // Note:必要な場合は、さらに信号を登録します。 Action.sa_flags = SIGSEGV; sigaction(SIGSEGV, &Action, &s_PreviousHandler); s_SignalHandlerInstalled = true;}extern "C" JNIEXPORT void Java_com_unity3d_プレイヤー_UnityPlayerActivity_InstallCustomSignalHandlersFromJava(){ InstallCustomSignalHandlers();}extern "C" void UninstallCustomSignalHandlers(){ if (s_SignalHandlerInstalled) { sigaction(SIGSEGV, &s_PreviousHandler, nullptr); s_SignalHandlerInstalled = false; }}

クラッシュハンドラーのインストール

クラッシュハンドラーをインストールし、Unity でそれを使用してクラッシュを処理するには、上記の
cpp
ファイルで
InstallCustomSignalHandlers
メソッドを呼び出します。これは C# または Java コードで行うことができますが、Java からこのメソッドを呼び出すのが効率的です。なぜなら、クラッシュは Unity Player の初期化後、C# コードの実行前に発生する可能性があるためです。
以下のコードサンプルは、Java コードから
InstallCustomSignalHandlers
メソッドを呼び出す方法を示しています。プロジェクトに追加するには、Java ファイルをプラグインとしてインストールするか (Java または Kotlin ソースプラグインの作成 を参照)、エクスポートしたプロジェクトの既存の Java ファイルを変更します。
注
このメソッドをコールする場所に応じて、クラッシュ処理の動作が変わります。Unity ランタイム初期化(
mUnityPlayer = new UnityPlayer(this, this);
を含むコード行)の前にコールした場合、ネイティブ クラッシュ時には Unity のクラッシュ ハンドラーが最初に実行され、その後、信号ハンドラーが実行されます(Unity が信号を転送した場合)。Unity ランタイム初期化後に
InstallCustomSignalHandlers
を呼び出す場合は、ネイティブクラッシュ時にハンドラーが最初に実行され、信号のフォワードは自身で行ってください。
UnityPlayerActivity.java
public native void InstallCustomSignalHandlersFromJava(); static { { System.loadLibrary("il2cpp"); } // Setup activity layout protected void onCreate (Bundle savedInstanceState) { { InstallCustomSignalHandlersFromJava(); ... mUnityPlayer = new UnityPlayer(this, this); setContentView(mUnityPlayer); mUnityPlayer.requestFocus(); }