0. 概览
Swift 5.9 一声炮响为我们带来全新的宏（Macro）机制，也同时带来了干霄凌云的 Observation 框架。
Observation 框架可以增强通用场景下的使用，也可以搭配 SwiftUI 5.0 而获得双剑合璧的更强威力。
在本篇博文，您将学到如下内容:
- 0. 概览
- 1. @Observable 宏
- 2. 通用情境下如何观察 Observable 对象？
- 3. Observable 对象与 SwiftUI 珠联璧合
- 4. 被“抛弃的” @EnvironmentObject
- 5. 在视图中将不可变 Observable 对象转换为可变对象的妙招
- 6. 总结
那么，就让我们赶快进入 Observation 奇妙的世界吧！
Let‘s go！！！😉
1. @Observable 宏
简单来说，Observation 框架为我们提供了集鲁棒性（robust）、安全性、高性能等三大特性为一身的 Swift 全新观察者设计模式。
它的核心功能在于：监视对象状态，并在改变时做出反应！
在 Swift 5.9 中，我们可以非常轻松的通过 @Observable 宏将普通类“转化为”可观察（Observable）类。自然，它们的实例都是可观察的：
@Observable
final class Hero {
var name: String
var power: Int
init(name: String, power: Int) {
self.name = name
self.power = power
}
}
@Observable
final class Model {
var title: String
var createAt: Date?
var heros: [Hero]
init(title: String, heros: [Hero]) {
self.title = title
self.createAt = Date.now
self.heros = heros
}
}
如上代码所示，我们定义了两个可观察类 Model 和 Hero，就是这么简单！
2. 通用情境下如何观察 Observable 对象？
在一个对象成为可观察之后，我们可以通过 withObservationTracking() 方法随时监听它状态的改变：
我们可以将对象需要监听的属性放在 withObservationTracking() 的 apply 闭包中，当且仅当（ Hero 中其它属性的改变不予理会）这些属性发生改变时其 onChange 闭包将会被调用：
let hero = Hero(name: "大熊猫侯佩", power: 5)
func watching() {
withObservationTracking({
NSLog("力量参考值：\(hero.power)")
}, onChange: {
NSLog("改变之前的力量！:\(hero.power)")
watching()
})
}
watching()
hero.name = "地球熊猫"
hero.power = 11
hero.power = 121
以上代码输出如下：
使用 withObservationTracking() 方法有 3 点需要注意：
- 它默认只会被调用 1 次，所以上面为了能够重复监听，我们在 onChange 闭包里对 watching() 方法再次进行了调用；
- withObservationTracking() 方法的 apply 闭包不管如何都会被调用 1 次，即使其监听的属性从未改变过；
- 在监听闭包中只能得到属性改变前的旧值；
目前，上面测试代码在 Xcode 15 的 Playground 中编译会报错，提示如下：
error: test15.playground:8:13: error: external macro implementation type ‘ObservationMacros.ObservableMacro’ could not be found for macro ‘Observable()’
final class Hero {
^Observation.Observable:2:180: note: ‘Observable()’ declared here
@attached(member, names: named(_$observationRegistrar), named(access), named(withMutation)) @attached(memberAttribute) @attached(extension, conformances: Observable) public macro Observable() = #externalMacro(module: “ObservationMacros”, type: “ObservableMacro”)
小伙伴们可以把它们放在 Xcode 的 Command Line Tool 项目中进行测试：
3. Observable 对象与 SwiftUI 珠联璧合
要想发挥 Observable 对象的最大威力，我们需要 SwiftUI 来一拍即合。
在 SwiftUI 中，我们无需再显式调用 withObservationTracking() 方法来监听改变，如虎添翼的 SwiftUI 已为我们自动完成了所有这一切！
struct ContentView: View {
let model = Model(title: "地球超级英雄", heros: [])
var body: some View {
NavigationStack {
Form {
LabeledContent(content: {
Text(model.title)
}, label: {
Text("藏匿点名称")
})
LabeledContent(content: {
Text(model.createAt?.formatted(date: .omitted, time: .standard) ?? "无")
}, label: {
Text("更新时间")
})
Button("刷新") {
// SwiftUI 会自动监听可观察对象的改变，并刷新界面
model.title = "爱丽丝仙境兔子洞"
model.createAt = Date.now
}
}.navigationTitle(model.title)
}
}
}
注意，上面代码中 model 属性只是一个普通的 let 常量，即便如此 model 的改变仍会反映到界面上：
4. 被“抛弃的” @EnvironmentObject
有了 Swift 5.9 中新 Observation 框架加入游戏，在 SwiftUI 5.0 中 EnvironmentObject 再无用武之地，我们仅用 Environment 即可搞定一切！
早在 SwiftUI 1.0 版本时，其就已经提供了 Environment 对应的构造器：
@available(iOS 13.0, macOS 10.15, tvOS 13.0, watchOS 6.0, *)
@frozen @propertyWrapper public struct Environment<Value> : DynamicProperty {...}
有了新 Observation 框架的入驻，结合其 Observable 可观察对象，Environment 可以再次大放异彩：
struct HeroListView: View {
@Environment(Model.self) var model
var body: some View {
List(model.heros) { hero in
HStack {
Text(hero.name)
.font(.headline)
Spacer()
Text("\(hero.power)")
.font(.subheadline)
.foregroundStyle(.gray)
}
}
}
}
struct ContentView: View {
@State var model = Model(title: "地球超级英雄", heros: [
.init(name: "大熊猫侯佩", power: 5),
.init(name: "孙悟空", power: 1000),
.init(name: "哪吒", power: 511)
])
var body: some View {
NavigationStack {
Form {
NavigationLink(destination: HeroListView().environment(model)) {
Text("查看所有英雄")
}
}.navigationTitle(model.title)
}
}
}
现在，即使跨越多重层级关系我们也可以只通过 @Environment 而不用 @EnvironmentObject 来完成状态的间接传递了，是不是很赞呢？👍🏻
5. 在视图中将不可变 Observable 对象转换为可变对象的妙招
介绍了以上这许多，就还剩一个主题没有涉及：**Observable 对象的可变性！
**
为了能够在子视图中更改对应的可观察对象，我们可以用 @Bindable 修饰传入的 Observable 对象：
struct HeroView: View {
@Bindable var hero: Hero
var body: some View {
Form {
TextField("名称", text: $hero.name)
TextField("力量", text: .init(get: {
String(hero.power)
}, set: {
hero.power = Int($0) ?? 0
}))
}
}
}
不过，对于之前 @Environment 那个例子来说，如何达到子视图能够修改传入的 @Environment 可观察对象呢？
别急，我们可以利用称为“临时可变（Temporary Variable）”的技术将原先不可变的可观察对象改为可变：
extension Hero: Identifiable {
var id: String {
name
}
}
struct HeroListView: View {
@Environment(Model.self) var model
var body: some View {
// 在 body 内将 model 改为可变
@Bindable var model = model
VStack {
List(model.heros) { hero in
HStack {
Text(hero.name)
.font(.headline)
Spacer()
Text("\(hero.power)")
.font(.subheadline)
.foregroundStyle(.gray)
}
}.safeAreaInset(edge: .bottom) {
// 绑定可变 model 中的状态以修改英雄名称
TextField("", text: $model.heros[0].name)
.padding()
}
}
}
}
运行效果如下：
“临时可变”这一技术可以用于视图中任何化“不变”为“可变”的场景中，当然对于直接视图间对象的传递，我们可以使用 @Bindable 这一更为“正统”的方法。
6. 总结
在本篇博文中，我们讨论了在 Swift 5.0 和 SwiftUI 5.0 中大放异彩 Observation 框架的使用，并就诸多技术细节问题给与了详细的介绍，愿君喜欢。
感谢观赏，再会！😎
