SuperAPI AI 工具集

background-processing

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

本技能用于在 iOS 上注册、调度并执行后台任务,涉及 BackgroundTasks(BGTaskScheduler)、后台 URLSession 与后台推送通知,目标为 Swift 6.3 / iOS 26+。

主要能力与配置:每个任务标识符必须在 Info.plist 的 BGTaskSchedulerPermittedIdentifiers 中声明,否则 submit(_:) 会抛出 BGTaskScheduler.Error.Code.notPermitted;同时按需在 UIBackgroundModes 中启用 fetch、processing、remote-notification。可在 Xcode 中通过 Target > Signing & Capabilities > Background Modes 开启对应模式。

任务类型包括:BGAppRefreshTask(约 30 秒,系统机会触发,轻量更新)、BGProcessingTask(数分钟,设备空闲触发,数据库清理、维护、ML 索引)、BGContinuedProcessingTask(受前台用户操作约束,用于导出大型媒体、生成离线包等)、URLSession.background(进程外管理,大文件下载上传)、静默远程推送(约 30 秒,APNs 触发,需网络)。

核心生命周期规则:在启动完成前注册处理器(UIKit 的 application(_:didFinishLaunchingWithOptions:) 或 SwiftUI 的 App.init()),提交未注册标识符会抛异常;在处理器开头立即调度下一次迭代;始终设置 expirationHandler,在其中取消活动任务并调用 setTaskCompleted(success: false);setTaskCompleted(success:) 必须且只能调用一次;earliestBeginDate 视为下界,实际启动时间由系统根据电量、电源和用户交互决定。

用法路由:注册代码与规范处理器、检查点参见 Canonical Registration and Handlers;用 LLDB 的 _simulateLaunchForTaskWithIdentifier: 模拟启动参见 Debugging Background Tasks;后台下载上传与 handleEventsForBackgroundURLSession 参见 Background URLSession Extended Patterns;推送节流与负载约束参见 Background Push Extended Patterns;符合 ProgressReporting 的持续处理任务参见 BGContinuedProcessingTask Patterns。

常见错误:提交未在允许列表声明的标识符;遗漏 setTaskCompleted(success:);缺少 expirationHandler 导致看门狗终止;以分钟级激进间隔调度刷新;在后台 URLSession 使用 async/await 便捷 API 或完成闭包(需用 delegate)。

审查清单:标识符已声明、所需 UIBackgroundModes 已启用、处理器在启动完成前注册、expirationHandler 取消任务并上报失败、所有路径恰好调用一次 setTaskCompleted、处理器内重新调度后续任务、后台 URLSession 使用 delegate 并保留后台完成处理器、下载文件在 urlSession(_:downloadTask:didFinishDownloadingTo:) 返回前移动、静默推送包含 content-available: 1、apns-push-type: background 和优先级 5。适用场景为需要在应用未前台运行时继续完成刷新、维护、导出与传输的 iOS 应用。限制:实际执行时机与时长由系统决定,无法保证准时;本资料未提供具体工具入口、安装方式、收费与价格信息。