CD_entityName(Record Types)

CD_entityName 是一个 特殊的字段，但它并不是 CloudKit 自行生成或默认管理的字段，而是在结合 Core Data 和 CloudKit 使用时由 Core Data 自动生成并管理的一个字段。

这个字段的主要作用是为每个存储在 CloudKit 上的记录 (Record) 指定其在 Core Data 中对应的实体名称 (Entity Name)，从而在同步和解析数据时能够正确关联到 Core Data 模型。

`CD_entityName` 的作用 #

当你将 Core Data 与 CloudKit 集成（通过 Core Data 的 CloudKit-backed persistent container 配置）时，Core Data 在与 CloudKit 同步时，会为每个对象（在 CloudKit 中对应于 Record）生成一条 CD_entityName 字段。这是一个特殊的字段，用于存储 Core Data 中实体的名称。

具体作用：

标识实体类型：
- 多个 Core Data 实体可能共享一个 CloudKit 数据库，因为 CloudKit 的 RecordType 并不直接反映 Core Data 的数据模型结构。
- 通过 CD_entityName 字段可以标记当前记录对应的是哪个 Core Data 实体。
同步数据时的解析：
- 在将 CloudKit 的记录同步回 Core Data 时，Core Data 会解析 CD_entityName 字段来匹配记录的对应实体。
- 这样可以确保即使在 CloudKit 数据库中同时管理多个实体类型的数据，也能够正确匹配到 Core Data 模型中。
跨多个实体管理数据：
- 如果你在 Core Data 中有多个实体（如 Todo 和 Note），它们分别映射到不同的 Record 类型，通过 CD_entityName，CloudKit 能够正确地将记录区分开来。

`CD_entityName` 的来源和生成规则 #

字段来源：
- 在启用了 CloudKit 支持的 Core Data 中，CD_entityName 是 Core Data 自动生成 的字段，不需要开发者手动添加。
- 它是 Core Data 和 CloudKit 同步特性中的一部分。
生成规则：
- 对于每一个 Core Data 的实体（Entity），Core Data 会在与 CloudKit 同步时，将实体的 名称（Entity Name） 作为 CD_entityName 的值写入 CloudKit 中。
- 示例：
  - 一个 Core Data 实体 Todo，在 CloudKit 中生成的记录中，CD_entityName 字段的值会是字符串 "Todo"。

CloudKit 的 Record 和 `CD_entityName` 结构实例 #

假如我们有一个 Core Data 模型，包含以下两个实体：

Todo
- 属性：title（String）、dueDate（Date）。
Note
- 属性：content（String）、createdDate（Date）。

在结合 CloudKit 使用时，数据会以 Record 的形式同步到 CloudKit 中。

对应每个实体数据，CloudKit 会增加一个特殊字段 CD_entityName。

示例记录：

Todo Record 在 CloudKit 中可能如下：

RecordType: Todo
Fields:
  - CD_entityName: "Todo" // 指示这是 Core Data 中的 "Todo" 实体
  - title: "Buy groceries"
  - dueDate: 2023-10-25
  - <CloudKit Metadata> (如 createdTimestamp、recordName 等)

Note Record 在 CloudKit 中可能如下：

RecordType: Note
Fields:
  - CD_entityName: "Note" // 指示这是 Core Data 中的 "Note" 实体
  - content: "Meeting notes"
  - createdDate: 2023-10-24
  - <CloudKit Metadata>

通过 CD_entityName 字段，CloudKit 和 Core Data 能够正确匹配和区分数据的来源和实体。

`CD_entityName` 的重要性 #

针对 Core Data 而生： 这一字段不会出现在手动创建的 Record 中，是 Core Data 和 CloudKit 集成的一个产物，属于 自动管理字段。
开发者无需额外操作： 当你使用 CloudKit 支持的 Core Data 堆栈时，CD_entityName 会被自动添加、更新和管理。
同步可靠性：
- 在同步数据时，Core Data 会依赖 CD_entityName 字段来判断 CloudKit 记录应当归属到哪个 Core Data 实体。
- 没有这一字段，CloudKit 和 Core Data 无法高效、正确地彼此协作。

常见问题 #

CD_entityName 是不是需要手动添加或配置？
- 不需要。当你使用基于 CloudKit 的 Core Data 堆栈时，该字段会由 Core Data 自动添加到 CloudKit 的 Schema 中。
可以删除 CD_entityName 字段吗？
- 不可以。如果删除了 CD_entityName，你将无法正确解析从 CloudKit 同步到 Core Data 的数据，导致应用数据出错。
CD_entityName 和 RecordType 有什么区别？
- RecordType 是 CloudKit 层面标识记录类型的字段，通常与 Core Data 的实体名称一一对应。
- CD_entityName 是一个特殊字段，会显式存储记录关联的实体名称，用于保证数据同步和解析的准确性。

如何在查询中使用？

如果使用的是纯 CloudKit API，可以将 CD_entityName 作为查询条件来筛选对应的实体。例如：

let predicate = NSPredicate(format: "CD_entityName == %@", "Todo")
let query = CKQuery(recordType: "Todo", predicate: predicate)

总结 #

CD_entityName 是 Core Data 和 CloudKit 整合后自动生成的字段，主要用于标识每条记录对应的 Core Data 实体名称。
它不会出现在纯的 CloudKit 使用场景中，只有在启用了 CloudKit 支持的 Core Data 模块时才会被自动管理。
这一字段的存在，保证了 CloudKit 和 Core Data 之间的数据同步、解析的准确性，开发者无需手动干预。

CD_entityName 的作用 #

CD_entityName 的来源和生成规则 #

CloudKit 的 Record 和 CD_entityName 结构实例 #