兼容iOS 15时如何使用.backgroundTask修饰符？

核心问题解析 #

你遇到的Cannot infer contextual base in reference to member 'appRefresh'编译错误，本质是因为**backgroundTask是Scene修饰符，而非View修饰符**——最初代码错误地将其附加在AppRootView上，完全不符合API使用规则。

正确的iOS 16可用性适配写法 #

要在支持iOS 16+的同时兼容旧版本，不能在View层级做判断，需要直接针对Scene的修饰符进行版本区分，以下两种写法都可行：

写法一：变量复用+版本判断

import SwiftUI
import BackgroundTasks

@main
struct MyApp: App {
    @Environment(\.scenePhase) var scenePhase
    
    var body: some Scene {
        // 先定义基础Scene
        let mainScene = WindowGroup {
            AppRootView()
        }
        
        // 根据系统版本决定是否添加backgroundTask修饰符
        if #available(iOS 16.0, *) {
            mainScene.backgroundTask(.appRefresh("refreshAllData")) {
                refreshAllData()
            }
        } else {
            mainScene
        }
    }
    
    private func refreshAllData() {
        // 这里写你的后台数据刷新逻辑
    }
}

写法二：自定义Scene修饰符（更优雅的版本隔离）

import SwiftUI
import BackgroundTasks

@main
struct MyApp: App {
    @Environment(\.scenePhase) var scenePhase
    
    var body: some Scene {
        WindowGroup {
            AppRootView()
        }
        .modifier(AppBackgroundTaskModifier())
    }
    
    private func refreshAllData() {
        // 后台刷新逻辑
    }
}

// 自定义修饰符处理版本兼容性
struct AppBackgroundTaskModifier: SceneModifier {
    // iOS 16+应用backgroundTask
    @available(iOS 16.0, *)
    func body(content: Content) -> some Scene {
        content.backgroundTask(.appRefresh("refreshAllData")) {
            (UIApplication.shared.delegate as? MyAppDelegate)?.refreshAllData()
        }
    }
    
    // iOS 16以下直接返回原Scene
    func body(content: Content) -> some Scene {
        content
    }
}

额外注意事项 #

1. 配置后台任务标识符：必须在Info.plist中添加BGTaskSchedulerPermittedIdentifiers数组，将你的refreshAllData标识符加入其中，否则后台任务无法被系统调度。
2. 注册后台任务：如果需要主动触发后台刷新，iOS 16以下需在App启动时调用BGTaskScheduler.shared.register(forTaskWithIdentifier: "refreshAllData", using: nil) { task in ... }；iOS 16+通过backgroundTask修饰符即可自动处理注册逻辑。

内容的提问来源于stack exchange，提问作者GarySabo