调试符号
了解如何使用 Sentry Gradle 插件或 sentry-cli 向 Sentry 提供调试符号。
调试符号可以帮助您获得可读的堆栈跟踪,Sentry 在 问题详情 页面上显示这些信息,以帮助您排查问题。我们提供多种方法将调试符号提供给 Sentry。
使用默认设置时,完整的堆栈跟踪在您的 Java/Kotlin 错误中是可用的,除非您使用 enableProguardInReleaseBuilds。在这种情况下,您需要上传由 Android Gradle Plugin 生成的 ProGuard/R8 映射文件,以便 Sentry 可以显示正确的堆栈跟踪。
通过推荐的 Gradle 集成方法上传 Android ProGuard/R8 映射文件和原生符号。
来自 Android 应用原生层的错误需要上传某些调试信息文件。例如,带有 NDK 支持的 Android 应用需要上传 DWARF 调试文件。
要为 React Native Android 构建上传原生符号,请使用 Sentry Gradle 插件的 uploadNativeSymbols
选项。
要上传原生 iOS 调试符号,请设置一个运行脚本构建阶段,使用 Sentry CLI 上传调试符号到 Sentry。您可以在此处找到相关文档:[手动配置](/platforms/react-native/manual
通过使用 sentry-cli
的 upload-proguard 和 debug-files 手动上传 Android ProGuard/R8 映射文件和原生符号。
要启用 Source Context,请使用 Sentry Gradle 插件的 includeSourceContext
选项。
要启用 Source Context,请设置一个 运行脚本构建阶段以上传调试符号到 Sentry,并在构建前设置 SENTRY_INCLUDE_NATIVE_SOURCES=true
。