Apps Kit SDK logoApps Kit SDK
文档 · AppsKitSDK (AKS) — Android 集成指南

11. 使用 AKS 日志(PTB_LOG)调试

AKS 生成的每条日志——无论来自 AKSLogManager/AppsKitSDKLogManager 调用、广告加载/展示事件,还是 SDK 内部活动——都会同时写入两个位置:按类别标记的 Logcat,以及为 §10 中的 AKS Logs 界面提供数据的内存日志缓冲区。

过滤 Logcat 日志

在 Android Studio 的 Logcat 中按标签过滤(tag:PTB_LOG),或通过 adb 过滤:

bash
adb logcat -s PTB_LOG:* PTB_LOG_ADS:* PTB_LOG_ANALYTICS:*
  • PTB_LOG — SDK 通用日志(初始化流程、运行模式提示、生命周期、错误)
  • PTB_LOG_ADS — 各种广告格式的加载/展示生命周期日志
  • PTB_LOG_ANALYTICS — 发送到 Firebase/MMP 的事件,包括 §7 中的每次 sendAKSEvent/AKSLogManager.log 调用

不使用 Logcat 查看日志

如果你正在调试发布版本、测试人员的设备,或处理无法通过 adb 连接设备的支持工单,可以改为打开测试套件中的 AKS Logs 界面(§10)。该界面会在设备上显示完全相同的日志内容,并提供搜索功能,方便测试人员直接滚动查看、搜索,或将截图发给你。

怀疑版本不匹配时,调用 AppsKitSDKLogManager.logAarVersion()(参见 §7.3)是确认实际集成的 AKS AAR 版本的最快方法——它会将版本信息输出到 PTB_LOG。