page.title=針對應用程式進行自動備份 page.tags=backup, previewresources, androidm page.keywords=backup, autobackup, preview page.image=images/cards/card-auto-backup_2x.png @jd:body

本文件內容

  1. 總覽
  2. 設定資料備份
  3. 測試備份設定
  4. 已知問題

使用者通常會在應用程式中花費很多時間精力建立資料和設定偏好設定。 如果使用者換掉壞掉的裝置或升級到新的裝置時，能夠保存裝置上的資料，就能夠讓使用者獲得良好的體驗。 執行 Android M 預覽版系統的裝置可以協助在上述情況自動將應用程式資料備份到 Google 雲端硬碟，讓使用者獲得良好的體驗。 如果使用者變更或升級裝置，應用程式資料會自動儲存。

在執行 Android M 預覽版的裝置上安裝的所有應用程式，預設都會啟用自動備份。不需要任何額外的應用程式程式碼。 系統則提供使用者不進行自動備份資料的選項。 您也可以選擇限制要備份應用程式的哪些資料。

本文件說明新的系統行為，以及如何指定備份應用程式的哪些資料。

總覽

自動備份功能保存應用程式資料的方法，是將使用者裝置上建立的資料上傳到使用者的 Google 雲端硬碟帳戶，然後將資料加密。 儲存資料不會向您或使用者收費，儲存的資料也不會計入使用者個人雲端硬碟的容量配額。 在 M 預覽版期間，使用者最多可以為每個 Android 應用程式儲存 25 MB 的資料。

當裝置閒置、正在充電且連線到 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 屬性指定應用程式開發專案的 res/xml/ 目錄中，名為 mybackupscheme.xml 的 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

已知問題

以下是自動備份服務的已知問題：