SuperAPI AI 工具集

background-processing

编程与开发

查看项目

更新于 10-15 21:12

技能介绍

用途:在 iOS 上注册、调度并执行后台工作,覆盖 BackgroundTasks 框架、后台 URLSession 与后台推送通知三类机制。

主要能力:

  1. Info.plist 配置:任务标识符须列入 BGTaskSchedulerPermittedIdentifiers,否则 submit(_:) 抛 notPermitted;并启用 UIBackgroundModes 的 fetch 与 processing。
  2. BGTaskScheduler 注册:须在应用启动完成前注册,UIKit 在 application(_:didFinishLaunchingWithOptions:),SwiftUI 在 App.init()。
  3. BGAppRefreshTask:约 30 秒的短任务,用于拉取小量数据更新;earliestBeginDate 仅为下限提示,实际启动由系统决定。
  4. BGProcessingTask:分钟级长任务,用于维护、数据处理或清理,可在设备空闲时运行并可要求外接电源。
  5. BGContinuedProcessingTask(iOS 26.0+、iPadOS 26.0+):由前台用户操作发起并延续到后台,通过 Live Activity 显示进度,遵循 ProgressReporting;可设置 strategy 为 .queue 或 .fail,GPU 工作需检查 BGTaskScheduler.supportedResources 并启用后台 GPU 访问。
  6. 后台 URLSession:使用 URLSessionConfiguration.background,应用挂起或终止后仍继续传输,须用 delegate 而非 async/闭包,并在 didFinishDownloadingTo 返回前移动文件。
  7. 后台推送:payload 设 content-available: 1,APNs 请求用 apns-push-type: background 与 apns-priority: 5,低优先级且不保证送达,建议每小时不超过两三次。

必要用法:每个成功、失败与取消路径都须调用 setTaskCompleted(success:) 且仅一次;设置 expirationHandler 取消进行中的工作;在处理器内重新调度下一次任务;工作应可增量执行且可取消(Task.checkCancellation());避免阻塞式同步工作。

限制:后台执行时机由系统决定,earliestBeginDate 只是下限;不能假设后台时间足够完成长操作;后台推送不保证送达。资料另附常见错误与审查清单,并指向 references/background-task-patterns.md 获取扩展模式与调试方法。