文档 · Android 集成
10. 内置配置面板 / 测试套件
AKS 内置了一个基于 Compose 的诊断界面,无需单独的调试构建版本,也无需在清单文件中声明;它会以全屏对话框的形式显示在发起调用的 Activity 之上。无需连接调试器,即可查看 AKS 内部的运行状态(远程配置、广告状态、用户同意状态)。
打开方式
只要持有 Activity 引用,就可以调用以下方法。你可以自行设置触发入口,例如设置页面中的隐藏选项、长按应用版本号,或仅在调试时显示的按钮(AKS 不会自动添加触发入口):
kotlin
AppsKitSDK.showGodModeScreen(PlatformActivity(this))调用后会打开 AKS 配置面板,你可以在其中查看:
- 启用广告 — 一个开关;以及 GDPR 状态 — 只读的
TRUE/FALSE值,反映AdsManager.isUserConsentsProvided()的返回结果。 - 检查配置 — 打开测试套件(见下文)。
- 广告占位符调用记录 — 以格式化 JSON 展示各广告占位符的广告调用记录。
- 广告占位符加载统计 — 各广告占位符的加载尝试次数、成功次数和失败次数。
- AKS 日志 — 与 Logcat 中相同的累计日志记录(参见 §11),支持在界面中搜索。
测试套件
点击 检查配置 即可打开测试套件界面,其中会显示:测试模式 / 开发模式标志、当前生效的是默认(离线)配置还是已拉取的远程配置、AKS SDK 版本、AKS 拉取到的原始远程配置 JSON,以及插屏广告、激励广告和开屏广告的实时状态与上次展示时间,此外还有当前会话计数和天数计数。
你也可以跳过配置面板,直接打开测试套件:
kotlin
AppsKitSDK.showAKSTestSuit(PlatformActivity(activity))这两个调用都只需要传入一个 PlatformActivity,其余信息(广告状态、配置、会话数据)均由 AKS 在内部读取。