Parent: #17 ## 背景 仓库治理要求(AGENTS.md 红线 1 与 CONTRIBUTING.md):「新增依赖需先开 Issue 讨论」。本 Issue 即 WorkManager 的准入讨论,并请求翻转 `MOBILE-PLAN.md` 尚未决策的决策点 D6。 D6 当前文本: > D6 | Android 后台刷新 | 倾向 AlarmManager(零依赖);如需系统级节电调度再上 WorkManager(androidx 官方) ## 决策建议:WorkManager 1. **场景匹配**:后台刷新是 Best Effort 周期余额检查,不是精确定时任务——正是 WorkManager 的适用场景;AlarmManager 的精确闹钟在此是错配,且 API 31+ 精确闹钟需 `SCHEDULE_EXACT_ALARM` 权限与用户豁免,语义上不该为此申请。 2. **系统集成**:原生网络约束(`NetworkType.CONNECTED`)、Doze/电池友好、进程与重启后任务保留。 3. **唯一任务**:`enqueueUniquePeriodicWork` + `ExistingPeriodicWorkPolicy.UPDATE`(work-runtime ≥ 2.8.0;官方已废弃 REPLACE,UPDATE 不取消运行中 worker、保持原排队时间)保证多次进入设置页不会注册多个后台 Worker。 4. **红线兼容**:移动端红线 11 已有先例——Compose / Material3 等 Google 官方工具链不视为第三方业务依赖;androidx.work 同属平台官方工具,且只进 `:app` 层,`:core` 保持零 AndroidX 依赖。 5. **成本对比**:AlarmManager 需自行处理 Doze、重启恢复、权限分支,实现与维护成本反而更高。 ## 本 Issue 的交付(docs-only PR) - `MOBILE-PLAN.md`:D6 更新为「已决策:WorkManager(androidx.work ≥ 2.8.0;Unique Periodic Work + UPDATE;NetworkType.CONNECTED;周期 ≥ 15 分钟)」并附翻转理由 - `AGENTS.md` 红线 11 示例清单:在 Compose / HttpURLConnection 旁补充 WorkManager ## 验收条件 - [ ] D6 文本已按上述决策更新并合并 - [ ] 红线 11 示例清单包含 WorkManager - [ ] 除 androidx.work 外不引入任何其他新依赖(Robolectric / Ktor / Room 等一律不引入) ## 非目标 - ❌ 不在本 Issue 写任何 Worker / 通知代码(见 #15)
Activity
Qiyuanqiii commentedon Aug 16, 2026
PR 已提交:#18(docs(android): WorkManager 依赖准入——翻转 MOBILE-PLAN D6 决策并更新红线 11)。改动仅两个文档:
MOBILE-PLAN.md(D6 → 已决策 WorkManager,含翻转理由与选型表「刷新」行同步)+AGENTS.md(红线 11 清单补充 WorkManager 及准入说明)。待 review 合并后即解除 #15 的第一项阻塞。