源映射

了解如何将源映射上传到 Sentry。

本指南假设你使用的是版本 5.11.0 或更高的 Sentry React Native SDK。

如果你使用的是旧版本并希望上传源映射,我们建议将 SDK 升级到最新版本。

为了获取未压缩的 JavaScript 堆栈跟踪,必须生成并上传源映射。如果未使用自定义值,React Native SDK 会为 iOS(通过 Xcode)和 Android(通过 Gradle)_自动_处理源映射。

根据你的设置选择以下其中一个指南,或尝试 自动上传 以开始。

配置自动上传 source maps 最简单的方法是使用 Sentry Wizard:

Copied
npx @sentry/wizard@latest -i reactNative

向导将引导你完成以下步骤:

  • 登录 Sentry 并选择项目
  • 安装必要的 Sentry 包
  • 配置 RN 构建工具以生成和上传源映射

它支持 JavaScript Core(包括 RAM Bundle)和 Hermes。如果你想手动配置自动源映射上传,请按照 手动配置 页面上的步骤操作。

如果你想禁用源映射的自动上传,可以设置 SENTRY_DISABLE_AUTO_UPLOAD 环境变量:

Copied
export SENTRY_DISABLE_AUTO_UPLOAD=true

android/app/build.gradle 中添加 shouldSentryAutoUpload 函数:

Copied
apply from: "../../../sentry.gradle"

sentry {
    autoUploadProguardMapping = shouldSentryAutoUpload()
    uploadNativeSymbols = shouldSentryAutoUpload()
}

符号化由 Metro 开发服务器直接处理,在开发环境中自动提供将堆栈跟踪转换为可读源代码所需的符号化。因此,对于这些类型的构建,无需上传源映射,这就是为什么自动上传源映射被禁用的原因。