Repository navigation
test(android): QA 基础设施——CI 上传 debug APK + debug 测试通知入口 - #25
Conversation
There was a problem hiding this comment.
一句话总结
本 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 全绿即可。
There was a problem hiding this comment.
一句话总结
本 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 看应已存在),其余为可选优化项,不影响合入。
描述
#16 真机 QA 矩阵的前置基础设施(两个小改动):
upload-artifact(android-debug-apk),可直接下载安装到真机/模拟器,无需本地 Android 构建环境;BuildConfig.DEBUG构建显示(release 自动剔除,不进入正式版)。点击即发一条 ¥0.50 样式的低余额通知,用于真机验证通知管线(Channel 创建 / 权限 / monochrome 图标 / 文案 / 点击跳转)——与真实余额无关,无需真实低余额账户(test+docs(android): A4 QA 矩阵执行与 README/MOBILE-PLAN/PR Template 同步 #16 矩阵中「低余额实发」一项的替代验证路径;决策逻辑部分已由 :core 的 16 个 JVM 单测覆盖)。关联
变更类型
本地验证
边界检查
备注