在SwiftUI中使用AppKit中的控件

Representable是SwiftUI中提供的一个协议，用于将 macOS 的 AppKit 视图（NSView)包装成一个可以在 SwiftUI 中使用的组件。它可以让你在 SwiftUI 中使用 AppKit 的强大功能，尤其在 SwiftUI 原生功能不足以满足需求的情况下。

基本概念

NSViewPepresentable 允许你：

将一个 AppKit 视图引入到SwiftUI的视图层次结构中。
在 SwiftUI 和 AppKit 视图之间实现数据和状态的双向绑定。
自定义 NSView 的行为，并与 SwiftUI 的生命周期集成。

协议定义

NSViewRepresentable 有两个主要方法必须实现：

makeNSView(context:Context) -> NSView
updateNSView(_:context:) 此外，还有一个可选的方法
func makeCoordinator() -> Coordinator
这个方法是初始化context.coordinator

    /// An instance you use to communicate your AppKit view's behavior and state
    /// out to SwiftUI objects.
    ///
    /// The coordinator is a custom instance you define. When updating your
    /// view, communicate changes to SwiftUI by updating the properties of your
    /// coordinator, or by calling relevant methods to make those changes. The
    /// implementation of those properties and methods are responsible for
    /// updating the appropriate SwiftUI values. For example, you might define a
    /// property in your coordinator that binds to a SwiftUI value, as shown in
    /// the following code example. Changing the property updates the value of
    /// the corresponding SwiftUI variable.
    ///
    ///     class Coordinator: NSObject {
    ///        @Binding var rating: Int
    ///        init(rating: Binding<Int>) {
    ///           $rating = rating
    ///        }
    ///     }
    ///
    /// To create and configure your custom coordinator, implement the
    /// ``NSViewControllerRepresentable/makeCoordinator()`` method of your
    /// ``NSViewControllerRepresentable`` object.
    @MainActor @preconcurrency public let coordinator: View.Coordinator

用于向 SwiftUI 对象传递 AppKit 视图的行为和状态的实例。协调器（Coordinator）是一个由你自定义的对象。在更新视图控制器时，你可以通过修改协调器的属性或调用相关方法，将变更传递给 SwiftUI。这些属性和方法的实现负责更新相应的 SwiftUI 值。

例如，你可以在协调器中定义一个与 SwiftUI 值绑定的属性，如下面的代码示例所示。修改该属性后，相应的 SwiftUI 变量的值也会随之更新。

要创建并配置自定义协调器（Coordinator），需要在你的 NSViewControllerRepresentable 对象中实现 makeCoordinator() 方法。

代码示例

import SwiftUI
import AppKit

struct CustomNSTextField: NSViewRepresentable {
    @Binding var text: String

    func makeNSView(context: Context) -> NSTextField {
        let textField = NSTextField(string: text)
        textField.delegate = context.coordinator
        return textField
    }

    func updateNSView(_ nsView: NSTextField, context: Context) {
        nsView.stringValue = text
    }

    func makeCoordinator() -> Coordinator {
        Coordinator(parent: self)
    }

    class Coordinator: NSObject, NSTextFieldDelegate {
        var parent: CustomNSTextField

        init(parent: CustomNSTextField) {
            self.parent = parent
        }

        func controlTextDidChange(_ obj: Notification) {
            if let textField = obj.object as? NSTextField {
                parent.text = textField.stringValue
            }
        }
    }
}

struct ContentTFView: View {
    @State private var text = "Hello, SwiftUI!"

    var body: some View {
        CustomNSTextField(text: $text)
        Text("Typed text: \(text)")
    }
}


#Preview {
    ContentTFView()
}

通过@Binding在Coordinator中定义绑定属性，把AppKit中的值的变化传递给SwiftUI是一种方式
另一种方式是在Coordinator中定义一个属性parent,把SwiftUI的实例self传递进来，直接修改其属性或者调用其方法。