开发
开发
选择平台

云备份

云备份是备份设备应用数据的系统。这包括将参与应用的进度和设置备份到云端，这样用户就可以回到上一次使用的应用位置。这使得在新头戴设备上使用应用、重新安装应用或重置设备变得更容易。云备份使用 Android 自动备份⁠。
云备份的运作级别为文件系统级别，无需编码。应用默认启用云备份，您可以选择禁用或通过开发者面板进行调整。为保护云备份数据的安全，个人设备中的应用数据已加密，且在我们的服务器中也将保持加密状态。
用户可以在头戴设备设置中禁用云备份。

应用用户用例

如何查看和删除我拥有的应用的云备份？

如需查看所有应用的现有备份，请前往 Meta Quest 网站上的云备份⁠选项卡。
在此页面上，您将看到您所拥有的应用列表，以及可以按名称搜索的筛选条件。如果应用在云端已有备份，页面上会显示时间戳、大小和删除备份的选项。

我拥有的应用何时会进行备份？

备份会在以下时间自动进行：
  • 每晚一次，当设备处于空闲状态，充电并连接至 Wi-Fi 时，类似于系统更新操作系统的时间。
  • 当应用被卸载时，如果应用是从商店安装的
  • 每次退出应用时，每六个小时最多备份一次
每个用户在每个头戴设备上购买的每个应用拥有多个备份“槽”，且每次备份运行不会覆盖之前的槽。除自动备份外，用户还可以前往设备设置中的云备份选项卡，手动请求备份。

我拥有的应用何时会还原云备份数据？

安装应用时，云备份会自动还原最新备份。用户可以前往云备份⁠网页，决定还原哪些备份。用户还可以在此处随时请求手动还原指定备份。

一台设备生成的云备份数据会转移到其他设备上吗？

是。如果云备份无法找到特定应用和设备配对的数据，那么它将在您拥有的所有设备上还原该应用的最新备份。
假设一名用户的 Meta Quest 2 上生成了应用的云备份数据，这名用户刚刚购买了 Meta Quest 3。在新的 Meta Quest 3 上安装应用时，由于云备份无法找到该应用的备份数据与 Meta Quest 3 有关联的实例，因此云备份系统将还原 Meta Quest 2 上的备份数据。
在 Meta Quest 3 上执行云备份后，这些数据将被备份到 Meta Quest 3 头戴设备上所购买的应用的“槽”。除此之外，Meta Quest 2 和 Meta Quest 3 的云备份将出现差异。
如果用户希望在两台头戴设备之间复制云备份数据，可以前往 Meta Quest 网站的云备份⁠选项卡，针对他们想要传输数据的头戴设备执行云备份数据还原。目标头戴设备将自动创建所传输的云备份数据的新槽。
云备份数据可以从新一代头戴设备（例如 Quest 3）传输到老一代头戴设备（例如 Quest 2），反之亦然。

应用开发者用例

如果我们的作品之前使用 Cloud Saves V2，我应如何启用云备份？

在开发者面板⁠中，点击开发 > 云存储。在下拉菜单中选择您的应用。在云存储⁠页面上，确保启用自动云备份已开启。
如需详细了解如何正确存储数据，请参阅技术实现。

如果我不想为作品使用云备份了，应如何关闭？

前往开发者面板⁠，在开发 > 云存储下，关闭启用自动云备份。

技术实现

只在支持的目录中存储应用数据，不超过 100MiB 的限制，并且已在开发者面板中为应用启用云备份。
如果满足上述条件，应用将自动备份。

将被备份的目录

自动备份⁠包括系统分配给应用的大多数目录中的文件。您可以通过上下文对象⁠找到并访问这些文件的位置：
请注意，应用根目录中的自定义文件夹不会被备份。如果您想要创建自定义文件夹，应在由 getFilesDir()⁠ 返回的目录中创建。
已备份的文件夹
/data/data/<package-name>/files/
/data/data/<package-name>/<custom-folder>/
/sdcard/Android/data/<package-name>/files/
不备份的文件夹
/data/data/<package-name>/cache/
/data/data/<package-name>/no_backup/
/sdcard/Android/data/<package-name>/cache/
/sdcard/Android/data/<package-name>/<custom-folder>

不会被备份的目录

Android 自动备份不会备份由 getCacheDir()⁠、getCodeCacheDir()⁠ 和 getNoBackupFilesDir()⁠ 返回的目录中的文件。保存在这些位置的文件只是暂时需要的，因此特意不用进行备份操作。
此外，任何在 getFilesDir()⁠ 内名为 UnityCache 的文件夹也不会被备份。
默认情况下，不进行备份的目录是 cache/ 和 UnityCache/
您也可以在开发者面板⁠中，前往开发 > 云存储，自定义无需进行备份的文件/文件夹。在指定无需备份的自定义文件时，请注意以下事项：
  • 您只能指定与软件包的内部/外部文件目录相关的路径（即由 getFilesDir()⁠ 或 getExternalFilesDir()⁠ 返回的目录）。
    • 例如：如果您想排除的数据存储在 /storage/emulated/0/Android/data/com.company.somegame/files/UE4Game/SomeGame/SomeGame/BigFiles/SomeFile.txt 下，您需要将 UE4Game/SomeGame/SomeGame/BigFiles/SomeFile.txt 指定为排除路径。
  • 如果您指定了自定义文件排除，所有匹配的文件/文件夹都将从内部/外部文件目录中排除。您无法指定两个目录中哪个为目标目录。
  • 您不能使用通配符。路径必须是确切的文件或文件夹。
