SDK 初始化

最近更新时间:2025-08-14 15:29:52

我的收藏
本文将为您介绍如何初始化 SDK。

示例代码

参考以下代码初始化 SDK,我们推荐尽可能早初始化,这样才能及时捕获异常。
public static void initBugly(Context context) {
// 1. 初始化参数预构建,必需设置初始化参数
String appID = "a278f01047"; // 【必需设置】产品的 APPID
String appKey = "1e5ab6b3-b6fa-4f9b-a3c2-743d31dffe86"; // 【必需设置】产品的 APPKEY
BuglyBuilder builder = new BuglyBuilder(appID, appKey);
// 2. 【必需设置】设置上报域名,因为终端性能监控 Pro 与 Bugly 共用一个 SDK,需要通过上报域名来区分。
buglyBuilder.setServerHostType(BuglyBuilder.ServerHostTypeBuglyCloud);
// 3. 基本初始化参数,推荐设置初始化参数
builder.uniqueId = "unique_id"; // 【推荐设置】设置设备唯一 ID,必须保证唯一性,不设置则由终端性能监控 Pro 生成唯一 ID,影响设备异常率的统计以及联网设备数的统计,建议 sp 保存复用;
builder.userId = "user_id"; // 【推荐设置】设置用户 ID,影响用户异常率的统计,建议 sp 保存复用,同一进程生命周期里面,暂不支持多次设置;
builder.deviceModel = Build.MODEL; // 【推荐设置】设置设备类型,设置机型后,终端性能监控 Pro SDK 不再读取系统的机型
builder.appVersion = "1.0.0"; // 【推荐设置】设置 App 版本号,不设置则从 packageManager 中读取。建议按应用的规范,主动设置,需要跟上传符号表的应用版本参数保持一致。
builder.buildNumber = "builderNum"; // 【推荐设置】设置 App 版本的构建号,用于 Java 堆栈翻译关联版本,跟上传符号表的构建号参数保持一致。
builder.appVersionType = BuglyAppVersionMode.Debug; // 【推荐设置】设置版本类型
// 4. 更多初始化参数,按需设置初始化参数
builder.appChannel = "appChannel"; // 设置 App 的渠道
builder.logLevel = BuglyLogLevel.LEVEL_DEBUG; // 设置日志打印级别,级别可从 Bugly LogLevel 中获取
builder.enableAllThreadStackCrash = true; // 设置 Crash 时是否抓取全部线程堆栈,默认开启
builder.enableAllThreadStackAnr = true; // 设置 Anr 时是否抓取全部线程堆栈,默认开启
builder.enableCrashProtect = true; // 设置性能监控时开启 Crash 保护模式,默认开启
builder.debugMode = false; // 设置 debug 模式,可在调试阶段开启
builder.initAppState = BuglyBuilder.APP_STATE_FOREGROUND; // 自4.4.3.7版本起支持。该参数为非必选项,可在初始化 Bugly SDK 时指定应用的前后台状态。若未指定,SDK 将在初始化时通过 getRunningAppProcesses 判断应用的前后台状态;若已指定,SDK 将直接采用指定状态,不再调用 getRunningAppProcesses 进行判断。

// 5. 设置回调方法,按需设置初始化参数
builder.setCrashHandleListener(crashHandleListener); // 设置 Crash 处理回调接口,详情见回调接口
builder.setUploadHandleListener(uploadhandleListener); // 设置 Crash 上报回调接口,详情见回调接口
// 6. 初始化,必需调用
Bugly.init(context, builder);
}
注意事项:
Context 需要传递 ApplicationContext。
设备 ID 非常重要,终端性能监控 Pro 使用设备 ID 来计算设备异常率,强烈建议应用设置正确的设备 ID,以确保设备的唯一性。
BuglyBuilder 需在 init 方法前创建,且应避免重复调用 init 方法。
需要调用 Bugly.init 接口进行初始化,完成初始化后,再调用其他接口进行定制化设置,否则设置不生效。
性能监控项可在 应用配置 > SDK 配置 中进行采样调整,通过调整设备采样率来开启或者关闭性能监控项。
建议在用户授权《终端性能监控 Pro SDK 个人信息保护规则》 后再初始化终端性能监控 Pro SDK。
初始化时,一定要通过 BuglyBuilder.setServerHostType 来设置上报域名。