[Android] 完成 FCM 深度 Doze 真机验收

[Qjzn]

背景

2.4.1 已包含可选的 Android FCM 深度 Doze 唤醒路径，但默认 Release 不绑定项目专属 Firebase 配置，也没有完成真实设备锁屏/深度休眠证据。因此当前只能声明前台服务、SSE、有限轮询、网络恢复和手动刷新可用，不能声明深度 Doze 实时通知已稳定。

验收环境

• 与 com.cxcodex.bridge 匹配的 Firebase Android 项目。
• Android APK 使用匹配的 google-services.json 构建。
• 7420 主机使用外部服务账号凭据，凭据不进入仓库和日志。
• 至少一台真实 Android 设备，可执行锁屏、Doze、断网/恢复和进程回收测试。

验收标准

• npm run verify:mobile-push-readiness -- --require-ready 通过。
• 设备注册与任务订阅成功，API 和日志不输出完整 device token。
• 非订阅任务完成时不会误唤醒设备。
• 订阅任务在锁屏与深度 Doze 下完成后能收到高优先级通知。
• 记录任务终态、FCM 接收、权威快照、通知展示和设备确认时间。
• 设备确认后 pendingDeliveryCount 与 awaitingDeviceAckCount 回到零。
• 断网、Token 轮换、应用升级和服务重启均有恢复记录。
• 结果以脱敏日志和设备/系统版本矩阵写入公开测试文档。

[Qjzn]

v2.7.5 状态更新

v2.7.5 已改善 Android 前后台与 WebView 恢复：按证据执行延迟重试，探测渲染器存活，无响应/低内存回收时恢复当前安全路由，真实渲染崩溃时回到服务入口，并保持默认渲染器优先级。相关 JVM 策略测试、Android lint、Release 构建、签名和前端 36 场景已通过。

这 不等于 FCM 深度 Doze 真机验收完成，因此本议题继续开放。仍需在已配置 Firebase 的正式包和真实设备上记录：

• 锁屏并进入深度 Doze 后，任务完成通知的到达时间与事件序号；
• 进程存活、进程被回收、断网重连三类场景；
• token 轮换/升级后的重新注册和服务端 ACK；
• 点击通知后进入准确会话，且不重复提醒、不丢消息；
• 对照电池优化允许/不允许两种系统设置。

验收材料需要设备/Android 版本、操作步骤、脱敏日志与结果，不提交 Firebase 私钥或用户访问密码。

[Qjzn]

维护状态更新（2026-08-27）：本轮隔离候选已通过 mobile:android:sync、lintDebug 和 assembleDebug（222 tasks），说明当前 Android 源码和构建链路可用；这些证据仍不能替代本 Issue 要求的 FCM 配置、签名 APK 和实体设备 Deep Doze/通知 ACK 验收。

因此该 Issue 保持开放，已归入 v2.8.0 里程碑并标记 needs-device。在 Firebase 项目、服务端 FCM 凭据和 Android 真机就绪前，不关闭、不宣称 2.8.0 真机门禁完成。

[Qjzn]

2026-08-28 候选门禁复核（origin/beta 09325a7）

本轮在与 origin/beta Git tree 完全一致的隔离工作树复核：

• npm run verify:mobile-push-readiness:test：通过。
• npm run mobile:android:sync：通过。
• gradlew testDebugUnitTest lintDebug assembleDebug：通过（234 个任务，lint 无新增问题，debug APK 构建成功）。
• npm run verify:mobile-push-readiness：7420 可达，但 configurationReady=false、deviceRegistrationReady=false、activeSubscriptionReady=false。
• npm run test:android:background：在第一道设备门禁按设计失败；adb devices -l 当前为 0 台已授权设备。

当前仍需外部资源，不能由代码测试代替：

1. 对包名 com.cxcodex.bridge 的 google-services.json；
2. 同一 Firebase 项目的服务账号，通过 GOOGLE_APPLICATION_CREDENTIALS 提供给 7420；
3. 一台已授权 Android 真机；
4. 真机上完成进程回收、锁屏、Deep Doze、网络切换、通知点击/去重、终态设备 ACK 与回复渲染时延矩阵。

因此 Issue 继续保持 needs-device，本轮没有把编译/静态测试冒充真机验收。

[Qjzn]

2026-08-28 Android 16 真机调试进展

目标设备：OPPO PKH110，Android 16 / SDK 36，2248×2480。ADB 为唯一已授权设备。

已完成并通过：

• 用正式签名将手机从 2.7.6 保留数据升级到候选 2.8.0；候选证书 SHA-256 与已装正式包一致，安装后主界面、服务器地址和当前活动任务恢复。
• 20 秒前台观察：活动任务唯一、事件流 connected、服务未重建、权威快照继续推进。
• 15 秒锁屏恢复：进程与任务保留，恢复后快照继续推进。
• 15 秒强制 Deep Doze：任务未丢、服务未重建，退出后 mForceIdle=false、设备恢复 ACTIVE、USB 供电状态恢复。
• 进程回收：force-stop 后进程确实消失；重新打开约 3.25 秒进程恢复，8 秒后同一活动任务恢复，未清数据。
• 网络切换：原状态 Wi-Fi off / mobile data on；断网后出现预期轮询失败，恢复后 network recovery +1、event stream 回到 connected、连续失败归零，网络设置恢复原值。
• Home/返回：后台 10 秒进程不变，恢复后任务、事件流和失败计数正常。
• 7420 图片 roundtrip：带测试图片，同一 clientMessageId 并发发送两次只执行一次；pending_start → running → completed，精确回复，18.17 秒，临时线程已归档。
• 全程没有 FATAL EXCEPTION 或该包 ANR 标记；升级后页面无空白、错误页或重复消息。

仍未通过、不得宣称完成：

• 候选未包含 google-services.json，7420 没有 Firebase 服务账号；readiness 为 configurationReady=false，设备注册 0、活跃订阅 0。
• 因此“应用进程被系统彻底回收后由 FCM 唤醒、终态通知、设备 ACK”没有真实覆盖。
• 悬浮窗 SYSTEM_ALERT_WINDOW 当前为 default/rejected；主界面正常，但原生悬浮任务宠物不会显示回复渲染。是否授予该高权限应由设备用户手动决定。
• 一次由桌面 roundtrip 发起的终态通知探针被脚本正确判为未覆盖：该线程未从手机发送，原生层没有订阅，不能作为通知失败或成功证据。

Issue 继续保留 needs-device，下一步只剩同一 Firebase 项目的 Android 配置、服务账号、重新签名构建，以及手机端真实发送任务后的 FCM/通知/ACK 矩阵。