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

10. 内置配置面板 / 测试套件

AKS 内置了一个基于 Compose 的诊断界面,无需单独的调试构建版本,也无需在清单文件中添加声明;它会以全屏对话框的形式显示在调用它的 Activity 上方。你可以用它查看 AKS 当前识别到的状态(远程配置、广告状态、用户同意状态),而无需连接调试器。

打开方式

只要持有 Activity 引用,就可以调用以下代码。你可以将入口设为应用设置页面中的隐藏项、长按应用版本号、仅在调试模式下显示的按钮,或自行实现的其他触发方式(AKS 不会自动添加入口):

kotlin
AppsKitSDK.showGodModeScreen(PlatformActivity(this))

这会打开 AKS 配置面板(AKS Configuration Dashboard),你可以在其中查看:

  • 启用广告(Enable Ads) — 一个开关;以及 GDPR 状态(GDPR Status) — 只读的 TRUE/FALSE 值,反映 AdsManager.isUserConsentsProvided() 的返回结果。
  • 检查配置(Check Configurations) — 打开测试套件(见下文)。
  • 广告占位符调用记录(Placeholder Calls) — 按广告占位符展示的广告调用记录,以格式化的 JSON 显示。
  • 广告占位符加载统计(Placeholder Load Stats) — 各广告占位符的加载尝试次数、成功次数和失败次数。
  • AKS 日志(AKS Logs) — 与 Logcat 中可查看的累计日志历史相同(参见 §11),支持在界面中搜索。

测试套件

点击 检查配置(Check Configurations) 即可打开测试套件界面,其中会显示:测试模式 / 开发模式标志、当前生效的是默认(离线)配置还是已拉取的远程配置、AKS SDK 版本、AKS 拉取到的原始远程配置 JSON、插屏广告、激励广告和开屏广告的实时状态及上次展示时间,以及当前的会话计数和天数计数。

你也可以跳过配置面板,直接打开测试套件:

kotlin
AppsKitSDK.showAKSTestSuit(PlatformActivity(activity))

这两个调用都只需要一个 PlatformActivity;其余信息(广告状态、配置、会话数据)均由 AKS 在内部读取。