Skip to content

test(android): QA 基础设施——CI 上传 debug APK + debug 测试通知入口 - #25

Merged
Qiyuanqiii merged 4 commits into
mainfrom
test/android-qa-infrastructure
Aug 16, 2026
Merged

Qiyuanqiii merged 4 commits into
mainfrom
test/android-qa-infrastructure

Conversation

@Qiyuanqiii

Copy link
Copy Markdown
Member

描述

#16 真机 QA 矩阵的前置基础设施(两个小改动):

  1. CI 上传 debug APK 工件:android job 构建后 upload-artifact(android-debug-apk),可直接下载安装到真机/模拟器,无需本地 Android 构建环境;
  2. debug-only 测试通知入口:设置页「通知」卡片新增「发送测试通知」按钮,仅 BuildConfig.DEBUG 构建显示(release 自动剔除,不进入正式版)。点击即发一条 ¥0.50 样式的低余额通知,用于真机验证通知管线(Channel 创建 / 权限 / monochrome 图标 / 文案 / 点击跳转)——与真实余额无关,无需真实低余额账户(test+docs(android): A4 QA 矩阵执行与 README/MOBILE-PLAN/PR Template 同步 #16 矩阵中「低余额实发」一项的替代验证路径;决策逻辑部分已由 :core 的 16 个 JVM 单测覆盖)。

关联

变更类型

  • ⚙️ CI / 构建脚本
  • 🧪 测试辅助

本地验证

  • 编译由 PR CI 验证(:core:test :app:assembleDebug + 上传工件)

边界检查

  • 未引入任何第三方依赖
  • 未改动平台接口契约
  • 未夹带真实 Token 或凭据(测试通知硬编码 0.5/CNY 为演示数据,无敏感信息)
  • 未提交构建产物(APK 仅作为 CI 工件上传,不进入仓库)
  • 未改变 Token 存储方式(保持 UserDefaults)
  • 注释与文案中文
  • 提交信息符合 Conventional Commits + 中文描述

备注

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

一句话总结

本 PR 为 Android 版添加 QA 基础设施:CI 上传 debug APK 产物,并在设置页新增仅 debug 构建可见的测试通知入口,用于真机验证低余额通知管线。

🔴 红线 / 严重问题

未发现红线违规。 逐条核对:

  • 未引入第三方依赖(actions/upload-artifact@v4 为 GitHub 官方 action,非业务依赖)
  • 未改动 Token 存储方式
  • 未臆造平台接口
  • 未夹带真实凭据
  • 未破坏 CI(改动为增量添加)
  • 未提交构建产物(上传的是 CI 产物,非仓库内提交)

🟡 建议改进

1. android/app/build.gradle.kts:38 — buildConfig 门控范围可更精确

当前 buildConfig = true 会为所有构建类型(debug/release)生成 BuildConfig 类。虽然 BuildConfig.DEBUG 在 release 下为 false,但更推荐按构建类型精确控制:

buildTypes {
    debug {
        buildConfigField("boolean", "QA_TEST_NOTIFICATION", "true")
    }
    release {
        buildConfigField("boolean", "QA_TEST_NOTIFICATION", "false")
    }
}

这样 QA 入口的语义更明确(if (BuildConfig.QA_TEST_NOTIFICATION)),且未来若需在 release 中临时开启 QA 入口,只需改一处配置,无需改代码。

2. android/app/src/main/java/.../SettingsScreen.kt:198 — QA 入口的可见性可考虑更隐蔽

当前 QA 入口直接显示在设置页,普通用户(若安装 debug 包)也能看到。建议考虑:

  • 连续点击版本号 N 次才显示(常见做法)
  • 或至少将文案改为更中性的「开发者选项」而非「QA」

这属于产品决策,供维护者权衡。

🔵 小问题 / 风格

1. android/app/build.gradle.kts:37 — 注释语言不一致

// QA 测试通知入口依赖 BuildConfig.DEBUG 门控(仅 debug 构建显示,release 自动剔除)

仓库规范(AGENTS.md 第 8 节红线 8)要求代码注释用中文,此处已用中文,符合规范。但建议与 Kotlin 代码中其他注释风格保持一致(检查是否使用 /// 或 // 的统一约定)。

2. SettingsScreen.kt:198-209 — QA 入口的 UI 层级可优化

当前 QA 入口直接嵌在通知设置区块内,与真实设置项混在一起。建议:

  • 用 HorizontalDivider 或 Spacer 明确分隔
  • 或将 QA 区块提取为独立 composable 函数(如 QaTestNotificationSection()),保持 SettingsScreen 的可读性

3. CI 上传产物命名可更具体

android-debug-apk 名称较通用,若未来有多个 APK 变体(如 app-arm64-debug.apk),建议命名带上架构或变体信息,如 android-debug-apk-arm64。

审查结论

建议合并。 改动小而聚焦,完全符合 QA 基础设施的定位:

  • CI 上传 debug APK 便于测试人员直接安装验证,无红线风险
  • QA 测试通知入口用 BuildConfig.DEBUG 门控,release 构建自动剔除,不影响生产
  • 注释清晰说明了 QA 入口的目的和边界(不依赖真实低余额账户)

建议维护者考虑上述「建议改进」中的 buildConfig 精确门控方案,但非必须。合并前确认 CI 全绿即可。

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

一句话总结

本 PR 为 Android 版添加 QA 基础设施:CI 上传 debug APK 产物,并在设置页新增仅 debug 构建可见的测试通知入口,用于真机验证低余额通知管线。

🔴 红线 / 严重问题

未发现触碰红线的问题。改动未引入第三方依赖、未涉及 Token 存储、未臆造平台接口、未破坏 CI 验证链。

🟡 建议改进

android/app/build.gradle.kts:38 — buildConfig = true 开启后,BuildConfig.DEBUG 门控生效。建议确认 notifier 变量在 SettingsScreen 作用域内可访问且非空(从 diff 上下文看 notifyLowBalance 已被调用,应无问题)。另外,BuildConfig.DEBUG 在 release 构建中为 false,编译器会做死代码消除,notifyLowBalance 的调用会被剔除,符合注释所述「release 自动剔除」,逻辑正确。

android/app/build.gradle.kts:38 — 注释 // QA 测试通知入口依赖 BuildConfig.DEBUG 门控 放在 buildConfig = true 处稍显突兀,建议改为更通用的说明(如 // 启用 BuildConfig 生成(QA 入口依赖 DEBUG 门控)),避免读者误以为 buildConfig 仅为此功能服务。

🔵 小问题 / 风格

android/app/src/main/java/.../SettingsScreen.kt:202-213 — QA 入口的 UI 文案与代码注释均为中文,符合仓库「代码注释用中文」规范。但 Text 文案较长(约 30 字),在窄屏设备上可能换行,建议确认 bodySmall 样式下显示效果可接受。

android/app/src/main/java/.../SettingsScreen.kt:209 — notifier.notifyLowBalance(0.5, "CNY") 硬编码了余额 0.5 与币种 CNY。建议提取为具名常量(如 TEST_LOW_BALANCE = 0.5)并加注释说明这是模拟值,便于后续维护时理解意图。

CI 配置(.github/workflows/ci.yml:137-141) — actions/upload-artifact@v4 上传 debug APK 后,artifact 默认保留 90 天。若担心存储占用,可考虑添加 retention-days: 7 参数,但非必须。

审查结论

改动小而聚焦,符合仓库规范:未引入依赖、未触碰红线、CI 链完整。QA 测试通知入口用 BuildConfig.DEBUG 门控是标准做法,release 构建自动剔除,无安全隐患。建议合并前确认 notifier 在 SettingsScreen 中可正常访问(从 diff 看应已存在),其余为可选优化项,不影响合入。

@Qiyuanqiii
Qiyuanqiii merged commit d5f4590 into main Aug 16, 2026
5 checks passed
@Qiyuanqiii
Qiyuanqiii deleted the test/android-qa-infrastructure branch August 16, 2026 15:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant