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