更新记录

1.0.4（2026-07-06） 下载此版本

增加putUserData方法 自定义上传标签

1.0.3（2025-08-27） 下载此版本

支持配置userId

1.0.2（2025-04-02） 下载此版本

minSdkVersion修改

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

1、插件使用前置

1. 登录 Bugly官网 创建Android产品，获取产品 APPID
   在我的产品页，点击创建产品，按要求填写相关信息，申请创建产品。在产品的右上角获取APPID
   Bugly官网https://bugly.qq.com/v2/index
   我的产品页面:https://bugly.qq.com/v2/workbench/apps
2. HBuilderX项目 manifest.json -> App模块配置 -> 原生插件配置，勾选本插件 必须编译自定义调试基座进行功能调试，验证正常后再云端打包发布

2、使用方法

1. 原生插件引入:
   

const buglyModule = uni.requireNativePlugin('ZS-Bugly');

2. 方式一：自动读取 App 版本号初始化（推荐）

无需手动传入 App 版本号，仅需要传入 Bugly 平台申请的产品APPID
// initBuglyNoVersion( String appId,JSCallback callback,String userId)
buglyModule.initBuglyNoVersion(
    '产品APPID',
    (res) => {
      uni.showToast({
        icon: 'none',
        title: JSON.stringify(res)
      });
      console.log('this.buglyModule', this.buglyModule);
      console.log('res', res);
    },
    '当前用户ID或设备ID(可选)'
  );

3. 方式二：自动读取 App 版本号初始化（推荐）

手动传入自定义 App 版本号 ，适用于需要自定义版本标记的业务场景
// initBugly(String version,String appId, JSCallback callback,String userId) {
buglyModule.initBugly(
    '产品APPID',
    (res) => {
      uni.showToast({
        icon: 'none',
        title: JSON.stringify(res)
      });
      console.log('this.buglyModule', this.buglyModule);
      console.log('res', res);
    },
    '当前用户ID或设备ID(可选)'
  );

3、其他

1. 调试页面

打开 Bugly 原生调试页面
如需要测试是否对接完成 调用gotoNativePage方法 可以点击各种错误后在bugly后台查看是否捕获成功
初始化成功后调用以下方法 进入调试页面 测试日志捕获 在bugly控制台查看信息

buglyModule.gotoNativePage();

2. 测试日志捕获

主动触发一次 Native 崩溃，用于快速验证插件初始化、异常上报链路是否正常
buglyModule.testNativeCrash()

3. 设置自定义业务上报数据

保存发生Crash时的一些自定义的环境信息。在发生Crash时会随着异常信息一起上报并在页面展示
· 最多可以有50对自定义的key-value（超过则添加失败）；
· key限长50字节，value限长200字节，过长截断；
· 上报后可在报错详情日志的跟踪数据中查看设置的自定义数据
// putUserData(String key, String value, JSCallback callback) 
buglyModule.putUserData("userNick", "测试用户", (res) => {
  console.log(res);
  if (res.code === 0) {
    console.log("自定义数据设置成功", res);
  } else {
    console.error("自定义数据设置失败", res.msg);
  }
});