Project Icon

swift-perception

为旧版Apple平台提供Swift 5.9观察功能的开源工具

swift-perception是一个开源项目,为不支持Swift 5.9官方观察功能的Apple平台提供了类似的工具。该项目支持iOS 13、macOS 10.15、tvOS 13和watchOS 6及以上版本,让开发者能在旧版平台上使用最新的观察特性。它提供了@Perceptible宏和WithPerceptionTracking视图,使用方法与官方工具相似,并支持@Bindable和@Environment的向后兼容。

感知

CI Slack

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

了解更多

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

视频海报图片

概述

Perception库提供了模仿Swift 5.9中@ObservablewithObservationTracking的工具,但它们被移植回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爱好者讨论:

文档

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

许可证

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

项目侧边栏1项目侧边栏2
推荐项目
Project Cover

豆包MarsCode

豆包 MarsCode 是一款革命性的编程助手,通过AI技术提供代码补全、单测生成、代码解释和智能问答等功能,支持100+编程语言,与主流编辑器无缝集成,显著提升开发效率和代码质量。

Project Cover

AI写歌

Suno AI是一个革命性的AI音乐创作平台,能在短短30秒内帮助用户创作出一首完整的歌曲。无论是寻找创作灵感还是需要快速制作音乐,Suno AI都是音乐爱好者和专业人士的理想选择。

Project Cover

有言AI

有言平台提供一站式AIGC视频创作解决方案,通过智能技术简化视频制作流程。无论是企业宣传还是个人分享,有言都能帮助用户快速、轻松地制作出专业级别的视频内容。

Project Cover

Kimi

Kimi AI助手提供多语言对话支持,能够阅读和理解用户上传的文件内容,解析网页信息,并结合搜索结果为用户提供详尽的答案。无论是日常咨询还是专业问题,Kimi都能以友好、专业的方式提供帮助。

Project Cover

阿里绘蛙

绘蛙是阿里巴巴集团推出的革命性AI电商营销平台。利用尖端人工智能技术,为商家提供一键生成商品图和营销文案的服务,显著提升内容创作效率和营销效果。适用于淘宝、天猫等电商平台,让商品第一时间被种草。

Project Cover

吐司

探索Tensor.Art平台的独特AI模型,免费访问各种图像生成与AI训练工具,从Stable Diffusion等基础模型开始,轻松实现创新图像生成。体验前沿的AI技术,推动个人和企业的创新发展。

Project Cover

SubCat字幕猫

SubCat字幕猫APP是一款创新的视频播放器,它将改变您观看视频的方式!SubCat结合了先进的人工智能技术,为您提供即时视频字幕翻译,无论是本地视频还是网络流媒体,让您轻松享受各种语言的内容。

Project Cover

美间AI

美间AI创意设计平台,利用前沿AI技术,为设计师和营销人员提供一站式设计解决方案。从智能海报到3D效果图,再到文案生成,美间让创意设计更简单、更高效。

Project Cover

稿定AI

稿定设计 是一个多功能的在线设计和创意平台,提供广泛的设计工具和资源,以满足不同用户的需求。从专业的图形设计师到普通用户,无论是进行图片处理、智能抠图、H5页面制作还是视频剪辑,稿定设计都能提供简单、高效的解决方案。该平台以其用户友好的界面和强大的功能集合,帮助用户轻松实现创意设计。

投诉举报邮箱: service@vectorlightyear.com
@2024 懂AI·鲁ICP备2024100362号-6·鲁公网安备37021002001498号