PListKit

CI Build Status Platforms - macOS 10.10+ | iOS 9+ | tvOS 9+ | watchOS 2+ | visionOS 1+ Swift 5.3-6 Xcode 13-16 License: MIT

一个多平台 Swift 库,为 .plist (属性列表) 文件带来函数式方法和类型安全。

概要

Apple 标准 PropertyListSerialization 带来的挑战

  1. 缺乏类型安全,这会导致不兼容的值类型被意外注入,从而在稍后保存 plist 文件时导致意外错误,并且难以诊断
  2. 仅限根级别字典访问,使得遍历嵌套字典非常繁琐
  3. 处理 NS 值类型,这不是很 Swifty,并且需要在每次交互时添加额外的样板代码

PListKit 通过以下方式解决这些问题

  1. 作为 PropertyListSerialization 的一个安全且方便的包装器
  2. 提供简洁的函数式语法,用于
    • 轻松操作字典树中的嵌套键和值
    • 加载和保存 plist 文件
  3. 处理键和值的原生 Swift 值类型
  4. 防止意外使用不兼容的值类型,以避免由于缺乏类型安全而导致的意外错误

安装

该库以 Swift Package Manager (SPM) 包的形式提供。

要将 PListKit 添加到您的 Xcode 项目

  1. 选择 File → Swift Packages → Add Package Dependency (文件 → Swift Packages → 添加 Package 依赖项)
  2. 使用 https://github.com/orchetect/PListKit 作为 URL 添加包。

文档

请参阅在线文档,或通过选择 Product → Build Documentation (产品 → 构建文档) 菜单在 Xcode 的文档浏览器中查看它。

资源

作者

由一群藏在风衣里,自称为 @orchetect 的 🐹 仓鼠编写。

许可

根据 MIT 许可证获得许可。有关详细信息,请参阅 LICENSE

贡献

欢迎贡献。请随时发布 Issue 进行讨论。

该库以前称为 OTPList。