# 后台处理 ## 概述后台执行是一种**特权**，而不是权利。 iOS 主动限制后台工作以保护电池寿命和用户体验。 **核心原则**：将后台任务视为可自由支配的工作 - 您请求一个时间窗口，系统决定何时（或是否）运行您的代码。 **关键见解**：大多数“我的任务从未运行”问题源于注册错误或误解管理执行的 7 个调度因素。这项技能提供了系统的调试，而不是猜测。 **能量优化**：为了减少后台任务对电池的影响，请参阅`axiom-energy`技能。该技能侧重于任务**机制**——使任务正确运行并可靠地完成。 **要求**：iOS 13+ (BGTaskScheduler)、iOS 26+ (BGContinuedProcessingTask)、Xcode 15+ ## 提示示例开发人员提出的实际问题，该技能可以回答： #### 1\. “我的后台任务从未运行。我注册它，安排它，但什么也没有发生。” → 该技能涵盖了“任务从未运行”问题的注册清单和调试决策树 #### 2\. “我如何测试后台任务？它们似乎不会在模拟器中触发。” → 技能涵盖 LLDB 调试命令和模拟器限制 #### 3\. “我的任务在完成之前就被终止了。我如何延长时间？” → 该技能涵盖任务类型（BGAppRefresh 30 秒与 BGProcessing 分钟）、过期处理程序和增量进度保存 #### 4\. “我应该使用 BGAppRefreshTask 还是 BGProcessingTask？有什么区别？” → 该技能提供决策树，用于根据工作持续时间和系统要求选择正确的任务类型 #### 5\. “如何将 Swift 6 并发性与后台任务过期集成？” → 该技能涵盖了用于将 BGTask 过期桥接到结构化并发的 withTaskCancellationHandler 模式 #### 6\。 “我的后台任务适用于开发，但不适用于生产。” → 技能涵盖7个调度因素、节流行为和生产调试 ** ** ## 危险信号 - 任务无法运行或终止如果您看到其中任何一个，则怀疑存在注册或日程安排问题： * **任务永远不会运行** ：尽管“submit()”成功，但处理程序从未被调用 * **任务立即终止**：处理程序已调用但工作未完成 * **在开发中工作，而不是在生产中**：任务使用调试器运行，但不在发布版本中运行 * **控制台显示没有启动**：统一日志记录中没有“BackgroundTask”条目 * **标识符不匹配错误**：任务标识符与 Info.plist 不匹配 * **“没有注册处理程序”** ：首次调度之前未注册处理程序 #### 与能源问题的区别 * **能量问题**：任务运行但耗尽电池（参见“公理能量”技能） * **此技能**：任务未运行，或在完成工作之前终止 ** ** ## 强制性的第一步 **在调试代码之前始终验证这些**： ### 第 1 步：验证 Info.plist 配置（2 分钟） BGTaskSchedulerPermissionIdentifiers <数组> <字符串>com.yourapp.refresh <字符串>com.yourapp.processing UIBackgroundModes <数组> <字符串>获取 <数组> <字符串>获取 <字符串>处理 **常见错误**：代码中的标识符与 Info.plist 不完全匹配。检查拼写错误、区分大小写。 ### 第 2 步：验证注册时间（2 分钟）注册必须在应用程序完成启动之前进行： // ✅ 正确：在 didFinishLaunchingWithOptions 中注册功能应用程序（_应用程序：UIApplication， didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { BGTaskScheduler.shared.register( forTaskWithIdentifier: "com.yourapp.refresh", 使用：无 ) { 任务在 // 安全强制转换：标识符保证 BGAppRefreshTask 类型 self.handleAppRefresh（任务：任务为！BGAppRefreshTask） } return true // 返回之前注册 } // ❌ 错误：启动后或按需注册 func someButtonTapped() { // 太晚了 - 注册不起作用 BGTaskScheduler.shared.register(...) } **例外**：BGContinuedProcessingTask (iOS 26+) 在用户启动操作时使用动态注册。 ### 步骤 3：检查控制台日志（5 分钟）过滤 Console.app 的后台任务事件：子系统：com.apple.backgroundtaskscheduler 寻找： *“为具有标识符的任务注册处理程序” *“带标识符的调度任务” *“使用标识符启动任务” *“任务已完成，带有标识符” * 关于缺少处理程序或标识符的错误消息 ### 第 4 步：验证应用程序未被刷走（1 分钟） **关键**：如果用户从应用程序切换器强制退出应用程序，则不会运行任何后台任务。检查应用程序切换器：您的应用程序仍然可见吗？滑动 = 无后台执行，直到用户再次启动。 ** ** ## 后台任务决策树需要在后台运行代码吗？ │ ├─ 用户明确发起了操作（点击按钮）？ │ ├─ iOS 26+？ → BGContinuedProcessingTask（模式 4） │ └─ iOS 13-25？ → 开始后台任务+保存进度（模式5） │ ├─ 保持内容全天新鲜？ │ ├─ 所需运行时间≤ 30 秒？ → BGAppRefreshTask（模式 1） │ └─ 需要几分钟？ → 带约束的 BGProcessingTask（模式 2） │ ├─ 可推迟的维护工作（数据库清理、机器学习培训）？ │ └─ 需要ExternalPower的BGProcessingTask（模式2） │ ├─ 大量下载/上传？ │ └─ 后台URLSession（模式6） │ ├─ 服务器数据变化触发？ │ └─ 静默推送通知 → 获取数据 → 完成处理程序（模式 7） │ └─ 简短的关键工作当应用程序背景？ └─ beginBackgroundTask（模式5） ### 任务类型比较类型 |运行时 |何时运行 |使用案例 ---|---|---|--- BGAppRefreshTask | BGAppRefreshTask约 30 秒 |基于用户应用程序使用模式 |获取最新内容 BG处理任务|几分钟 |设备充电，闲置（通常整夜）|维护、机器学习培训 BG继续处理任务|扩展|系统管理的进度 UI |用户发起的导出/发布开始背景任务 |约 30 秒 |立即进入后台 |保存状态，完成上传后台 URLSession |根据需要|系统友好时间，即使在终止后也是如此大额转账 ** ** ## 常见模式 ### 模式 1：BGAppRefreshTask — 保持内容新鲜 **使用时间**：您需要获取新内容，以便用户打开应用程序时感觉新鲜。 **运行时间**：约 30 秒 **系统运行时**：根据用户的应用程序使用模式进行预测。如果用户每天早上打开应用程序，系统会在此之前学习并刷新。 #### 注册（应用程序启动时）功能应用程序（_应用程序：UIApplication， didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { BGTaskScheduler.shared.register( forTaskWithIdentifier: "com.yourapp.refresh", 使用：无 ) { 任务在 self.handleAppRefresh（任务：任务为！BGAppRefreshTask） } 返回真 } #### 调度（当应用程序背景时） func ScheduleAppRefresh() { 让请求= BGAppRefreshTaskRequest（标识符：“com.yourapp.refresh”） // 最早开始日期 = 最小延迟，不是确切时间 // 根据使用模式，系统可能会在数小时后运行 request.earliestBeginDate = Date(timeIntervalSinceNow: 15 * 60) // 至少 15 分钟做{ 尝试 BGTaskScheduler.shared.submit(request) } 抓住 { print("未能安排刷新：\(错误)") } } // 当应用程序进入后台时调用 func applicationDidEnterBackground(_ application: UIApplication) { 调度应用程序刷新() } // 或者使用 SceneDelegate / SwiftUI .onChange(of: scenePhase) { newPhase 中如果 newPhase == .background { 调度应用程序刷新() } } #### 处理程序 func handleAppRefresh(任务: BGAppRefreshTask) { // 1. 立即设置过期处理程序 task.expirationHandler = { [弱自我] in // 取消任何正在进行的工作 self?.currentOperation?.cancel() } // 2. 安排下一次刷新（连续刷新模式）调度应用程序刷新() // 3. 做工作 fetchLatestContent { [弱自我] 结果切换结果{ 案例.成功：任务.setTaskCompleted（成功：true）案例.失败：任务.setTaskCompleted(成功: false) } } } **要点**： * 首先设置过期处理程序 * 在处理程序中安排下一次刷新（连续模式） * 在所有代码路径中调用`setTaskCompleted`（成功和失败） * 将工作时间控制在 30 秒以内 ** ** ### 模式 2：BGProcessingTask — 可推迟维护 **使用时间**：可以等待最佳系统条件（充电、WiFi、空闲）的维护工作。 **运行时间**：几分钟 **当系统运行时**：通常在设备充电时过夜。可能不会每天运行。 #### 注册 BGTaskScheduler.shared.register( forTaskWithIdentifier: "com.yourapp.maintenance", 使用：无 ) { 任务在 self.handleMaintenance（任务：任务为！BGProcessingTask） } #### 有约束的调度 func ScheduleMaintenanceIfNeeded() { // 认真负责——只在实际需要工作时安排守卫 needMaintenance() else { return } 让请求= BGProcessingTaskRequest（标识符：“com.yourapp.maintenance”） // 关键：为 CPU 密集型工作设置 requireExternalPower 请求.requiresExternalPower = true // 可选：云同步需要网络请求.requiresNetworkConnectivity = true // 不要将 EarlyBeginDate 设置得太远 — 最多约 1 周 // 如果用户没有返回应用程序，任务将不会运行做{ 尝试 BGTaskScheduler.shared.submit(request) } 捕获 BGTaskScheduler.Error.unavailable { print("后台处理不可用") } 抓住 { print("计划失败：\(错误)") } } #### 具有进度检查点的处理程序 func handleMaintenance（任务：BGProcessingTask）{ var 应该继续 = true task.expirationHandler = { [弱自我] in 应该继续=假 self?.saveProgress() // 保存部分进度！ } 任务{ 做{ // 分块处理，检查过期情况对于 workChunks 中的块 { 守卫应该继续其他{ // 调用到期 — 优雅地停止打破 } 尝试等待 processChunk(chunk) saveProgress() // 每个块之后的检查点 } 任务.setTaskCompleted（成功：true） } 抓住 { 任务.setTaskCompleted(成功: false) } } } **要点**： * 针对 CPU 密集型工作设置 `requiresExternalPower = true`（防止电池耗尽） * 增量保存进度——任务可能会被中断 * 如果用户不给设备充电，工作可能永远不会运行 * 不要将 `earliestBeginDate` 设置为提前一周以上 ** ** ### 模式 3：SwiftUI backgroundTask 修饰符 **使用时间**：使用现代异步/等待模式的 SwiftUI 应用程序。 @主要结构我的应用程序：应用程序{ @Environment(\.scenePhase) var scenePhase var body: 一些场景 { 窗口组{ 内容视图() } .onChange(of: scenePhase) { newPhase 中如果 newPhase == .background { 调度应用程序刷新() } } // 处理应用刷新 .backgroundTask(.appRefresh("com.yourapp.refresh")) { // 安排下一次刷新调度应用程序刷新() // 异步工作——当闭包返回时任务完成等待 fetchLatestContent() } // 处理后台 URLSession 事件 .backgroundTask(.urlSession("com.yourapp.downloads")) { // 当后台 URLSession 完成时调用等待进程下载的文件() } } } **SwiftUI 的优点**： * 当闭包返回时隐式任务完成（不需要`setTaskCompleted`） * 原生 Swift 并发支持 * 任务到期自动取消 ** ** ### 模式 4：BGContinuedProcessingTask（iOS 26+） **使用时间**：用户明确启动工作（点击按钮），该工作应在后台运行后继续，并具有可见的进度。 **不适用于**：自动任务、维护、同步 // 1. Info.plist — 使用通配符作为动态后缀 // BGTaskSchedulerPermissionIdentifiers: //“com.yourapp.export.*” // 2. 在用户发起操作时注册（不是在启动时） func userTappedExportButton() { BGTaskScheduler.shared.register( forTaskWithIdentifier：“com.yourapp.export.photos” ) { 任务在让 ContinuousTask = 任务为！ BG继续处理任务 self.handleExport（任务：持续任务） } // 立即提交让请求= BGContinuedProcessingTaskRequest（标识符：“com.yourapp.export.photos”， title: "导出照片", 副标题：“100 张照片中的 0 张” ） // 可选：如果不能立即启动则失败 request.strategy = .fail // 或 .enqueue （默认）做{ 尝试 BGTaskScheduler.shared.submit(request) } 抓住 { showError("现在无法在后台导出") } } // 3. 具有强制进度报告的处理程序 func handleExport(任务: BGContinuedProcessingTask) { var 应该继续 = true 任务.expirationHandler = { 应该继续=假 } // 强制：报告进度（没有进度的任务自动过期）任务.进度.totalUnitCount = 100 任务.进度.completedUnitCount = 0 任务{ for (索引, 照片) in photos.enumerated() { 守卫应该继续否则{break} 等待导出照片(照片) // 更新进度——系统向用户显示此信息任务.进度.completedUnitCount = Int64(索引 + 1) } 任务.setTaskCompleted（成功：shouldContinue） } } **要点**： * 动态注册（当用户操作时，而不是在启动时） * 进度报告是强制性的 — 没有更新的任务会自动过期 * 用户可以从系统UI进行监控和取消 * 当工作只有立即开始才有用时，使用“.fail”策略 ** ** ### 模式 5：beginBackgroundTask — 简短的关键工作 **使用时间**：应用程序正在后台运行，您需要约 30 秒才能完成关键工作（保存状态、完成上传）。 var backgroundTaskID: UIBackgroundTaskIdentifier = .invalid func applicationDidEnterBackground(_ application: UIApplication) { // 启动后台任务 backgroundTaskID = application.beginBackgroundTask(withName: "保存状态") { [weak self] in // 过期处理程序 — 清理并结束任务 self?.saveProgress() if let taskID = self?.backgroundTaskID { application.endBackgroundTask(任务ID) } self?.backgroundTaskID = .invalid } // 做关键工作 saveEssentialState { [弱自我] in // 完成后立即结束任务 - 不要等待到期 if let taskID = self?.backgroundTaskID, taskID != .invalid { UIApplication.shared.endBackgroundTask(任务ID) self?.backgroundTaskID = .invalid } } } **要点**： * 工作完成后立即调用“endBackgroundTask”（不仅仅是在过期处理程序中） * 未能结束任务可能会导致系统终止您的应用程序并影响未来的启动 * 最长约 30 秒，不保证 * 用于状态保存，而不是正在进行的工作 ** ** ### 模式 6：后台 URLSession **使用时间**：即使应用程序终止，也应继续进行大量下载/上传。 // 1.创建后台配置惰性变量backgroundSession：URLSession = { 让 config = URLSessionConfiguration.background( withIdentifier：“com.yourapp.downloads” ） config.sessionSendsLaunchEvents = true // 应用程序完成后重新启动 config.isDiscretionary = true // 系统选择最佳时间返回 URLSession（配置：config，委托：self，delegateQueue：nil） }() // 2.开始下载 func downloadFile(来自 url: URL) { 让任务=backgroundSession.downloadTask（带有：url）任务.resume() } // 3. 处理会话事件的应用程序重新启动 (AppDelegate) 功能应用程序（_应用程序：UIApplication， handleEventsForBackgroundURLSession 标识符：字符串，完成处理程序： @escaping () -> Void) { // 存储完成处理程序——处理事件后调用背景会话完成处理程序=完成处理程序 // 会话委托方法将被调用 } // 4. URLSessionDelegate func urlSessionDidFinishEvents(forBackgroundURLSession 会话: URLSession) { // 处理的所有事件 - 调用存储的完成处理程序 DispatchQueue.main.async { self.backgroundSessionCompletionHandler?() self.backgroundSessionCompletionHandler = nil } } func urlSession(_ 会话: URLSession, 下载任务：URLSessionDownloadTask， didFinishDownloadingTo 位置：URL) { // 返回之前从临时位置移动文件让destinationURL = getDestinationURL（用于：downloadTask）试试？ FileManager.default.moveItem（位于：位置，至：destinationURL） } **要点**： * 工作移交给系统守护进程 (`nsurlsessiond`) — 应用程序终止后继续 * `isDiscretionary = true` 表示非紧急（系统等待 WiFi、充电） * 必须处理 `handleEventsForBackgroundURLSession` 才能重新启动应用程序 * 立即移动下载的文件 - 代理返回后删除临时位置 ** ** ### 模式 7：静默推送通知触发器 **使用时间**：服务器需要唤醒应用程序以获取新数据。 #### 服务器负载 { “aps”：{ “内容可用”：1 }, “自定义数据”：“获取新消息” } 使用“apns-priority: 5”（而不是 10）来提高能源效率。 #### 应用程序处理程序功能应用程序（_应用程序：UIApplication， didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler 完成处理程序：@escaping (UIBackgroundFetchResult) -> Void) { 任务{ 做{ 让 hasNewData = 尝试等待 fetchLatestData() 完成处理程序（hasNewData？.newData：.noData） } 抓住 { 完成处理程序（.失败） } } } **要点**： *静默推送是有速率限制的——不要指望每次推送都会启动 * 系统合并多次推送（14次推送可能导致7次启动） * 预算会随着每次发布而耗尽，并在全天补充 * 每次启动约 30 秒运行时间 ** ** ## Swift 6 取消集成使用结构化并发时，将 BGTask 过期与任务取消联系起来： func handleAppRefresh(任务: BGAppRefreshTask) { // 创建一个遵守过期时间的任务让工作任务=任务{ 尝试等待 withTaskCancellationHandler { // 你的异步工作尝试等待 fetchAndProcessData() 任务.setTaskCompleted（成功：true）取消：{ // 当调用task.cancel()时同步调用 // 注意：在任意线程上运行，保持轻量级 } } // 桥接过期和取消任务.expirationHandler = { workTask.cancel() // 触发 onCancel 块 } } // 检查工作中的取消 func fetchAndProcessData() 异步抛出 { 对于项目中的项目{ // 检查我们是否应该停止尝试 Task.checkCancellation() // 或非抛出检查守护！Task.isCancelled else { 保存进度() 返回 } 尝试等待进程（项目） } } **要点**： * `withTaskCancellationHandler` 处理任务挂起时的取消 * 如果取消，`Task.checkCancellation()` 会抛出 `CancellationError` * `Task.isCancelled` 用于非抛出检查 * 取消是合作性的——您的代码必须检查并响应 ** ** ## 测试后台任务 ### 模拟器限制后台任务**不会在模拟器中自动运行**。您必须手动触发它们。 ### LLDB 调试命令当应用程序在附加调试器的情况下运行时，暂停执行并运行： // 触发任务启动 e -l objc -- (void)[[BGTaskScheduler sharedScheduler] _simulateLaunchForTaskWithIdentifier:@"com.yourapp.refresh"] // 触发任务过期（测试过期处理程序） e -l objc -- (void)[[BGTaskScheduler sharedScheduler] _simulateExpirationForTaskWithIdentifier:@"com.yourapp.refresh"] ### 测试工作流程 1. 在任务处理程序中设置断点 2.运行应用程序，让它后台运行 3. 在调试器中暂停 4. 运行 `_simulateLaunchForTaskWithIdentifier` 命令 5. 继续 — 断点应该命中 6. 使用 `_simulateExpirationForTaskWithIdentifier` 测试过期时间 ### 测试清单 * 模拟时任务处理程序断点命中？ * 模拟时调用过期处理程序？ * 在所有代码路径中调用“setTaskCompleted”？ * 适用于真实设备（不仅仅是模拟器）？ * 在发布版本中工作（不仅仅是调试）？ * 应用程序未从应用程序切换器上滑走？ ** ** ## 7 个调度因素来自 WWDC 2020-10063“后台执行揭秘”：因素 |描述 |影响 ---|---|--- **电池电量严重不足** | <20% 电量 |所有可自由支配的工作都暂停了 **低功耗模式** |用户启用 |后台活动受限 **应用程序使用** |用户启动应用程序的频率 |更多使用=更高优先级 **应用程序切换器** |应用程序仍然可见吗？ |滑开=无背景 **后台应用程序刷新** |系统设置|关闭 = 无 BGAppRefresh 任务 **系统预算** |能源/数据预算|发射耗尽，一天内补充 **速率限制** |系统间距|防止过于频繁的启动 ### 响应系统约束 // 检查低功耗模式如果 ProcessInfo.processInfo.isLowPowerModeEnabled { // 减少后台工作 } // 监听变化 NotificationCenter.default.publisher（对于：.NSProcessInfoPowerStateDidChange） .sink { _ 中 // 适应行为 } // 检查后台应用程序刷新状态让状态 = UIApplication.shared.backgroundRefreshStatus 开关状态{ 可用案例：休息//很好安排案件被拒绝： // 用户已禁用 — 提示在“设置”中启用案例.限制： // 家长控制或 MDM — 无法启用 } ** ** ## 审核清单 ### 注册清单 * Info.plist 中的标识符与代码完全匹配（区分大小写）？ * 是否启用了正确的后台模式（`fetch`、`processing`）？ * 注册发生在“didFinishLaunchingWithOptions”返回之前？ * 没有多次注册相同的标识符？ * 处理程序闭包没有强烈捕获自身？ ### 日程安排清单 * 在主队列或后台队列上进行调度（如果性能敏感）？ * `earliestBeginDate` 不会太远（最多约 1 周）？ * 处理`submit()`错误？ * 不安排重复任务（检查 `getPendingTaskRequests`）？ ### 处理程序清单 * 过期处理程序在处理程序开始时立即设置？ * 在所有代码路径中调用了 `setTaskCompleted(success:)`？ * 计划下一个任务（对于连续模式）？ * 长期操作时进度会逐渐保存吗？ * 过期处理程序实际上取消了正在进行的工作？ ### 生产准备 * 在真实设备上测试，而不仅仅是模拟器？ * 在发布版本中进行测试，而不仅仅是调试？ * 在启用低功耗模式的情况下进行测试？ * 从应用程序切换器强制退出后进行测试（不应运行）？ * 控制台日志显示预期的“任务已完成”消息？ ** ** ## 压力场景 ### 场景 1：“只需在后台每 30 秒轮询一次服务器” **诱惑**：“轮询比推送通知更简单。我们需要实时更新。” **现实**： * iOS 不会为您提供 30 秒的背景间隔 * BGAppRefreshTask 根据用户行为模式运行，而不是您的日程安排 * 如果用户很少打开应用程序，任务可能每天运行一次或更少 * 投票很快就会消耗预算——发射总量减少 **时间成本比较** : * 实施轮询：30 分钟（不会按预期工作） * 了解为什么不起作用：2-4小时调试 * 实施适当的推送通知：3-4小时 **实际效果**： *静默推送通知（服务器触发，不轮询） * BGAppRefreshTask 用于预测用户行为（非实时） * BGProcessingTask 用于可推迟的工作（过夜） **推回模板**：“iOS 后台执行不支持轮询间隔。BGAppRefreshTask 根据 iOS 预测用户将打开我们的应用程序的时间运行，而不是按照固定的时间表运行。对于实时更新，我们需要服务器端推送通知。让我向您展示 Apple 的相关文档。” ** ** ### 场景 2：“我的任务需要 5 分钟，而不是 30 秒” **诱惑**：“我将只使用 beginBackgroundTask 来完成我所有的工作。” **现实**： * 开始后台任务：最长约 30 秒 * BGAppRefreshTask：约 30 秒 * BGProcessingTask：几分钟，但仅限充电时 * 没有 API 可以保证 5 分钟的前台质量运行时间 **实际效果**： 1. **将你的工作分成块** — 分成 30 秒的部分，保存进度 2. **使用 BGProcessingTask** 和 `requiresExternalPower = true`（过夜运行） 3. **iOS 26+** ：使用 BGContinuedProcessingTask 进行用户启动的工作 **推回模板**：“iOS 限制后台运行时间以保护电池。对于需要几分钟的工作，我们有两种选择：(1) BGProcessingTask 在充电时运行过夜 - 非常适合维护，(2) 将工作分成在 30 秒内完成的块，在运行之间保存进度。哪个更适合我们的用例？” ** ** ### 场景 3：“它适用于我的设备，但不适用于用户” **诱惑**：“代码是正确的——这一定是用户设备的问题。” **现实**：附加 Xcode 的调试构建的行为与野外发布构建的行为不同。 **常见原因**： 1. **启用低功耗模式** — 限制后台活动 2. **后台应用程序刷新已禁用** — 用户或家长控制 3. **应用程序滑走** — 杀死所有后台任务 4. **预算耗尽** - 最近推出的产品太多 5. **很少使用的应用程序** — 系统降低优先级 **调试步骤**： 1. 在启动时检查`backgroundRefreshStatus`，记录它 2. 任务安排和完成时记录 3. 使用 MetricKit 监控生产中的后台启动 4. 询问用户：“您是否从应用程序切换器中强制退出了该应用程序？” **推回模板**：“后台执行取决于 7 个系统因素，包括电池电量、用户应用程序使用模式以及他们是否强制退出应用程序。让我添加日志记录以了解受影响的用户发生了什么情况。” ** ** ### 场景 4：“现在发货，稍后添加后台任务” **诱惑**：“后台工作是一个很好的功能。” **现实**： * 用户期望打开应用时内容是新鲜的 * 在后台刷新的竞争应用程序感觉响应更快 * 稍后添加后台任务需要仔细注册时机 * 过时内容的第一印象会提高保留率 **时间成本比较** : * 现在添加BGAppRefreshTask：1-2小时 * 经过适当测试后进行改造：4-6 小时 * 调试“为什么不起作用”问题：额外的时间 **最低可行背景**： // 在 didFinishLaunchingWithOptions 中 BGTaskScheduler.shared.register( forTaskWithIdentifier: "com.yourapp.refresh", 使用：无 ) { 任务在 task.setTaskCompleted(success: true) // 占位符 self.scheduleRefresh() } **推回模板**：“后台刷新是[应用程序类型]的核心期望。最少实现是 20 行代码。如果我们在没有它的情况下发布并稍后添加，我们将面临注册计时错误的风险。让我现在添加脚手架，以便我们可以在发布后对其进行增强。” ** ** ## 现实世界的例子 ### 示例 1：任务从不运行 — 标识符不匹配 **症状**：`submit()` 成功，但处理程序从未调用。 **诊断**： // 代码使用： BGTaskScheduler.shared.register( forTaskWithIdentifier: "com.myapp.Refresh", // 大写 R ... ） // Info.plist 有： // "com.myapp.refresh" // 小写 r **修复**：标识符必须完全匹配（区分大小写）。 **浪费时间**：当问题是拼写错误时，需要 2 小时调试代码逻辑。 ** ** ### 示例 2：任务终止 — 缺少 setTaskCompleted **症状**：处理程序运行，工作似乎已完成，但下一个计划任务从未运行。 **诊断**： func handleRefresh(任务: BGAppRefreshTask) { fetchData { 结果切换结果{ 案例.成功： task.setTaskCompleted(success: true) // ✅ 已调用案例.失败： // ❌ 缺少 setTaskCompleted！打印（“失败”） } } } **修复**：在所有代码路径中调用“setTaskCompleted”，包括错误。案例.失败： task.setTaskCompleted(success: false) // ✅ 现在调用 **影响**：未能调用setTaskCompleted可能会导致系统惩罚应用程序的后台预算。 ** ** ### 示例 3：适用于开发，不适用于生产 — 强制退出 **症状**：用户报告后台同步不起作用。开发者无法重现。 **诊断**：用户：“我每晚都会关闭应用程序以节省电量。” 开发人员：“你如何关闭它们？” 用户：“在应用程序切换器中向上滑动。” **现实**：从应用程序切换器滑开=强制退出=无后台任务，直到用户再次打开应用程序。 **修复**： 1. 教育用户（不理想） 2. 接受这是 iOS 行为 3.确保应用程序重新打开时良好的首次启动体验 ** ** ### 示例 4：BGProcessingTask 从未运行 — 缺少电源要求 **症状**：BGProcessingTask 已计划但从未执行。 **诊断**：用户在夜间插入手机，但任务有“requiresExternalPower = true”并且用户使用无线充电器。等等，这不是问题。真实问题：让请求= BGProcessingTaskRequest（标识符：“com.app.maintenance”） // 缺少：request.requiresExternalPower = true 如果没有“requiresExternalPower”，系统仍然会等待充电，但确定性较低。明确设置它可以给系统发出清晰的信号。另外：用户必须在大约 2 周内在前台启动应用程序才能处理任务。 ** ** ## 快速参考 ### LLDB 调试命令 // 触发任务 e -l objc -- (void)[[BGTaskScheduler shareScheduler] _simulateLaunchForTaskWithIdentifier:@"IDENTIFIER"] // 触发过期 e -l objc -- (void)[[BGTaskScheduler shareScheduler] _simulateExpirationForTaskWithIdentifier:@"IDENTIFIER"] ### 控制台过滤器子系统：com.apple.backgroundtaskscheduler ### 任务类型摘要需要|使用 |运行时 ---|---|--- 保持内容新鲜 | BGAppRefreshTask | BGAppRefreshTask 〜30秒重度维护| BGProcessingTask + 需要外部电源 |分钟用户发起的继续 | BGContinuedProcessingTask（iOS 26）|扩展完成背景 |开始背景任务 | 〜30秒大量下载 |后台 URLSession |根据需要服务器触发 |静默推送通知 | 〜30秒 ** ** ## 资源 **全球开发者大会**：2019-707、2020-10063、2022-10142、2023-10170、2025-227 **文档**：/backgroundtasks/bgtaskscheduler、/backgroundtasks/在开发期间启动和终止任务 **技能**：axiom-background-processing-ref、axiom-background-processing-diag、axiom-energy ** ** **最后更新**：2025 年 12 月 31 日 **平台**：iOS 13+、iOS 26+ (BGContinuedProcessingTask) **状态**：生产就绪的后台任务模式

Axiom 后台处理

包含技能