用途:为 iOS 17+ / macOS 14+ 应用生成生产可用的 CloudKit 同步基础设施,使用 CKSyncEngine 替代手动 CKOperation 链。触发场景包括添加 iCloud 同步、跨设备同步、CloudKit/CKSyncEngine 相关需求、通过 iCloud 共享数据、冲突解决、CKRecord/CKShare/CKRecordZone 等。
主要能力:生成 SyncEngine(含 CKSyncEngineDelegate)、SyncConfiguration、RecordMapping(CKRecord 与本地模型互转)、ConflictResolver(server-wins、client-wins、时间戳合并、自定义合并)、SyncMonitor(账号与同步状态)、CloudSyncError;启用共享时额外生成 ShareManager 与 ShareParticipantView。可适配 SwiftData、Core Data、自定义/内存或全新本地存储。
使用方式:生成前检查部署目标、现有 CloudKit 代码、entitlements 与持久化层;确认数据模型、数据库范围(仅私有或私有+共享)、冲突策略与持久化层。生成后按项目结构放置文件,配置 iCloud/CloudKit 能力与容器标识,在 App 启动时启动 SyncEngine,通过 addPendingChange 提交本地变更,并由 delegate 自动转换远端变更。提供集成与验证清单,并说明测试账号状态与冲突解决的方法。
适用场景:需要将用户数据在自有设备间同步,或通过 CKShare 与他人协作的 Apple 平台应用。
限制:要求 iOS 17 / macOS 14 / watchOS 10 / tvOS 17 及以上,需 CloudKit entitlement 与设备已登录 iCloud;低于该目标不支持 CKSyncEngine,需改用旧 CKOperation 方案(本技能不覆盖)。生产 schema 需在 CloudKit Dashboard 显式部署,仅可增量添加字段;可查询字段需配置索引;CloudKit 有按用户限速。价格与收费信息暂未提供。