文档 · 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。