SwiftUI-Introspect 项目在 macOS 15 上的兼容性问题解析

SwiftUI-Introspect 是一个流行的开源库，它允许开发者在 SwiftUI 视图中访问底层 UIKit 或 AppKit 组件。随着 macOS 15 的发布，开发者们开始关注这个库在新系统上的兼容性情况。

兼容性现状

目前，SwiftUI-Introspect 库在 macOS 15 上的支持存在一些挑战。虽然核心功能理论上可以继续工作，但测试套件的架构设计使得维护变得异常困难。项目维护者指出，现有的测试代码结构采用了泛型平台版本谓词，导致代码复用性极低，为每个视图的每个版本添加支持都需要大量重复工作。

ScrollView 的特殊情况

对于开发者最关心的 ScrollView 组件，好消息是库的代码已经包含了 macOS 15 版本的支持。这意味着理论上开发者可以通过指定 .v15 参数来获取 NSScrollView 实例：

.introspect(.scrollView, on: .macOS(.v11, .v12, .v13, .v14, .v15)) { scrollView in
    // 使用获取到的 NSScrollView 实例
}

替代方案探讨

考虑到 SwiftUI-Introspect 项目当前的维护状态，开发者们可以考虑以下替代方案：

1. 使用原生 SwiftUI 功能：随着 SwiftUI 的不断演进，许多以前需要依赖底层访问的功能现在可能已经有原生实现。

2. 转向更现代的替代库：社区已经出现了新的替代项目，提供了更简洁的 API 设计。这些新库通常采用更直观的调用方式：

ScrollView {
    // 内容
}.inspect { scrollView in
    // 直接获取 NSScrollView 实例
}

窗口访问的局限性

值得注意的是，窗口访问(NSSWindow)在大多数 SwiftUI 内省库中都不是主要支持的功能。这是因为：

• 技术限制：这些库主要专注于 NSView 和 UIView 层级的访问
• API 设计挑战：窗口访问不适合采用与视图相同的检查模式

开发者可以通过 AppKit 原生的方式获取窗口引用：

// 获取当前接收键盘事件的窗口
let keyWindow = NSApplication.shared.keyWindow

// 获取应用的主窗口
let mainWindow = NSApplication.shared.mainWindow

未来展望

随着 SwiftUI 的成熟，直接访问底层视图的需求可能会逐渐减少。苹果正在不断为 SwiftUI 添加原本需要依赖底层访问才能实现的功能。对于仍需要底层访问的场景，开发者可能需要关注社区维护的新兴替代方案，这些方案通常具有更可持续的架构设计。

对于现有项目，如果必须使用 SwiftUI-Introspect，可以考虑直接使用主分支代码，或者等待官方发布包含 macOS 15 支持的新版本。同时，评估是否真的需要底层访问，或者是否可以改用纯 SwiftUI 实现，将是更可持续的长期解决方案。