SDK 初始化

最近更新时间:2025-10-17 18:56:51

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

初始化示例代码

通过 Builder 模式分别配置并初始化日志系统(TDLog)和诊断系统(TDDiag),设置日志路径、级别、大小限制等参数以及诊断所需的 AppId、环境、适配器等配置。
// Logger(可选)
TDLogConfig logConfig = new TDLogConfig.Builder(context)
.setLogPath(logPath) // 日志输出目录,需提前获取写权限
.setLogLevel(LogLevel.DEBUG) // 默认VERBOSE
.setConsoleLog(true) // 默认true
.setMaxFileSize(byte) // 默认50M
.setMaxAliveFileSize(byte) // 默认不限制,最小值200M
.setMaxAliveDay(day) // 默认7天, 最小值1天
.setPubKey(pubKey) // 日志加密公钥(可选,联系RumPro小助手提供公私钥给bugly后台进行配置)
.build();
TDLog.initialize(context, logConfig);

// Diagnose
TDDiagConfig diagConfig = new TDDiagConfig.Builder()
.setAppId(appId) // 【重要】在RumPro申请的AppId
.setAppKey(appKey) // 【重要】在RumPro平台申请的AppKey
.setEnvironment(TDDiagConfig.ENV_CLOUD) // 【重要】设置环境(默认OA环境:TDDiagConfig.ENV_NORMAL、专业版需设置为:TDDiagConfig.ENV_PRO,海外版需设置为:TDDiagConfig.ENV_OVERSEAS,腾讯云版需设置为:TDDiagConfig.ENV_CLOUD)
.setLoggerAdapter(TDLog.getLogImpl()) // 业务可自行实现LoggerAdapter来适配自有日志工具
.setDeviceInfoAdapter(deviceInfoAdapter) // 按照隐私合规的要求,注入隐私信息(可选,默认从android.os.Build读取)
.setAppVersion("1.0.0") // 自定义app版本(可选,默认从PackageInfo读取)
.setTrafficQuota(total, metered) // 设置每日流量配额(可选,默认不限制,建议设置)
.setUploadCountLimit(limit, period, timeUnit) // 设置自动上报频率限制(可选,默认不限制,建议设置)
.setImportantLabels(...label) // 设置标签白名单(设置不受TrafficQuota和UploadCountLimit限制的标签)
.build();
TDDiag.initialize(context, config);
初始化完成后即可进行日志打印。
TDLog.i("tag", "xxxxxx");
TDLog.e("tag", "xxxxxx", e);
TDLog 和 TDDiag 的更多用法,请参见 API 说明 部分。

设置设备唯一 ID

在 Android 日志 SDK 中,userId 是用于捞日志和染色的标识(由于历史原因命名为 userId),建议使用设备唯一 ID,可在初始化后同步调用并传入,也可在 App 获取到唯一标识后异步调用传入。
TDDiag.setUserId("uid");