当前文档
iCloud 同步
CloudKit 同步、状态说明和本地回退。
如何开启
进入个人设置中的 iCloud 同步页面，打开同步开关。开启后，任务、标签、星球和部分设置会通过你的 iCloud 账户在设备之间同步。
开启或关闭同步后，App 可能提示你重新启动，以确保数据容器切换干净。
建议第一次开启前确认：
- 系统设置里已经登录 Apple ID。
- iCloud Drive 已开启。
- 点点记拥有使用 iCloud 的权限。
- iCloud 储存空间没有满。
状态说明
iCloud 同步页面会显示：
- 同步是否启用。
- 当前 CloudKit 是否真正运行。
- iCloud 账户状态。
- 最近同步时间或错误提示。
如果你看到本地回退提示，说明你希望启用 iCloud，但 CloudKit 当前无法启动。常见原因包括未登录 iCloud、iCloud Drive 关闭、容量不足或网络异常。
会同步什么
同步范围以 App 当前数据模型为准，主要包括任务、标签、星球收集、部分设置和相关历史记录。语音识别的临时录音不会作为长期数据保留；分享卡片保存到相册后，由系统照片权限和相册管理。
本地回退
本地回退的目的，是避免 CloudKit 出错时让数据不可访问。此时你仍然可以使用 App，只是跨设备同步可能暂停。
如果你在本地回退期间继续创建任务，这些数据仍会保存在当前设备上。等 iCloud 恢复后，再回到同步页面确认状态。大量历史数据首次迁移时，可能需要一点时间。
建议
- 在系统设置中确认已登录同一个 Apple ID。
- 确认 iCloud Drive 和点点记的 iCloud 权限打开。
- 如果提示容量不足，释放 iCloud 空间后回到同步页面重新检查。
- 大量历史数据首次同步时，给 App 一点时间完成迁移。
- 开关同步后如果 App 提示重启，请按提示重启，避免本地容器和 CloudKit 容器状态不一致。