@bugfender/rn-bugfender

中文文档
6.0.0发布于 2026/07/27ISCTypeScriptESM + CJS近 30 天下载 2899

对 Bugfender SDK 执行原生绑定

中文使用文档
文档目录7 节
  1. 曝光兼容性
  2. 在您的工程中添加臭虫
  3. 使用量
  4. 示例
  5. 网络记录
  6. 更改日志
  7. 麻烦的解决

对 Bugfender 执行本地插件

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

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

曝光兼容性

Bugfender与世博会合作 "粗糙的工作流程". 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。 。 。 .

使用量

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

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

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

示例

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。 。 。 .

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 反应-内在 标签。 关于所有Bugfender产品更改,请访问一般放出注释.

麻烦的解决

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

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

bundle exec pod install

或者,对于新建筑:

RCT_NEW_ARCH_ENABLED=1 bundle exec pod install

您可以在此找到更多细节 : https://reactnative.dev/docs/ 环境设置

版本与发布记录

@bugfender/rn-bugfender 共发布 33 个版本,首次发布于 2018/09/03;过去 12 个月发布了 3 个版本。

版本发布日期距今
6.0.0latest2026/07/273 个月前
5.0.12026/01/199 个月前
5.0.02026/01/089 个月前
4.0.02025/01/021.8 年前
3.0.02024/09/042 年前
2.2.12023/08/103 年前

其他发布通道:alpha → 2.0.0-alpha.0,beta → 2.2.0。

关于 @bugfender/rn-bugfender 的常见问题

@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 和提交记录判断。