重要提示
DynamicCodableKit 已停止积极开发,请迁移至 MetaCodable
DynamicCodableKit 通过基于 Swift 的 Codable 实现,帮助您在 Swift 健全类型系统的约束下实现动态 JSON 解码。
DynamicCodableKit 定义的数据类型、协议和属性包装器可用于为 Swift 的 Decodable
类型提供动态解码功能。
平台 | 最低 Swift 版本 | 安装 | 状态 |
---|---|---|---|
iOS 8.0+ / macOS 10.10+ / tvOS 9.0+ / watchOS 2.0+ | 5.1 | CocoaPods, Carthage, Swift Package Manager, 手动 | 完全测试 |
Linux | 5.1 | Swift Package Manager | 完全测试 |
Windows | 5.3 | Swift Package Manager | 完全测试 |
CocoaPods 是 Cocoa 项目的依赖管理工具。有关使用和安装说明,请访问他们的网站。 要使用 CocoaPods 将 DynamicCodableKit
集成到您的 Xcode 项目中,请在您的 Podfile
中指定它
pod 'DynamicCodableKit'
或者,您也可以使用 GitHub 发布页面中预构建的 XCFramework,将 {version}
替换为您要使用的所需版本
pod 'DynamicCodableKit', :http => 'https://github.com/SwiftyLab/DynamicCodableKit/releases/download/v{version}/DynamicCodableKit-{version}.xcframework.zip'
Carthage 是一个去中心化的依赖管理器,它构建您的依赖项并为您提供二进制框架。 要使用 Carthage 将 DynamicCodableKit
集成到您的 Xcode 项目中,请在您的 Cartfile
中指定它
github "SwiftyLab/DynamicCodableKit"
Swift Package Manager 是一种用于自动化 Swift 代码分发的工具,并已集成到 swift
编译器中。
设置好 Swift 包后,将 DynamicCodableKit
作为依赖项添加到 Package.swift
的 dependencies
值中非常容易。
.package(url: "https://github.com/SwiftyLab/DynamicCodableKit.git", from: "1.0.0"),
或者,您也可以使用 GitHub 发布页面中预构建的 XCFramework,将 {version}
和 {checksum}
替换为您要使用的工件的所需版本和校验和
.binaryTarget(name: "DynamicCodableKit", url: "https://github.com/SwiftyLab/DynamicCodableKit/releases/download/v{version}/DynamicCodableKit-{version}.xcframework.zip", checksum: "{checksum}"),
如果您不想使用任何上述依赖项管理器,您可以手动将 DynamicCodableKit
集成到您的项目中。
打开终端,cd
进入您的顶级项目目录,如果您的项目未初始化为 git 仓库,请运行以下命令
$ git init
通过运行以下命令将 DynamicCodableKit
添加为 git 子模块
$ git submodule add https://github.com/SwiftyLab/DynamicCodableKit.git
打开新的 DynamicCodableKit
文件夹,并将 DynamicCodableKit.xcodeproj
拖到您的应用程序 Xcode 项目或现有工作区中的项目导航器中。
它应该嵌套在您的应用程序蓝色项目图标下方。 它位于所有其他 Xcode 组之上还是之下并不重要。
在项目导航器中选择 DynamicCodableKit.xcodeproj
并验证部署目标是否满足您的应用程序目标(应该小于或等于)。
接下来,在项目导航器(蓝色项目图标)中选择您的应用程序项目,以导航到目标配置窗口,并在侧边栏中的 Targets
标题下选择应用程序目标。
在该窗口顶部的标签栏中,打开“常规”面板。
单击 Frameworks and Libraries
部分下的 +
按钮。
您将看到 DynamicCodableKit.xcodeproj
文件夹,其中嵌套了 DynamicCodableKit.framework
。
选择 DynamicCodableKit.framework
,就完成了!
DynamicCodableKit.framework
会自动添加为目标依赖项、链接框架和构建阶段中嵌入的框架,这些都是在模拟器和设备上构建所需的全部内容。
您也可以直接从 GitHub 发布页面下载预构建的工件
从 GitHub 发布页面下载格式为 DynamicCodableKit-{version}.xcframework.zip
的工件,其中 {version}
是您要使用的版本。
从存档中提取 XCFramework,并将 DynamicCodableKit.xcframework
拖到 Xcode 项目中应用程序目标文件夹的项目导航器中。
选择 如果需要则复制项目
,就完成了!
DynamicCodableKit.xcframework
会自动添加到嵌入的Frameworks and Libraries
部分中,进而添加到构建阶段的链接框架中。
有关 API 详细信息和示例场景的文章,请参阅完整的文档。
如果您希望贡献更改,建议任何改进,请查看我们的贡献指南,检查是否有未解决的问题,是否已经在处理,或者打开拉取请求。
DynamicCodableKit
在 MIT 许可证下发布。 有关详细信息,请参阅 LICENSE。