本指南介绍了如何使用 Firebase Crashlytics SDK 自定义崩溃报告。默认情况下,Crashlytics 会自动为您应用的所有用户收集崩溃报告(您可以关闭自动崩溃报告并为您的用户启用选择加入报告)。 Crashlytics 提供了四种开箱即用的日志记录机制:自定义键、自定义日志、用户标识符和捕获的异常。
添加自定义键
自定义键可帮助您了解导致崩溃的应用程序的特定状态。您可以将任意键/值对与您的崩溃报告相关联,然后使用自定义键在 Firebase 控制台中搜索和过滤崩溃报告。
在Crashlytics 仪表板中,您可以搜索与自定义键匹配的问题。
当您在控制台中查看特定问题时,您可以查看每个事件的关联自定义键(键子选项卡),甚至可以按自定义键过滤事件(页面顶部的过滤器菜单)。
使用setCustomKey
实例方法设置键/值对。请注意, setCustomKey
已为value
参数重载以接受任何原语或String
参数。这里有些例子:
Kotlin+KTX
val crashlytics = Firebase.crashlytics crashlytics.setCustomKeys { key("my_string_key", "foo") // String value key("my_bool_key", true) // boolean value key("my_double_key", 1.0) // double value key("my_float_key", 1.0f) // float value key("my_int_key", 1) // int value }
Java
FirebaseCrashlytics crashlytics = FirebaseCrashlytics.getInstance(); crashlytics.setCustomKey("my_string_key", "foo" /* string value */); crashlytics.setCustomKey("my_bool_key", true /* boolean value */); crashlytics.setCustomKey("my_double_key", 1.0 /* double value */); crashlytics.setCustomKey("my_float_key", 1.0f /* float value */); crashlytics.setCustomKey("my_int_key", 1 /* int value */);
您还可以通过调用键并将其设置为不同的值来修改现有键的值。例如:
Kotlin+KTX
val crashlytics = Firebase.crashlytics crashlytics.setCustomKeys { key("current_level", 3) key("last_UI_action", "logged_in") }
Java
FirebaseCrashlytics crashlytics = FirebaseCrashlytics.getInstance(); crashlytics.setCustomKey("current_level", 3); crashlytics.setCustomKey("last_UI_action", "logged_in");
通过将CustomKeysAndValues
的实例传递给setCustomKeys
实例方法来批量添加键/值对:
Kotlin+KTX
对于 Kotlin,现有功能比使用CustomKeysAndValues
构建器更简单。
crashlytics.setCustomKeys { key("str_key", "hello") key("bool_key", true) key("int_key", 1) key("long_key", 1L) key("float_key", 1.0f) key("double_key", 1.0) }
Java
CustomKeysAndValues keysAndValues = new CustomKeysAndValues.Builder() .putString("string key", "string value") .putString("string key 2", "string value 2") .putBoolean("boolean key", True) .putBoolean("boolean key 2", False) .putFloat("float key", 1.01) .putFloat("float key 2", 2.02) .build(); FirebaseCrashlytics.getInstance().setCustomKeys(keysAndValues);
添加自定义日志消息
为了让您自己了解导致崩溃的事件的更多背景信息,您可以将自定义 Crashlytics 日志添加到您的应用程序。 Crashlytics 将日志与您的崩溃数据相关联,并将它们显示在Firebase 控制台的 Crashlytics 页面的“日志”选项卡下。
使用log
来帮助查明问题。例如:
Kotlin+KTX
Firebase.crashlytics.log("message")
Java
FirebaseCrashlytics.getInstance().log("message");
设置用户标识符
要诊断问题,了解您的哪些用户遇到了给定的崩溃通常很有帮助。 Crashlytics 包含一种在崩溃报告中匿名识别用户的方法。
要将用户 ID 添加到您的报告中,请以 ID 号、令牌或散列值的形式为每个用户分配一个唯一标识符:
Kotlin+KTX
Firebase.crashlytics.setUserId("user123456789")
Java
FirebaseCrashlytics.getInstance().setUserId("user123456789");
如果您在设置用户标识符后需要清除它,请将值重置为空字符串。清除用户标识符不会删除现有的 Crashlytics 记录。如果您需要删除与用户 ID 关联的记录,请联系 Firebase 支持。
(仅限 Android NDK)将元数据添加到 NDK 崩溃报告
您可以选择在 C++ 代码中包含crashlytics.h
标头,以将元数据添加到 NDK 崩溃报告,例如自定义键、自定义日志、用户标识符。所有这些选项都在上面的页面上进行了描述。
crashlytics.h
在Firebase Android SDK GitHub Repository中作为仅包含标头的 C++ 库提供。
阅读头文件中的注释,了解有关使用 NDK C++ API 的说明。
报告非致命异常
除了自动报告您应用程序的崩溃之外,Crashlytics 还允许您记录非致命异常并在您的应用程序下次启动时将它们发送给您。
使用recordException
方法在应用程序的catch
块中记录非致命异常。例如:
Kotlin+KTX
try { methodThatThrows() } catch (e: Exception) { Firebase.crashlytics.recordException(e) // handle your exception here }
Java
try { methodThatThrows(); } catch (Exception e) { FirebaseCrashlytics.getInstance().recordException(e); // handle your exception here }
所有记录的异常在 Firebase 控制台中显示为非致命问题。问题摘要包含您通常从崩溃中获得的所有状态信息,以及按 Android 版本和硬件设备分类的故障信息。
Crashlytics 在专用后台线程上处理异常,以最大限度地减少对您的应用程序的性能影响。为了减少用户的网络流量,Crashlytics 将记录的异常集中在一起,并在应用程序下次启动时发送它们。
启用选择性报告
默认情况下,Crashlytics 会自动为您应用的所有用户收集崩溃报告。为了让用户更好地控制他们发送的数据,您可以通过禁用自动报告并仅在您选择在代码中将数据发送到 Crashlytics 来启用选择加入报告:
在
AndroidManifest.xml
文件的application
块中,添加一个meta-data
标记以关闭自动收集:<meta-data android:name="firebase_crashlytics_collection_enabled" android:value="false" />
通过在运行时调用 Crashlytics 数据收集覆盖来为选定用户启用收集。覆盖值在您的应用程序启动后一直存在,因此 Crashlytics 可以自动收集报告。要选择退出自动崩溃报告,请将
false
作为覆盖值传递。设置为false
时,新值直到下一次运行应用程序才会应用。Kotlin+KTX
Firebase.crashlytics.setCrashlyticsCollectionEnabled(true)
Java
FirebaseCrashlytics.getInstance().setCrashlyticsCollectionEnabled(true);
管理 Crash Insights 数据
Crash Insights 通过将您的匿名堆栈跟踪与来自其他 Firebase 应用的跟踪进行比较,并让您知道您的问题是否属于更大趋势的一部分,从而帮助您解决问题。对于许多问题,Crash Insights 甚至提供资源来帮助您调试崩溃。
Crash Insights 使用汇总的崩溃数据来识别常见的稳定性趋势。如果您不想共享您的应用数据,您可以从Firebase 控制台中 Crashlytics 问题列表顶部的崩溃洞察菜单中选择退出崩溃洞察。