Kinvey Swift SDK 是一个可以用来在 Kinvey 平台上开发 iOS 应用程序的软件包。请参考 Kinvey 开发者中心 获取关于使用 Kinvey 的文档。
在库的第 3 个版本中，所有新代码都用 Swift 编写，任何使用 v3 的应用程序也必须使用 Swift 来访问 API。
当我们将从 Objective C 迁移到最新的 Swift 版本时，我们将使用以下分支方案。请根据您使用的语言/版本选择我们库的正确版本
| 语言 / 版本 | Kinvey SDK 版本 | 开发分支 |
|---|---|---|
| Swift 3 和 Swift 4 | 3.3.0 及以上 | master |
| Swift 2.3 | 3.2.x | 3.2 |
| Objective-C | 1.x | 1.x |
注意
master分支代表 SDK 的最新发布版本。 有关提交代码的详细信息，请参阅 CONTRIBUTING 指南。- 在 1.x 版本上，请使用
KinveyKit工作区。 在所有其他版本上，请使用Kinvey工作区。
您需要安装 Carthage、Jazzy 和 Xcode 命令行工具 才能构建 SDK。
make：依次运行 build、archive、pack 和 docs 命令，这将构建和打包项目，并使用Jazzy生成文档文件。
检查 Makefile 文件以获取所有可用命令
使用 Xcode 运行单元测试。
- 在 Xcode 中打开文件
Kinvey.xcworkspace - 选择
Kinvey方案 - 选择菜单项
Product->Test或按Command+U
或运行命令行
make test
Important Note: adding the environment variables KINVEY_APP_KEY, KINVEY_APP_SECRET and KINVEY_MIC_APP_KEY will allow you to run the tests against a real Kinvey environment.
我们使用 GitFlow 工作流程以进行更好的管理。
发布新版本 SDK 的工作流程如下
- 合并 develop 分支上所有等待处理的 pull 请求 / 功能分支。
- 通过在 develop 分支上运行
make set-version来提升版本号。 - 检出 master 分支并合并 develop 分支。
- 使用 git 标记版本。
- 推送所有更改。
- 上传包含 Amazon AWS 所有二进制文件的 zip 文件。
- 运行
make deploy-cocoapods以发布 CocoaPods 的新版本 - 在 DevCenter 存储库中发布
release notes、API Reference Docs和Download部分。 - 推送所有更改以进行部署。
- 向
Customer Service和Development团队发送包含发行说明的电子邮件
更新 SDK 版本应遵循 语义化版本 2.0.0
- Major (x.0.0)：进行不兼容的 API 更改时。
- Minor (3.x.0)：以向后兼容的方式添加功能时。
- Patch (3.0.x)：进行向后兼容的错误修复或增强时。
有关详细信息，请参阅 LICENSE。
有关报告错误和做出贡献的详细信息，请参阅 CONTRIBUTING.md。