SDK 初始化

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

我的收藏
本文将为您介绍如何初始化终端性能监控 Pro SDK。

示例代码

参考以下代码初始化 SDK,我们推荐尽早可能初始化SDK,如将初始化逻辑放在 AbilityonCreate 生命周期中。可参考如下代码进行初始化。
import { Bugly, BuglyBuilder, AppVersionMode, ModuleName } from "bugly";

initBugly(context: Context): void {
let builder = new BuglyBuilder();

builder.appId = 'xxxxxxx'; // 必填,终端性能监控 Pro 应用列表中的 APP ID
builder.appKey = 'xxx-xxxx-xxxx-xxxx-xxxx'; // 必填,终端性能监控 Pro 应用列表中的 APP KEY
builder.deviceId = "12345"; // 必填,设备 ID,应保证设备 ID 对不同设备唯一
builder.platform = BuglyBuilder.PLATFORM_PRO; // 必填,设置上报平台,专业版本需设置为[BuglyBuilder.PLATFORM_PRO]

builder.appVersion = '1.0.0'; // 选填,业务的 App 版本
builder.appVersionMode = AppVersionMode.DEBUG; // 选填,当前 App 的版本类型,支持根据不同的版本类型下发配置
builder.buildNum = '0'; // 选填,业务 App 版本的构建号
builder.appChannel = 'website'; // 选填,业务 App 渠道
builder.userId = "12345"; // 选填,用户 ID,如不设置则为空
builder.deviceModel = "huawei"; // 选填,机型,如不设置则为空
builder.debugMode = true; // 选填,默认开启,开启后 SDK 会打印更多调试日志,线上版本可关闭
builder.sdkLogMode = true; // 选填,设置 debugMode 或 sdkLogMode 均可开启 Bugly sdk 日志,适用于线上关闭 debug 模式但又希望打印 bugly 日志的场景
builder.initDelay = 0; // 选填,延迟初始化时间,单位ms
builder.enableJsCrashProtect = false; // 选填,是否开启 Js 异常崩溃保护,设置为 true 后发生未捕获 Js 异常,进程不会退出
builder.enablePerfModules = ModuleName.AllModules; // 选填,开启性能监控项,可传入单个性能模块名称或一组性能模块名称,此处初始化后,还需配置开启对应模块采样率,模块才会真正开启

Bugly.init(context, builder); // 如果需等待 Bugly 完全初始化完成,使用 await Bugly.init(context, builder);
}
注意:
Context 需要传递 ApplicationContext。
设备 ID 非常重要,终端性能监控 Pro 使用设备 ID 来计算设备异常率,强烈建议应用设置正确的设备 ID,以确保设备的唯一性。
BuglyBuilder 需在 init 方法前创建,且应避免重复调用 init 方法。
需要调用 Bugly.init 接口进行初始化,完成初始化后,再调用其他接口进行定制化设置,否则设置不生效。
在同一进程中,应只初始化一次 SDK。仅建议在主线程中初始化,0.4.1 及之后的 SDK 版本仅支持在主线程中初始化。