Appearance
iCloud云同步
iCloud 云同步把同一 Beannns 账号在各台设备上的咖啡记录、偏好和类型按修改时间合并，再写回这些设备。记下这一杯，见添加咖啡。类型和排序，见类型管理、类型排序。
iCloud云同步是做什么的？
换手机，或同时用两台设备时，后改的那一杯、后调的规格和类型会出现在另一台上。每一条记录、每一种类型、每一项偏好各自比较修改时间，较新的留下。
关掉同步之后，已经在这台设备上的内容仍留在本机。
在哪里打开？
打开 Beannns，进入「我的 → iCloud同步」。这一页的标题是「iCloud同步」。第一项是「iCloud云同步」，副标题是「在设备间同步数据」，右侧有 Pro 标记。
点这一项要先登录，并且是有效会员。未登录会提示「请登录账号」。未开通时标题为「会员专属」，说明「开通会员后可以使用这项功能」，可点「开通会员」。
进去之后，页面标题就是「iCloud云同步」。第一张卡片是「开启同步」，右侧有 Pro 标记和开关。开关下的说明是：「记录、偏好和类型按修改时间合并，同步到同一 Apple ID 的其它设备。」再往下是「点此查看 iCloud 云同步教程」。
接着四张状态卡片：
| 项目 | 显示 |
|---|---|
| 网络 | 刚进入这一页时转圈。能访问 Beannns 服务为「正常」，否则为「异常」 |
| iCloud | 刚进入这一页时转圈。可用为「已连接」。未登录 iCloud 为「未登录」，受到限制为「受限」，暂时连不上为「暂不可用」，其余情况为「未连接」 |
| 同步状态 | 「未开启」「已开启」或「同步中」 |
| 最近同步 | 成功合并过则显示当时的日期和时间，形如 2026-10-08 13:05。还没有成功合并过为「暂无记录」 |
再下面两个开关：「iCloud异常通知」「网络异常通知」。页脚「同步遇到问题？点此咨询」会打开常见问题。
同一页往下还有「iCloud备份」和「数据管理」。备份是另外存文件，和这里的自动合并分开，见下文。
打开前要准备什么？
每台要参与同步的设备需要同时满足：
- 使用 iPhone 或 iPad。在系统「设置」中登录 iCloud。各台设备使用同一个 Apple ID。
- 在 Beannns 里登录同一个账号，并且这个账号是有效会员。
- 设备能上网，页面上「网络」为「正常」，「iCloud」为「已连接」。
每台设备都要自己打开「开启同步」。这个开关留在本机，不会跟到另一台。
记录、类型和偏好在「iCloud」为「已连接」后就会同步。带照片的那一杯还要能写入 iCloud 云盘：在系统「设置」里打开 iCloud 云盘。云盘没打开时，这一杯先留在本机，等照片能写进去再整杯送出；没有照片的修改仍会同步。
其它系统上「iCloud」为「未连接」，同步不会进行。
默认是怎样的？
第一次进入时：
| 项目 | 初始值 |
|---|---|
| 开启同步 | 关 |
| iCloud异常通知 | 开 |
| 网络异常通知 | 开 |
| 最近同步 | 暂无记录 |
「iCloud异常通知」和「网络异常通知」可以各自关掉。页面上的「网络」和「iCloud」两张卡片仍会显示当前是否正常。
同步开着，并且对应通知也开着时，网络或 iCloud 出问题会在应用里提示一次：「网络异常，暂时无法云同步」或「iCloud异常，暂时无法云同步」。同一次故障不会反复弹。恢复正常之后，或把这个通知关掉再打开，才会再提示。
什么时候会同步？
第一次打开「开启同步」会马上同步一次。之后这台设备上的改动大约两秒后送出。短时间里连续修改会合成一次，不会每改一个字段就各跑一轮。
下面这些时候也会再同步一次：
- 把应用从后台切回前台。
- 应用一直停在前台时，距上次检查大约满 30 分钟。退到后台后，这个间隔停下来；回到前台由上面那一次接手。
- 在首页或统计页下拉。松手后马上同步，转圈等到这次结束再收起。设置、记笔记、关于、类型管理没有这个下拉。
进行中时「同步状态」为「同步中」。记录、类型和偏好都取到，并且和本机合并完成之后，「最近同步」写成完成当时的本地时间。
查询或写入失败后，自动同步会先停至少 10 分钟。这段时间里，改数据和到点检查都不会再连 iCloud。首页或统计页的下拉仍然会试。若 iCloud 要求等更久，就按它要求的时间再自动试。
这一次没能把云端取全时，「最近同步」不往前跳，本机内容也不被云端覆盖。本机如果还有没送出的修改，会先把这些修改送出去。没有待送出的修改时，这一轮不上传。
会同步哪些内容？
咖啡记录
种类、规格、糖度、温度、咖啡因、糖量、价格、评分、自定义名称、日期、备注、照片。自制咖啡写进备注的豆子和冲煮，跟着这一条走。
删掉某一杯也会同步。另一台较新的删除会把这一杯去掉；若另一台在删除之后又改过同一条，则留下较新的那一版。
照片跟着胜出的那一条。照片内容没变过，就不会重复上传。另一台收到的是这张照片，不会再单独造一份抠图。这台本来就有这一杯时，本机已经生成的抠图还留着。较新的版本里没有照片时，合并后这一条也不带照片。
咖啡类型
名称、图标、规格、糖度、温度、咖啡因、糖量。预置的美式、拿铁等按名称对齐，后改的默认值会盖过另一边较旧的。自己添加的类型按各自的身份合并。
两边出现同名类型时，较新的保留原名，较旧的会在名称后加上序号，例如「手冲 (2)」。删掉某一种时，删除同样按时间生效。列表里的先后按类型排序自己的修改时间合并。
偏好
每一项单独比较修改时间。手机上改了规格映射、平板上改了首页样式，两边都会留下。
同一条两边都改过会怎样？
以修改时间为准，较新的一份写回各台设备。修改时间相同，则用较晚导出的那一份。导出时间也相同，则固定留下其中一份，之后再同步仍是这一份。
一条记录、一种类型、一项偏好各自比较。只换掉较新的那一条，其余保持原样。
同一个 Apple ID 下面，只有当前这个 Beannns 账号的内容会并进来。
和 iCloud 备份怎么分开？
「我的 → iCloud同步」里有两套能力：
| 云同步 | 备份到 iCloud | |
|---|---|---|
| 入口 | iCloud云同步 → 开启同步 | iCloud备份里的「备份到 iCloud」「从 iCloud 恢复」 |
| 何时发生 | 打开后按上面的时机自动合并 | 点一次，多存一份文件 |
| 已有数据 | 本机和各设备按修改时间并在一起 | 恢复时用所选备份覆盖当前的记录；备份里若有基础配置和类型配置，也会替换当前的 |
| 再操作一次 | 继续合并较新的修改 | 再存一份新文件，已有备份文件仍留着 |
点「iCloud云同步」、打开云同步、备份到 iCloud、从 iCloud 恢复，都要登录并且是有效会员。备份和恢复还要在系统「设置」中登录 iCloud，并打开 iCloud 云盘。云盘没开时会提示「请先在系统设置中登录 iCloud，并打开 iCloud 云盘」。iCloud 里没有当前版本能恢复的备份时，提示「iCloud 中没有可用的备份」。
从备份恢复之后，恢复进来的记录、类型和偏好比云端更旧的副本新。之后再同步，不会被恢复之前的旧内容盖回去。恢复之后两边又改过的，仍按修改时间取较新的一份。
同一页「数据管理」里的「备份数据」保存到系统创建的本地文件夹。文件夹里已有备份时，再存一份新文件，已有文件不会被覆盖。「恢复数据」从中选择一份，覆盖其中的记录；备份里若有基础配置和类型配置，也会替换当前的。登录后即可使用这两项。
关掉之后会怎样？
关掉「开启同步」不需要再次校验会员。这台设备不再上传，也不再拉取。已经记下的咖啡、类型和偏好留在本机。另一台仍开着同步的设备，继续在它们之间合并。
再次打开后，会把这段时间里各边较新的修改并回来。
对不上或状态异常时怎么办？
- 网络为「异常」：检查这台设备是否联网，以及能否访问 Beannns。连上后回到这一页，或把应用切到前台，状态会重新检查。
- iCloud为「未登录」：到系统「设置」登录 iCloud。
- iCloud为「受限」：这台设备上的 iCloud 受到限制，例如屏幕使用时间或描述文件。放开限制后再回到这一页。
- iCloud为「暂不可用」：iCloud 暂时连不上，过一会儿再打开应用看一次。
- iCloud为「未连接」：确认这台是 iPhone 或 iPad。仍是未连接时，把应用切到前台再看一次。
- 带照片的那一杯一直不到另一台，没有照片的记录已经过去了：到系统「设置」打开 iCloud 云盘。照片写进去之后，这一杯会在下一次同步送出。
- 同步状态停在「已开启」，最近同步仍是「暂无记录」，或时间不再往后走：确认已经登录 Beannns，且登录的是这台设备第一次成功同步时的那个账号。换了一个 Beannns 账号之后，这台设备不会把新账号的数据写入原来那份同步，也不会把原来的同步拉下来。换回原来的账号后会继续。查询失败时「最近同步」同样停在上一次成功的时间。
- 另一台没有出现新记录：那一台也要打开「开启同步」，并使用同一个 Apple ID、同一个 Beannns 账号。打开那一台应用并留在前台，或在首页、统计页下拉一次，等「最近同步」更新。