page.title=自动备份应用 page.tags=备份, 预览版资源, androidm page.keywords=备份, 自动备份, 预览版 page.image=images/cards/card-auto-backup_2x.png @jd:body

本文内容

  1. 概览
  2. 配置数据备份
  3. 测试备份配置
  4. 已知问题

通常,用户需要投入大量的时间和精力在应用内创建数据和设置首选项。 如果用户更换破损设备或升级至新设备,则保留用户数据对于确保提供卓越的用户体验至关重要。 在这些情况下,运行 Android M 预览版系统的设备可以通过将应用数据自动备份到 Google Drive,帮助确保提供卓越的用户体验。 这样,即使用户更换或升级设备,应用数据也可自动恢复。

对于运行 Android M 预览版的设备中所有已安装的应用,均可启用自动备份。无需额外提供应用代码。 该系统允许用户选择禁止自动数据备份。 此外,您还可以选择限制要备份应用中的哪些数据。

本文介绍了新系统行为,阐述了如何指定要为应用备份哪些数据。

概览

自动备份功能可以通过将应用在用户设备中创建的数据上传到用户的 Google Drive 帐户并进行加密,来保留这些数据。 您或用户无需为数据存储付费,且保存的数据不计入用户个人的 Drive 配额。 在 M 预览版运行期间,用户可针对每个 Android 应用存储多达 25MB 的数据。

当设备处于空闲、充电以及连接至 Wi-Fi 网络时,会每 24 小时自动备份一次数据。 满足上述这些条件后,备份管理器服务会将所有可用的备份数据上传至云端。 当用户改用新设备或卸载并重新安装备份的应用时,恢复操作会将备份的数据复制到新安装的应用的数据目录中。

注:如果应用使用旧版 Android 备份服务,则此新行为不适用,不过现有的备份行为会照常运行。

自动排除的数据文件

并非所有应用数据均应备份,例如临时文件和缓存文件就无需备份,因此自动备份服务会默认排除如下一些特定的数据文件:

配置数据备份

除了上一部分中列出的自动排除的文件外,凡 M 预览版设备中安装的任何应用所创建的数据均会备份。 您可以使用应用清单文件中的设置,进一步限制和配置应用中的哪些数据需要备份。

包括或排除数据

根据应用所需的数据及其保存方式,您可能需要针对包括或排除哪些特定的文件或目录设置具体的规则。 自动备份服务支持使用 XML 配置文件和应用清单文件来设置这些备份规则。 您可以在应用清单文件中指定备份架构配置文件,如下例所示:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        package="com.my.appexample">
    <uses-sdk android:minSdkVersion="MNC"/>
    <uses-sdk android:targetSdkVersion="MNC"/>
    <app ...
        android:fullBackupContent="@xml/mybackupscheme">
    </app>
    ...
</manifest>

在此示例代码中,android:fullBackupContent 属性指定了一个 XML 文件。该文件名为 mybackupscheme.xml,位于应用开发项目的 res/xml/ 目录中。 此配置文件包括关于要备份哪些文件的规则。 下列示例代码显示了将某一特定文件排除在备份之外的配置文件:

<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
    <exclude domain="database" path="device_info.db"/>
</full-backup-content>

此示例备份配置仅将一个特定数据库文件排除在备份之外。 所有其他文件均予以备份。

备份配置语法

您可以通过备份服务配置指定备份中要包括或排除哪些文件。 数据备份配置 xml 文件的语法如下:

<full-backup-content>
    <include domain=["file" | "database" | "sharedpref" | "external" | "root"] path="string" />
    <exclude domain=["file" | "database" | "sharedpref" | "external" | "root"] path="string" />
</full-backup-content>

您可以使用下列元素和属性指定备份中要包括或排除哪些文件:

禁止数据备份

通过在清单文件的应用元素中将 android:allowBackup 属性设置为 false,您可选择阻止自动备份任何应用数据。 此设置如下列示例代码所示:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        package="com.my.appexample">
    <uses-sdk android:minSdkVersion="MNC"/>
    <uses-sdk android:targetSdkVersion="MNC"/>
    <app ...
        android:allowBackup="false">
    </app>
    ...
</manifest>

测试备份配置

创建备份配置后,您应立即进行测试,确保应用能够保存数据,且数据能够正确恢复。

启用备份日志记录

要帮助确定备份功能如何解析 XML 文件,请在执行测试备份之前启用日志记录功能:

$ adb shell setprop log.tag.BackupXmlParserLogging VERBOSE

测试备份

要手动运行备份,您首先必须通过调用下列命令初始化备份管理器:

$ adb shell bmgr run

然后,使用下列命令并以 <PACKAGE> 参数指定应用的软件包名称来手动备份应用:

$ adb shell bmgr fullbackup <PACKAGE>

测试恢复

要在备份应用数据后手动启动数据恢复,请调用下列命令,并以 <PACKAGE> 参数指定应用的软件包名称:

$ adb shell bmgr restore <PACKAGE>

警告:执行恢复操作之前,此操作将阻止您的应用运行并擦除其数据。

您可以通过卸载并重新安装应用来启动数据恢复进程。应用安装完成后,系统会立即自动从云中恢复应用数据。

诊断备份问题

如果遇到问题,可通过在设置 > 备份中先关闭然后重新打开备份、将设备恢复出厂设置或者调用以下命令,来清除备份数据及关联的元数据:

$ adb shell bmgr wipe <TRANSPORT> <PACKAGE>

<TRANSPORT> 值必须以 com.google.android.gms 为前缀。 要获取传输列表,请调用下列命令:

$ adb shell bmgr list transports

已知问题

以下是自动备份服务的已知问题: