Apps Kit SDK logoApps Kit SDK
文档 · 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 在内部读取。