跳到主要内容

字节粘贴云同步

字节粘贴的同步目标是让 iPhone、iPad 和 Mac 的格子内容保持一致。同步包含记录本身、附件文件和预览资源。

同步链路​

  1. 用户在某一端保存格子。
  2. App 生成预览资源和附件资源。
  3. App 把记录和资源上传到 CloudKit。
  4. 另一端收到变更或主动刷新。
  5. 另一端下载记录、附件和预览资源。
  6. UI 刷新格子列表。

为什么键盘扩展不能只靠实时渲染​

键盘扩展启动时间、内存和网络能力都更受限制。它应该优先读取已经生成好的预览图，而不是在键盘里实时渲染富文本、Markdown、PDF 或画布。

亮暗模式预览​

富文本、Markdown 和画布这类内容可能需要亮色和暗色两套预览。当前设备处于暗黑模式时，UI 应该使用暗色预览；处于亮色模式时，UI 应该使用亮色预览。

同步失败排查​

  • 用户确认 iCloud 已登录。
  • 用户确认 App 的 iCloud 权限打开。
  • 用户确认主 App 已经打开过并完成账号状态检测。
  • 用户确认键盘扩展已开启完全访问。
  • 用户在主 App 中手动刷新同步。
  • 用户等待 CloudKit 推送延迟结束。