 laoyang
|
2b29f197e8
|
后台同步重构：移除不合规长时任务，改为分层调度
背景：用户反馈"后台常驻其实没实现，过一段时间常驻通知就没了"。调研确认这是
系统强制管控、不是 bug：DATA_TRANSFER 长时任务有一致性校验，**超 10 分钟未更新
传输进度即被强制取消**。日历同步是"间歇跑、平时无进度"，不符合该语义 → 必被取消，
且频繁触发校验失败可能被列入管控名单。另：workScheduler 请求 20 分钟低于系统
"应用活跃分组"下限（活跃≥2h），被静默压制 → 名义 20 分钟实际从未生效。
改为分层调度（目标：用户要看时数据一定最新，而非追求进程常驻）：
1. **移除 dataTransfer 长时任务**：BackgroundSyncService 不再申请；
module.json5 去掉 backgroundModes 与 ohos.permission.KEEP_BACKGROUND_RUNNING
2. **延迟任务周期 20 分钟 → 2 小时**（对齐系统下限，避免被压制）；保留 isRepeat/isPersisted
3. **新增 BackgroundSyncRunner**：后台同步唯一执行体（抽取自 SyncWorkAbility），
供延迟任务/网络恢复/回到前台三处共用，避免逻辑漂移
4. **新增 NetworkSyncWatcher**：net.connection 监听，**从无网恢复到有网时立即补同步**
（带 20s 去抖；仅在 netLost→netAvailable 时触发，单纯切网不重复同步）
5. **回到前台补同步**：UIAbility.onForeground 立即同步 + 取消短时任务归还配额
6. **退后台短时任务**：onBackground 用 requestSuspendDelay 兜住退后台那次同步；
回到前台 cancelSuspendDelay（配额仅 10 分钟/日，必须归还）
7. **设置页开关语义调整**："后台持续同步（常驻通知）" → "后台自动同步"，
文案如实说明"系统最短约 2 小时一次 + 回前台/网络恢复立即补同步"；
开关现在真正控制延迟任务的注册/取消
8. **官网文档同步**：sf/uh 改写后台同步说明；upa **移除 KEEP_BACKGROUND_RUNNING 权限行**
（权限表必须与实际声明一致）；已重建 404 并部署线上
注：applyEfficiencyResources 在当前 SDK 不可用，未采用。
|
2026-10-10 12:49:11 +08:00 |
|