设置崩溃和异常报告

在为您的项目设置崩溃和异常报告之前,请确保您已按照我们入门指南中概述的基本设置要求进行操作。拥有项目 ID 以将项目连接到 Unity 仪表板非常重要。在您的仪表板使用基本项目凭据设置完毕后,您可以在 Unity 编辑器中为您的项目启用崩溃和异常报告。

要启用崩溃和异常报告

  1. 在 Unity 编辑器中打开您的项目。
  2. 从 Unity 编辑器菜单中,选择“窗口”>“常规”>“服务”以打开“服务”窗口。
  3. 在“服务”窗口中,选择“云诊断”。
  4. 选择“崩溃和异常报告”旁边的切换按钮以打开该服务。

使用高级云诊断设置自定义报告

默认情况下,崩溃和异常报告使用标准元数据(例如设备操作系统)进行配置。使用高级云诊断,您还可以添加自定义元数据以实现更大的调试能力。此自定义元数据可以在任何时间点捕获,例如游戏首次初始化、新关卡加载,甚至玩家采取特定操作时。

崩溃和异常报告包括一个CrashReportHandler 类,用于配置崩溃报告和自定义元数据。使用SetUserMetadata 方法,最多可将 64 个自定义元数据条目添加到您的报告中。

使用此语句请求要跟踪的新元数据

UnityEngine.CrashReportHandler.CrashReportHandler.SetUserMetadata(“key”, “value”);

触发测试报告

通过触发报告并在Unity 仪表板中查看它来测试云诊断服务。通过抛出异常或通过 Debug.LogException() 方法记录异常消息来创建报告。为此,请在 C# 脚本中找到您希望测试异常发生的某个方法(例如,在第一个屏幕加载时运行的方法),并添加以下行

Debug.LogException(new Exception(“Testing Cloud Diagnostics reports”));

保存脚本并在播放模式下运行您的游戏。您应该能够在编辑器内的控制台中查看 Debug.LogException 消息。

查看您的测试报告

Unity 仪表板查看云诊断报告

  1. 打开Unity 仪表板
  2. 从顶部导航菜单中的项目选择器中选择启用了云诊断的项目。
  3. 从主导航菜单中,选择+按钮,然后转到云诊断>崩溃和异常报告
  4. 您的测试报告将位于“问题”部分中。选择测试报告的标题以查看其数据。

设置新报告的通知

云诊断支持通过集成进行报告通知,因此您可以将开发工作流程连接到非 Unity 工具。您不必手动检查仪表板以查看是否报告了任何新问题,而是可以通过第三方集成(如电子邮件、Slack、Discord、Trello 等)接收通知。

要设置报告通知

  1. 打开Unity 仪表板

  2. 从顶部导航菜单中的项目选择器中选择您的项目。

    • 注意:在设置报告通知之前,请确保您已为此项目启用了崩溃和异常报告。
  3. 从主导航菜单中,选择“项目”。

  4. 从展开的下拉列表中,选择“项目设置”>“集成”。

  5. 选择“新建集成”按钮,然后按照弹出模式中的说明进行操作。

批处理模式支持

从 2018.4.1+ 和 2019.1.3+ 开始,在 Unity 中以-batchmode模式运行时,现在支持原生崩溃报告。在将应用程序作为服务器构建运行时,也支持原生崩溃报告。在以批处理模式运行时,请确保在命令行中指定 -username 和 -password,以避免遇到 USYM_UPLOAD_AUTH_TOKEN 错误。

下一步做什么?

现在您已启用崩溃和异常报告,请了解如何理解和管理它们