React Native集成Sentry

这是我们的React-Native SDK的文档。 React-Native SDK使用iOS和Android的原生扩展，但如有必要，将回退到纯JavaScript版本。

一、安装

首先添加Sentry然后链接它：

$ npm install react-native-sentry --save
# or
# yarn add react-native-sentry
# if you are using yarn
# this is for linking
$ react-native link react-native-sentry

链接步骤将引入本机依赖项并相应地修补项目。如果您正在使用世博会，则不必（或不能）运行该链接步骤。有关详细信息，请参阅将Sentry与Expo一起使用。

在链接时，新的Sentry向导将帮助您配置项目并相应地更改文件。

链接后，将执行以下更改：

• 在Android上添加用于本机崩溃报告的sentry-java包
• 在iOS上添加sentry-cocoa包以进行本机崩溃报告
• 启用android的哨兵gradle构建步骤
• 适用于iOS的AppDelegate.m补丁
• 补丁MainApplication.java for Android
• 在index.js / App.js文件中为提供的DSN配置Sentry
• 在ios / sentry.properties和android / sentry.properties中存储构建凭据。

要查看链接期间发生的情况，可以参考手动设置，它将为您提供所有详细信息。

请注意，我们目前仅支持react-native＆gt; = 0.38。

二、升级

如果要从早期版本的sentry-react-native进行升级，则应重新链接该程序包以确保生成的代码更新为最新版本：

$ react-native unlink react-native-sentry
$ react-native link react-native-sentry

三、iOS细节

当您使用Xcode时，您可以直接挂钩到构建过程以上载调试符号和源图。如果您正在使用bitcode，则需要禁用“将调试符号上传到Sentry”构建阶段，然后分别将调试符号从iTunes Connect上传到Sentry。

四、Android细节

对于Android，我们为源映射构建过程挂钩。运行react-native链接时，gradle文件会自动更新。当你运行./gradlew assembleRelease时，源代码会自动构建并上传到Sentry。

五、客户端配置

注意：运行react-native链接时，我们将自动更新index.ios.js / index.android.js并进行以下更改：

import { Sentry } from 'react-native-sentry';
Sentry.config('https://<key>@sentry.io/<project>').install();

如果要执行此操作，可以将其他配置选项传递给config（）方法。

六、混合Stacktraces

目前我们只支持iOS上的混合堆栈跟踪。默认情况下，此功能已禁用。我们建议您在激活此应用时彻底测试您的应用，将其设置为deactivateStacktraceMerging：false请参阅：其他配置。