感知

为不官方支持观察的平台提供观察工具。

了解更多

这个库由Brandon Williams和Stephen Celis创建，他们是Point-Free视频系列的主持人，该系列探讨高级Swift语言概念。

<a href="https://www.pointfree.co/"> <img alt="视频海报图片" src="https://yellow-cdn.veclightyear.com/835a84d5/54655d95-8606-4788-be88-7cc5abfea2a5.jpeg" width="600"> </a>

概述

Perception库提供了模仿Swift 5.9中@Observable和withObservationTracking的工具，但它们被移植回iOS 13、macOS 10.15、tvOS 13和watchOS 6。这意味着你现在就可以开始利用Swift 5.9的观察工具，即使你不能放弃对旧版Apple平台的支持。使用这个库的工具几乎与使用官方工具完全相同，只有一个小异常。

首先，使用@Perceptible宏而不是@Observable宏来标记一个类为可观察的：

@Perceptible
class FeatureModel {
  var count = 0
}

然后你可以在你的视图中使用常规的let属性来持有一个可感知的模型：

struct FeatureView: View {
  let model: FeatureModel

  // ...
}

在视图的body中，你必须使用WithPerceptionTracking视图包装你的内容，以便正确设置观察：

struct FeatureView: View {
  let model: FeatureModel

  var body: some View {
    WithPerceptionTracking {
      Form {
        Text(model.count.description)
        Button("增加") { model.count += 1 }
      }
    }
  }
}

不得不用WithPerceptionTracking包装视图的内容确实有些不便，但如果你忘记了，你会收到一个有用的运行时警告，告诉你观察没有正确设置：

🟣 运行时警告：访问了可感知状态但未被追踪。通过将视图包装在'WithPerceptionTracking'视图中来追踪状态变化。

Bindable

SwiftUI的@Bindable属性包装器也被移植以支持可感知对象。你可以简单地用Perception模块限定属性包装器：

struct FeatureView: View {
  @Perception.Bindable var model: FeatureModel

  // ...
}

Environment

SwiftUI的@Environment属性包装器和environment视图修饰符对观察的支持也被移植以支持可感知对象，使用完全相同的API：

struct FeatureView: View {
  @Environment(Settings.self) var settings

  // ...
}

// 在某个父视图中：
.environment(settings)

社区

如果你想讨论这个库或有关于如何使用它解决特定问题的疑问，有几个地方可以与其他Point-Free爱好者讨论：

• 对于长篇讨论，我们推荐使用这个仓库的discussions标签。
• 对于随意聊天，我们推荐Point-Free社区Slack。

文档

Perception API的最新文档可在这里找到。

许可证

这个库在MIT许可下发布。详情请见LICENSE。