Instabug-React-Native 安装与配置指南

1. 项目基础介绍

Instabug-React-Native 是一个为 React Native 应用提供 in-app 反馈和 bug 报告功能的开源项目。用户可以通过简单的摇动手机来报告 bugs 或发送 in-app 反馈。这个 SDK 能够捕获设备的环境快照，包括所有的控制台日志和服务器端网络请求，帮助开发者更快地调试和修复 bugs。

该项目主要使用的编程语言是 JavaScript。

2. 项目使用的关键技术和框架

• React Native：用于构建原生移动应用的 JavaScript 框架。
• JavaScript：项目的主要实现语言。
• CocoaPods：iOS 项目的依赖管理工具。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的开发环境中已经安装以下工具：

• Node.js：JavaScript 运行时环境。
• npm：Node.js 包管理器。
• React Native CLI：React Native 的命令行界面。

安装步骤

步骤 1：安装依赖

首先，确保您已经安装了 Node.js 和 npm。然后，在您的 React Native 项目目录中，运行以下命令安装 Instabug-React-Native 包：

npm install instabug-reactnative

或者，如果您使用 Yarn：

yarn add instabug-reactnative

步骤 2：配置 iOS 项目

对于 iOS 项目，您需要使用 CocoaPods 来安装依赖。在您的 iOS 项目目录中，运行以下命令：

cd ios && pod install && cd ..

步骤 3：初始化 Instabug

在您的 React Native 项目的 JavaScript 文件中，导入 Instabug 并在组件的 constructor 或 componentWillMount 方法中初始化它。下面是一个初始化 Instabug 的示例：

import Instabug from 'instabug-reactnative';

Instabug.init({
  token: 'APP_TOKEN',
  invocationEvents: [Instabug.invocationEvent.shake]
});

请将 'APP_TOKEN' 替换为您的 Instabug 应用令牌。

步骤 4：配置权限（iOS）

为了使 Instabug 能够允许用户添加音频和视频附件，您需要在您的 iOS 应用的 info.plist 文件中添加麦克风和照片库使用的描述。添加以下两项并填入适当的描述：

<key>NSMicrophoneUsageDescription</key>
<string>我们的应用需要访问麦克风以允许添加语音备注。</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>我们的应用需要访问您的照片库以允许添加图片。</string>

步骤 5：上传源码映射文件

为了在崩溃报告中显示完整的符号化堆栈跟踪，您需要确保在发布构建时自动生成的源码映射文件能够上传到您的 Instabug 仪表板。这需要在您的应用令牌中明确添加到 Instabug.init 方法中。

以上步骤就是 Instabug-React-Native 的详细安装和配置指南。按照这些步骤操作后，您就可以开始使用 Instabug 在您的 React Native 应用中收集反馈和报告 bugs 了。