用CloudKit Schema语言定义和更新您的架构。
https://developer.apple.com/documentation/cloudkit/integrating_a_text-based_schema_into_your_workflow
概述
CloudKit的文本表示法允许您同时管理您的架构和依赖于它的应用源代码。CloudKit命令行工具可以下载、验证和安装架构到您的容器的沙箱环境中,而CloudKit仪表板则将架构升级到生产环境。
当发布一个架构时,CloudKit尝试应用更改到现有架构(如果存在的话),将其转换为新架构中指定的格式。如果所需的修改可能导致当前生产架构(如删除已存在的记录类型或字段名)的潜在数据丢失,那么架构就不有效,CloudKit不会做任何更改。
对于有现有架构的容器,使用CloudKit命令行工具下载容器的架构。不建议手动构建您现有的架构,因为任何错误都可能导致您现有的沙箱数据变得无法访问。一个好的做法是将架构整合到您的源代码仓库中。
学习CloudKit Schema语言语法
CloudKit Schema语言的语法包含了定义您的架构所需的所有元素。使用语法来创建角色,声明记录类型及其权限,以及为记录中的每个字段指定数据类型和选项。
然后,文章给出了创建架构、创建角色、记录类型、字段选项和数据类型的具体语法规则和定义。
附加细节和指南
文中还提供了有关创建角色、记录类型、类型名、字段名、数据类型和权限的附加细节和指南。它解释了每个字段和选项的含义和用途,以及如何使用它们来定义和控制您的CloudKit架构。
它还描述了语言的一些约定和规则,以及如何使用注释来注释您的架构文件。
识别隐式字段和角色
最后,它描述了所有记录类型都有哪些隐式定义的字段和角色,并提供了一个示例架构,展示了如何定义一个简单的公司部门和员工信息架构,以及如何扩展系统字段的属性和引用系统标识符所必需的双引号。
总结:
这篇文章为开发者提供了一个指南,解释了如何使用CloudKit Schema语言来定义和更新CloudKit数据库的架构。CloudKit Schema语言是一种基于文本的语言,允许开发者用代码的方式来定义CloudKit数据库的架构,而不是通过图形界面。
该文档强调了以下几点:
- 通过CloudKit命令行工具和CloudKit仪表板来管理和更新架构。
- CloudKit尝试将新的架构更改应用到现有架构,以避免潜在的数据丢失。
- 推荐将架构整合到源代码仓库中,而不是手动构建。
- 提供了CloudKit Schema语言的具体语法和规则,包括如何定义记录类型、字段和角色,以及如何指定字段的数据类型和属性。
- 描述了隐式字段和角色,这些是所有记录类型自动拥有的,而不需要显式定义。