鸿蒙 HarmonyOS 7 系列(第4讲)后台计算任务的生命周期分层与断点续跑
前台跑一个十几分钟的转码或批处理任务,用户切到后台等,回来发现进度停在 40%,日志写着进程被系统冻结,原因是后台超时。 第一反应是“TaskPool 不可靠”,但 TaskPool 的定位从来就不是让进程在后台活下去,它只负责把任务从 UI 主线程挪到子线程。后台能不能继续跑,是另一层的事。
这一讲把后台计算任务的工程结构拆成三层:任务类型的合规匹配、进程存活手段、状态持久化。三层里任何一层缺位,用户看到的就是“切后台就断”。

先匹配类型,再谈保活
没有申请对应长时任务类型的后台任务,系统在超时后挂起或冻结进程,TaskPool 里的线程随之停止。但长时任务不是“申请了就保活”的万能开关,必须和官方支持的类型匹配。泛计算任务需要 ohos.permission.KEEP_BACKGROUND_RUNNING_SYSTEM 这类 ACL 权限;特定媒体处理场景在 API 22+ 可以评估 specialScenarioProcessing 等对应类型。
匹配不上的时候,正确的结论不是“想办法绕过去”,而是这个任务本来就不应该在后台跑。合规边界不是技术障碍,是设计前提。 把不该后台执行的计算塞进保活通道,短期看是“跑通了”,长期看是在透支应用的受管控信用。
typescript
import { backgroundTaskManager } from '@kit.BackgroundTasksKit'
import { wantAgent } from '@kit.AbilityKit'
async function startLongRunning(context: common.UIAbilityContext): Promise<void> {
const info: backgroundTaskManager.ContinuousTaskInfo = {
bundleName: 'com.example.batch',
abilityName: 'BatchAbility'
}
const agent = await wantAgent.getWantAgent({
wants: [{ bundleName: info.bundleName, abilityName: info.abilityName }],
actionType: wantAgent.OperationType.START_ABILITY,
requestCode: 0
})
await backgroundTaskManager.startBackgroundRunning(
context,
backgroundTaskManager.BackgroundMode.DATA_TRANSFER,
agent
)
}
BackgroundMode 必须和实际业务语义一致,不要为了“能跑”选一个不匹配的模式。执行结果上,申请成功后进程被冻结的概率降低,但不等于零。startBackgroundRunning 的失败回调要接住,权限不足或类型不匹配时它不会替你兜底。
断点恢复不是可选项
长时任务降低冻结概率,但没有消除进程被回收的绝对可能。正确的工程假设是“进程随时可能没”,所以任务必须拆成可恢复的片段。输入文件先进应用沙箱,进度、阶段号、输出临时路径定期写入数据库或文件。回到前台后检查未完成任务,从最后一个持久化点继续,而不是从头再来。
typescript
interface Checkpoint {
taskId: string
stage: number
progress: number
tempPath: string
updatedAt: number
}
async function saveCheckpoint(cp: Checkpoint): Promise<void> {
await kvStore.put(cp.taskId, JSON.stringify(cp))
}
async function resumeIfNeeded(taskId: string): Promise<Checkpoint | null> {
const raw = await kvStore.get(taskId)
if (!raw) return null
return JSON.parse(raw as string) as Checkpoint
}
写入频率不需要每一帧都落,但阶段切换和进度跨过关键阈值时必须落。常见错误是把进度只保存在内存变量里,进程一冻全丢;或者把检查点写到临时缓存目录,系统清理时一并带走。检查点要落在应用自己的持久化路径里,生命周期由你控制。
进度回调不能假设 UI 线程还活着
task.on('progress') 的回调运行在宿主线程,通常是 UI 线程。应用退到后台后,UI 线程调度优先级下降,回调可能被延迟甚至跳过。如果进度记录依赖这个回调把值传回主线程再写盘,后台阶段的数据会断档。
可靠的做法是在 @Concurrent 函数内部直接写日志或数据库,不依赖回调转手。UI 前台的进度展示可以用回调,但持久化的事实来源必须在工作线程侧闭环。
typescript
@Concurrent
function processChunk(payload: string): string {
const result = heavyCompute(payload)
persistProgressDirectly(result) // 在工作线程里直接落盘
return result
}
@Concurrent 函数运行在 TaskPool 线程,不能捕获 UI 侧的闭包变量,输入输出必须通过参数和返回值传递。persistProgressDirectly 需要是线程安全的写入方式,不要在里面操作 UI 状态或依赖主线程才能访问的对象。
后台任务的正确心态不是“让 TaskPool 永不被冻结”,而是“无论冻不冻结,任务都能从断点继续”。类型匹配决定了能不能跑,断点恢复决定了断了之后能不能接上,线程侧落盘决定了进度记录不会因为 UI 调度而降级。三层都做到位,用户切后台再回来,看到的是从 40% 继续走到 80%,而不是从零开始。
更多推荐

所有评论(0)