手柄 Android 崩溃
了解崩溃处理程序链,该链定义了应用程序崩溃时发生的情况。
阅读时间6 分钟最后更新于 6 天前
ON Android Unity Applications 的崩溃处理用作崩溃处理程序链。位于链Start的崩溃处理程序程序首先接收崩溃,它可以处理崩溃并将崩溃正向给链中的Next一个崩溃处理程序程序。链中崩溃处理程序的Order由它们的安装Order定义。首先安装的崩溃处理程序是最后一个接收崩溃的处理程序,最后安装的崩溃处理程序是第一个接收崩溃的处理程序。默认情况下,Unity 充当链中的第一个崩溃处理程序。它处理崩溃并将它们转发给链中的Next一个崩溃处理程序,即默认情况下的 Android System崩溃处理程序程序。
您可以将 Unity 配置为对崩溃做出不同的反应,还可以将您自己的自定义定义崩溃处理处理程序添加到链中。Page介绍如何指定 Unity 用于手柄崩溃的方法以及如何创建自定义定义崩溃处理程序程序。
指定 Unity 如何处理崩溃
如果不想使用 Unity 的默认崩溃处理行为,可以使用 命令行参数来 Change Unity 对崩溃的反应方式。此参数采用以下值之一:
-androidChainedSignalHandlerBehavior行为值 | 描述 |
|---|---|
| 发生原生崩溃When,Unity 会将崩溃打包并抛出为 Java 异常。Unity 不会将崩溃正向给Any已安装的崩溃处理程序或默认System。 **注意:**GameActivity 不支持此行为值,在将来的 Unity 版本中将已移除。 |
| 发生原生崩溃When,Unity 会忽略该崩溃,Android 会将该崩溃直接转发给链中的Next一个崩溃处理程序程序。这是自定义定义崩溃处理程序程序(如果已安装),或者默认System(如果未安装)。 **注意:**如果使用值,Unity Services(如 Unity Cloud Diagnostics)将不再手柄崩溃,也不会上报崩溃。 |
ON 如何向 Unity 通道此命令行参数的信息,请参阅指定 Unity Start-up Arguments。
创建和设置自定义崩溃处理程序程序
本节包含如何创建和设置您自己的崩溃处理程序的示例。要执行此操作,不得使用 Unity 的 Legacy 崩溃处理行为。有关更多信息,请参阅指定 Unity 如何处理崩溃。
创建崩溃处理程序
以下代码样本显示了自定义定义崩溃处理程序程序。如果使用 IL2CPP Scripting Backend,则可以将此示例文件直接放入 Unity Project。然后 Unity 将其编译为 的一部分。如果使用 Mono Scripting Backend,则必须编译并链接自己的共享库。有关更多信息,请参阅为 Android 创建原生插件。
cpplibil2cpp.cppandroid_crash_handler.cpp
#include <android/log.h>#include <jni.h>#include <signal.h>struct sigaction s_PreviousHandler;bool s_SignalHandlerInstalled;Static void MyCustomHandler(整型 sig, siginfo_t* 信息, 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 = {}; Action.sa_sigaction = MyCustomHandler; // Note:如果需要,注册更多信号。 Action.sa_flags = SIGSEGV; sigaction(SIGSEGV, &Action, &s_PreviousHandler); s_SignalHandlerInstalled = true;}extern "C" JNIEXPORT void Java_COM_Unity3d_PlayerActivity_InstallCustomSignalHandlersFromJava(){ InstallCustomSignalHandlers();}extern "C" void UninstallCustomSignalHandlers(){ if (s_SignalHandlerInstalled) { sigaction(SIGSEGV, &s_PreviousHandler, nullptr); s_SignalHandlerInstalled = false; }}
安装崩溃处理程序
要安装崩溃处理程序并使 Unity 使用它来手柄崩溃,请调用上述文件中的 方法。您可以通过 C# 或 Java 代码执行此操作,但最佳做法是从 Java 调用此方法,因为崩溃可能发生在 Unity Player 初始化之后,但在 C# 代码运行之前。
cppInstallCustomSignalHandlers以下代码样本展示了如何从 Java 代码调用 方法。要将其添加到 Project,您可以将 Java 文件作为插件安装(请参阅创建 Java 或 Kotlin 音频源插件),也可以修改导出 Project 中的现有 Java 文件。
InstallCustomSignalHandlersUnityPlayerActivity.java
public native void InstallCustomSignalHandlersFromJava(); static { { System.loadLibrary("il2cpp"); } // Setup activity layout @Override protected void onCreate(Bundle savedInstanceState) { InstallCustomSignalHandlersFromJava(); ... mUnityPlayer = new UnityPlayer(this, this); setContentView(mUnityPlayer); mUnityPlayer.requestFocus(); }