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