Skip to content

deps(android): 引入 androidx.work 依赖准入并翻转 MOBILE-PLAN D6 决策 #11

Closed

Description

@Qiyuanqiii

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 等一律不引入)

非目标

Activity

  1. Qiyuanqiii commented on Aug 16, 2026

    @Qiyuanqiii
    MemberAuthor

    PR 已提交:#18(docs(android): WorkManager 依赖准入——翻转 MOBILE-PLAN D6 决策并更新红线 11)。改动仅两个文档:MOBILE-PLAN.md(D6 → 已决策 WorkManager,含翻转理由与选型表「刷新」行同步)+ AGENTS.md(红线 11 清单补充 WorkManager 及准入说明)。待 review 合并后即解除 #15 的第一项阻塞。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    androidAndroid 平台相关

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions