如何在保留iOS14支持的前提下使用iOS15+的@AccessibilityFocusState API？

问题根源 #

你遇到的崩溃是因为@AccessibilityFocusState是iOS15+专属的属性包装器，即便给变量添加@available(iOS 15.0, *)修饰，SwiftUI在初始化视图时仍会尝试创建该属性包装器的实例——而iOS14系统中不存在这个类型，直接触发运行时错误。

可行解决方案 #

1. 拆分视图为版本专属实现

将使用@AccessibilityFocusState的逻辑抽离到独立的iOS15+专用视图，父视图通过运行时版本判断加载对应视图：

// iOS15+ 专用视图，完整使用AccessibilityFocusState
@available(iOS 15.0, *)
struct AccessibilityFocusSupportedView: View {
    @AccessibilityFocusState private var focusTarget: FocusLocation?
    
    var body: some View {
        VStack {
            Button("跳转到输入框") {
                focusTarget = .inputField
            }
            TextField("测试输入", text: .constant(""))
                .accessibilityFocused($focusTarget, equals: .inputField)
        }
    }
}

// iOS14 兼容视图，用传统API实现焦点管理
struct AccessibilityFocusFallbackView: View {
    @State private var inputFieldID = UUID()
    
    var body: some View {
        VStack {
            Button("跳转到输入框") {
                // iOS14下手动触发辅助焦点跳转
                guard let inputView = UIApplication.shared.windows.first?.viewWithTag(inputFieldID.hashValue) else { return }
                UIAccessibility.post(notification: .screenChanged, argument: inputView)
            }
            TextField("测试输入", text: .constant(""))
                .tag(inputFieldID.hashValue)
        }
    }
}

// 父视图中根据系统版本切换
struct MainView: View {
    var body: some View {
        Group {
            if #available(iOS 15.0, *) {
                AccessibilityFocusSupportedView()
            } else {
                AccessibilityFocusFallbackView()
            }
        }
    }
}

// 自定义焦点位置枚举
enum FocusLocation {
    case inputField
}

2. 使用条件编译+运行时检查隐藏属性声明

如果不想拆分视图，可以结合Swift版本条件编译（Swift 5.5对应iOS15+）和运行时判断，避免iOS14下初始化属性包装器：

struct ContentView: View {
    #if compiler(>=5.5)
    @available(iOS 15.0, *)
    @AccessibilityFocusState private var focusTarget: FocusLocation?
    #endif
    
    var body: some View {
        Button("触发焦点") {
            if #available(iOS 15.0, *) {
                #if compiler(>=5.5)
                focusTarget = .inputField
                #endif
            } else {
                // iOS14下的降级逻辑
            }
        }
        
        if #available(iOS 15.0, *) {
            #if compiler(>=5.5)
            TextField("测试", text: .constant(""))
                .accessibilityFocused($focusTarget, equals: .inputField)
            #endif
        } else {
            TextField("测试", text: .constant(""))
        }
    }
}

注意：所有访问该属性的代码必须被#available和#if compiler双重包裹，否则仍会触发崩溃。

iOS14下的辅助焦点替代方案 #

在iOS14中，可通过UIAccessibility通知API手动管理焦点：

• 触发屏幕焦点更新：UIAccessibility.post(notification: .screenChanged, argument: targetView)
• 聚焦到特定元素：UIAccessibility.post(notification: .layoutChanged, argument: targetView)

需提前给目标视图设置标记（比如tag），再通过viewWithTag获取对应视图实例。

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