调试符号

了解如何使用 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-cliupload-proguarddebug-files 手动上传 Android ProGuard/R8 映射文件和原生符号

要启用 Source Context,请使用 Sentry Gradle 插件的 includeSourceContext 选项

要启用 Source Context,请设置一个 运行脚本构建阶段以上传调试符号到 Sentry,并在构建前设置 SENTRY_INCLUDE_NATIVE_SOURCES=true