用途:在 iOS 上注册、调度并执行后台工作,覆盖 BackgroundTasks 框架、后台 URLSession 与后台推送通知三类机制。
主要能力:
- Info.plist 配置:任务标识符须列入 BGTaskSchedulerPermittedIdentifiers,否则 submit(_:) 抛 notPermitted;并启用 UIBackgroundModes 的 fetch 与 processing。
- BGTaskScheduler 注册:须在应用启动完成前注册,UIKit 在 application(_:didFinishLaunchingWithOptions:),SwiftUI 在 App.init()。
- BGAppRefreshTask:约 30 秒的短任务,用于拉取小量数据更新;earliestBeginDate 仅为下限提示,实际启动由系统决定。
- BGProcessingTask:分钟级长任务,用于维护、数据处理或清理,可在设备空闲时运行并可要求外接电源。
- BGContinuedProcessingTask(iOS 26.0+、iPadOS 26.0+):由前台用户操作发起并延续到后台,通过 Live Activity 显示进度,遵循 ProgressReporting;可设置 strategy 为 .queue 或 .fail,GPU 工作需检查 BGTaskScheduler.supportedResources 并启用后台 GPU 访问。
- 后台 URLSession:使用 URLSessionConfiguration.background,应用挂起或终止后仍继续传输,须用 delegate 而非 async/闭包,并在 didFinishDownloadingTo 返回前移动文件。
- 后台推送:payload 设 content-available: 1,APNs 请求用 apns-push-type: background 与 apns-priority: 5,低优先级且不保证送达,建议每小时不超过两三次。
必要用法:每个成功、失败与取消路径都须调用 setTaskCompleted(success:) 且仅一次;设置 expirationHandler 取消进行中的工作;在处理器内重新调度下一次任务;工作应可增量执行且可取消(Task.checkCancellation());避免阻塞式同步工作。
限制:后台执行时机由系统决定,earliestBeginDate 只是下限;不能假设后台时间足够完成长操作;后台推送不保证送达。资料另附常见错误与审查清单,并指向 references/background-task-patterns.md 获取扩展模式与调试方法。