# @bugfender/rn-bugfender 中文文档

规范地址：https://npmcn.com/package/%40bugfender/rn-bugfender/

版本：6\.0\.0
npm 元数据更新时间：2026-07-27T10:16:36.481Z
中文译文更新时间：2026-11-08T19:42:47.788Z
软件包许可：ISC

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40bugfender/rn-bugfender
原文对照：https://npmcn.com/package/%40bugfender/rn-bugfender/?lang=original
项目主页：https://github.com/bugfender/rn-bugfender.git#readme
源码仓库：https://github.com/bugfender/rn-bugfender

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：264 kB，87 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：@bugfender/common ^1\.0\.0，@bugfender/sdk ^4\.0\.1，react \*，react-native \*
- 首次发布：2018-09-03T09:28:56.995Z
- 最新版本发布：2026-07-27T10:16:36.285Z
- 近 30 天下载量：2899（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 3 个）

## 中文简介

对 Bugfender SDK 执行原生绑定

## 安装

```sh
npm install @bugfender/rn-bugfender
```

也可以使用：`pnpm add @bugfender/rn-bugfender`、`yarn add @bugfender/rn-bugfender`、`bun add @bugfender/rn-bugfender`

## README

# 对 Bugfender 执行本地插件

Bugfender 为Web反应原生和回放原生模块. 这取决于iOS,Android和Javascript Bugfender SDKs.

这个版本在React Industrial同时被用"老建筑"和"新建筑"进行测试. "新建筑"仍然处于实验性状态,因此在新的回放原生版本中可能会被打破.

## 曝光兼容性

Bugfender与世博会合作 ["粗糙的工作流程"](https://docs.expo.io/introduction/managed-vs-bare/#bare-workflow). Expo Go应用程序(被管理的工作流程所使用)无法运行 Bugfender SDK,因为它包含本地代码.

## 在您的工程中添加臭虫

`$ cd path_to_your_project`

从 npm 添加臭虫插件

`$ npm install @bugfender/rn-bugfender @bugfender/sdk @bugfender/common`

安装后, 关闭并重新启动您的应用程序 `npm run ios` 或者说 `npm run android`。 。 。 .

## 使用量

```typescript
import { Bugfender, LogLevel } from '@bugfender/rn-bugfender';
```

请检查以下 URL 以获取完整的 API 引用 : [https://docs.bugfender.com (中文(简体) )](https://docs.bugfender.com/)。 。 。 .

注意: 总是导入 @ bugfender/rn- bugfender 而不是 @ bugfender/ sdk 。 这将使SDK的原生特征成为你无法得到的.

### 示例

```typescript
import { Bugfender, LogLevel } from '@bugfender/rn-bugfender';

// Init Bugfender with your APP key
Bugfender.init({
  appKey: '<YOUR APP KEY>',
  // apiURL: 'https://api.bugfender.com',
  // baseURL: 'https://dashboard.bugfender.com',
  // overrideConsoleMethods: true,
  // printToConsole: true,
  // logUIEvents: true,
  // registerErrorHandler: true,
  // deviceName: 'Anonymous',
  // maximumLocalStorageSize: 5 * 1024 * 1024, // Native specific
  // enableLogcatLogging: false, // Android specific
  // networkLoggingEnabled: false,
  // networkLoggingCaptureBodies: false,
  // networkLoggingCaptureErrorResponseBodies: false,
  // logBrowserEvents: true, // Web specific
  // build: '42', // Web specific
  // version: '1.0', // Web specific
});
```

### 网络记录

网络记录为 **选入** 并默认禁用。 启用时, HTTP 请求会作为日志在 Bugfender 中显示 `bf_network`。 。 。 .

```typescript
Bugfender.setNetworkLoggingEnabled(true);
// Optional:
Bugfender.setNetworkLoggingCaptureBodies(false);
Bugfender.setNetworkLoggingCaptureErrorResponseBodies(true);
Bugfender.setNetworkLoggingURLFilter(
  ['https://api.example.com/*'],
  ['*/secrets/*']
);
Bugfender.setNetworkLoggingMaxRequestsPerMinute(60);

// Optional: redact sensitive headers/bodies before they are logged
Bugfender.setNetworkLoggingRequestObfuscationHandler((url, headers, body) => ({
  url,
  headers: { ...headers, authorization: '[REDACTED]' },
  body,
}));
Bugfender.setNetworkLoggingResponseObfuscationHandler((headers, body) => ({
  headers,
  body: body ? body.replace(/"token":"[^"]*"/g, '"token":"[REDACTED]"') : null,
}));
```

您也可以启用它的时间与 `networkLoggingEnabled`, (中文(简体) ), `networkLoggingCaptureBodies`,以及 `networkLoggingCaptureErrorResponseBodies`。 。 。 .

平台注释:

-   **iOS: (英语)** URL 会话流量被捕获( 包括 React Index) `fetch`) (中文(简体) ).
-   **机器人:** 原生反应 `fetch`/XHR通过OkHttp(`android-okhttp` 4.x适配器).
-   **网络 :** 用途 `@bugfender/sdk` (≥ 4.0.0),拦截 `fetch` 财务报告和审定财务报表 `XMLHttpRequest`。 。 。 .
-   需要本地臭虫 Android SDK **4.x (中文(简体) )** (这个软件包拉 `com.bugfender.sdk:android:4.+`) (中文(简体) ).

## 更改日志

Bugfender Web SDK 的更改日志可见于下页的 ReleaseNotes [反应-内在](https://bugfender.releasenotes.io/tag/react-native) 标签。 关于所有Bugfender产品更改,请访问一般放出注释.

## 麻烦的解决

我们经常有关于可可Pods安装失败的问题。 虽然这和Bugfender无关 你可以 在安装吊舱时遇到这个问题 .

为了重新安装舱,你可以:

```sh
bundle exec pod install
```

或者,对于新建筑:

```sh
RCT_NEW_ARCH_ENABLED=1 bundle exec pod install
```

您可以在此找到更多细节 : [https://reactnative.dev/docs/ 环境设置](https://reactnative.dev/docs/environment-setup)

## 常见问题

### @bugfender/rn-bugfender 是什么？

对 Bugfender SDK 执行原生绑定

### 如何安装 @bugfender/rn-bugfender？

在项目目录运行 npm install @bugfender/rn-bugfender，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@bugfender/common（^1\.0\.0）、@bugfender/sdk（^4\.0\.1）、react（\*）、react-native（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @bugfender/rn-bugfender 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @bugfender/rn-bugfender 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @bugfender/rn-bugfender 可以商用吗？

@bugfender/rn-bugfender 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @bugfender/rn-bugfender 的下载量有多少？

根据 npm 官方下载统计，@bugfender/rn-bugfender 在 2026/10/09 – 2026/11/07 这 30 天内被下载 2,899 次，日均约 97 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @bugfender/rn-bugfender 还在维护吗？

最新版本 6\.0\.0 发布于 2026/07/27（3 个月前）；至今共发布 33 个版本，其中过去 12 个月发布了 3 个；首次发布于 2018/09/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。