SDK 集成

最近更新时间:2025-08-20 17:51:32

我的收藏
本文将为您介绍通过自动集成和手动集成两种方式集成 SDK。

前提条件

终端性能监控 Pro 需要使用 Bugly SDK 0.4.1及以上版本。

自动集成(推荐)

1. 配置内网鸿蒙三方库,执行以下命令。(设置默认存在该三方库,则无需配置)
ohpm config set registry https://ohpm.openharmony.cn/ohpm/
说明:
设置默认原始只有鸿蒙官方三方库,如添加了其他三方库,需通过 ohpm config list 查看设置的三方库,手动将 https://ohpm.openharmony.cn/ohpm/ 追加后重新设置。
2. 通过 ohpm 安装 Bugly 库。
ohpm install bugly@0.4.1

3. 安装完成后可直接在 arkTs 中通过 import 导入引用。

手动集成

1. 通过三方仓库或其他渠道下载 Bugly.har 三方 SDK 包。
2. 在需要集成的模块下创建 libs 目录,将 Bugly.har 放入目录。
3. 在模块的 oh-package.json5 文件中添加对应 dependencies,如下所示。
"dependencies": {
"bugly": "file:./libs/Bugly.har"
}

配置混淆规则

业务二次混淆 Har 包代码,可能导致部分 Napi 符号或字符串变量不可见,引入运行问题,建议业务直接 keep Bugly Har 包。在 hap 工程目录下 obfuscation-rules.txt 混淆规则配置文件中直接添加如下规则即可:
-keep
../oh_modules/bugly