如需对文件/文件夹包含和排除进行更精确的控制，请参阅 Android 自动备份包含文件文档⁠，了解更多信息。

DLC 文件应该存储在会进行备份的目录中吗？

请将 DLC 保存游戏文件和配置文件放入其中一个会进行备份的目录中。
不要将 DLC 素材文件放入备份目录中。
素材应被放入排除目录中，这样素材就不会被备份。如果总大小超过 100MiB，就会导致备份失败。即使不这样，也可能导致用户体验变差。首先，用户将上传很多无用的信息。此外，如果他们删除应用，然后更新应用后重新安装，他们很可能会浪费时间下载旧版本的文件，而这些文件几乎立即就会被更新。DLC 权利能让他们再次正常下载这些文件。

开发者如何检查上一次应用进行备份的时间？

您可以前往 Meta Quest 网站的云备份⁠页面，查看应用上一次备份的时间。
您也可以前往位于 Meta Quest 设备的设备设置中的云备份选项卡查看。

开发者如何检查哪些文件会进行备份？

您可以在执行备份时通过监控 Logcat 来验证哪些文件会进行备份。日志应被输出，并指出备份中包含哪些文件及其相应的大小。这有助于检查您的应用是否超过 100MB 的备份限制和检查哪些文件在应用备份中占用较大空间，或者有助于验证任何最近实现的文件排除/包含规则是否正常运作。
您可以运行以下 adb 命令来筛选 Logcat，只获取与备份相关的日志：
adb logcat | grep Backup

测试

测试云备份

Android 框架 bmgr 命令可用于测试备份系统。请使用以下命令，强制指定软件包运行备份。
bmgr backupnow --monitor-verbose <package-name>
命令可以直接从本地主机使用 adb shell 运行，也可以从设备上的 ADB 框架会话运行。
您可以通过运行没有选项的命令，详细了解 bmgr。
重要注意事项：ADB 还原命令在 v35 中无法运行。不过，您可以使用以下解决方法：还原将在安装应用时进行。目前，您无法强制从 ADB 还原。您无法强制进行备份，然后使用另一台头戴设备，强制备份立即在该设备上还原。不过，您可以通过卸载并在另一台头戴设备上重新安装来强制还原。
注意：这不等同于“ADB 备份”，ADB 备份不受支持。

出于测试目的切换已发布的应用的云备份开关

注意：如果您打算这样做，我们建议您要非常小心，并且我们不建议您在已发布的应用上这样做。
您可以在设备设置中使用云备份开关来关闭备份和还原功能。所有用户默认开启此功能。您可以使用存储设置窗口中的新按钮来清除特定应用的数据。
您也可以在开发者面板⁠中为应用关闭云备份。在开发 > 云存储下，关闭启用自动云备份。

疑难解答

目录未备份的常见原因是什么？
应用数据不符合条件的常见情况如下：
  • 应用数据位于不受支持的目录中（例如根目录中的自定义文件夹）
  • 应用数据大小超过 100 MiB
  • 开发者不小心排除了包含保存数据的目录
是否需要更新或打开应用才能进行备份？
通常来说不需要，假设应用具备备份资格且备份符合要求（如上文所述），备份将自动进行。
用户如何手动触发备份（例如在恢复出厂设置之前）？
用户和开发者都可以在设备设置的云备份窗口中启用临时备份。开发者还可以在 ADB 上使用 bmgr 命令测试临时备份。
如果用户使用旧版本的操作系统，且没有开启 Meta Quest，会怎么样？他们可以开启并备份保存的数据吗？
除非头戴设备已安装 v35 版操作系统，否则云备份不会触发。操作系统更新的通用要求适用。
如何删除单个保存数据？
前往云备份⁠页面。每个保存数据旁边都有一个删除选项。点击该选项即可删除该应用在云端的保存数据。请注意，删除是永久性操作。如果您删除了该应用的所有备份数据，数据将从云端消失。应用可能在多台设备上有备份数据，若要完全删除所有云端数据，您可能需要在拥有的所有设备上删除该应用的备份。
当用户在多台设备上有应用数据时，会存储什么备份？
每台设备都有自己的备份历史。一台设备上生成的备份不会冲突或覆盖其他设备上生成的备份。
每个应用可存储多少备份？
每个应用在每台设备上最多可存储五个备份。此外，应用最旧的两个备份会在生成后保留最多一周时间，然后再用新的备份覆盖它们。
每当我卸载应用时，系统会说我的数据可能会被永久删除。这是否意味着云备份没有运作？
不，这只是为了向您提供警告。卸载应用会移除本地的数据，但不会删除任何云备份。查看您个人主页的云备份⁠，或前往设备设置的云备份选项卡，确认备份安全地存储在云端上。
导航徽标
虚拟现实 / Meta Horizon
虚拟现实 / Meta Horizon
虚拟现实 / Meta Horizon
中文(简体)
© 2026 Meta