このページは Cloud Translation API によって翻訳されました。

自動バックアップでユーザーデータをバックアップする

「アプリの自動バックアップ」を使用すると、Android 6.0（API レベル 23）以降をターゲットとして実行するアプリから、ユーザーのデータを自動的にバックアップできます。Android では、アプリのデータをユーザーの Google ドライブにアップロードすることによって保持します。Google ドライブでは、ユーザーの Google アカウントの認証情報によってデータが保護されます。Android 9 以降を搭載したデバイスでのバックアップは、デバイスの PIN、パターン、またはパスワードを使用してエンドツーエンドで暗号化されます。各アプリは、アプリユーザー 1 人あたり最大 25 MB のバックアップデータを割り当てることができます。バックアップデータは追加料金なしで保存できます。また、アプリでのバックアッププロセスのカスタマイズや、バックアップの無効化によるオプトアウトが行えます。

Android のバックアップオプションの概要と、バックアップおよび復元する必要があるデータに関するガイダンスについては、データのバックアップの概要をご覧ください。

バックアップ対象のファイル

デフォルトでは、自動バックアップの対象には、システムによってアプリに割り当てられているほとんどのディレクトリ内のファイルが含まれています。

共有の環境設定ファイル
getFilesDir() または getDir(String, int) によってアクセスされる、アプリの内部ストレージに保存されているファイル
getDatabasePath(String) から返されるディレクトリ内のファイル（SQLiteOpenHelper クラスで作成されたファイルも含む）
外部ストレージ上の、getExternalFilesDir(String) から返されるディレクトリ内のファイル

自動バックアップでは、getCacheDir()、getCodeCacheDir()、getNoBackupFilesDir() から返されるディレクトリ内のファイルは除外されます。これらの場所に保存されているファイルは、一時的に必要なファイル、バックアップ処理から意図的に除外されたファイルです。

アプリを設定して、特定のファイルを追加、除外できます。詳しくは、ファイルを追加または除外するをご覧ください。

バックアップの場所

バックアップデータは、ユーザーの Google ドライブアカウントのプライベートフォルダに保存されます。容量はアプリ 1 つあたり 25 MB に制限されています。保存されたデータは、ユーザー個人の Google ドライブの容量にカウントされません。保存されるのは最新のバックアップのみです。バックアップが作成されると、以前のバックアップはすべて削除されます。ユーザーやデバイス上の他のアプリがバックアップデータを読み取ることはできません。

Google ドライブの Android アプリでバックアップされたアプリの一覧を確認できます。アプリの一覧は、Google ドライブアプリのナビゲーションドロワー（[設定] > [バックアップとリセット]）で確認できます。

以下の例に示すように、バックアップは、デバイス、設定、有効期間ごとに別々のデータセットに保存されます。

ユーザーが 2 台のデバイスを所有している場合は、各デバイス用のバックアップデータセットが存在します。
ユーザーがデバイスを出荷時設定にリセットし、同じアカウントでデバイスを設定すると、バックアップは新しいデータセットに保存されます。古いデータセットは、アクセスされない状態が一定期間続くと自動的に削除されます。

バックアップスケジュール

以下の条件をすべて満たしている場合、バックアップが自動的に行われます。

ユーザーによってデバイスでバックアップが有効化されている。Android 9 では、この設定は [設定] > [システム] > [バックアップ] にあります。
前回のバックアップから少なくとも 24 時間経過している。
デバイスがアイドル状態である。
デバイスが Wi-Fi ネットワークに接続されている（デバイスのユーザーがモバイルデータのバックアップを有効にしていない場合）。

実際には、これらの条件はほぼ毎晩満たされますが、デバイスでバックアップが行われない可能性もあります（デバイスがネットワークにまったく接続されない場合など）。また、ネットワーク帯域幅を節約するために、アップロードはアプリデータが変更された場合にのみ行われます。

自動バックアップ中は、ファイルシステムへの書き込みが行われないようにするために、システムによってアプリがシャットダウンされます。デフォルトでは、ユーザーエクスペリエンスの低下を防ぐため、バックアップシステムはフォアグラウンドで実行されているアプリを無視します。android:backupInForeground 属性を true に設定すると、このデフォルトの動作を無効にできます。

簡単にバックアップをテストできるように、Android にはアプリのバックアップを手動で開始するためのツールが用意されています。詳しくは、バックアップと復元のテストをご覧ください。

復元スケジュール

データの復元は、アプリのインストール時に毎回行われます。アプリのインストールは Play ストアから行うか、デバイスのセットアップ時に行うか（以前にインストールしたアプリをシステムがインストールする場合）、または adb install の実行により行います。復元処理は、APK のインストール後、ユーザーがアプリを起動できるようになる前に行われます。

最初のデバイス設定ウィザードで、利用可能なバックアップデータセットのリストがユーザーに表示され、どのデータセットからデータを復元するかを尋ねられます。選択したバックアップデータセットがデバイスの祖先データセットになります。デバイスは、自身のバックアップまたは祖先データセットから復元できます。両方のソースからのバックアップが利用可能な場合、デバイスは自身のバックアップを優先します。ユーザーがデバイス設定ウィザードを実行しなかった場合、デバイスは自身のバックアップからの復元のみを行えます。

簡単に復元をテストできるように、Android にはアプリの復元を手動で開始するためのツールが用意されています。詳しくは、バックアップと復元のテストをご覧ください。

バックアップを有効または無効にする

Android 6.0（API レベル 23）以上をターゲットとするアプリでは、自動的に自動バックアップが有効になります。バックアップを有効または無効にするには、アプリのマニフェストファイルでブール値 android:allowBackup を設定します。デフォルト値は true ですが、次の例のようにマニフェストで属性を明示的に設定することをおすすめします。

<manifest ... >
    ...
    <application android:allowBackup="true" ... >
        ...
    </application>
</manifest>

バックアップを無効にするには、android:allowBackup を false に設定します。アプリがその状態を他のなんらかのメカニズムによって再現できる場合や、機密情報をアプリで扱っている場合は、このように設定することをおすすめします。

ファイルを追加または除外する

デフォルトでは、ほぼすべてのアプリデータがシステムによってバックアップされます。詳しくは、バックアップ対象のファイルのセクションをご覧ください。

転送の種類に基づいて、バックアップに含めるデータを制御できます。自動バックアップは、Google ドライブへのクラウドバックアップとデバイス間の直接（D2D）転送をサポートしています。構成方法は、Android のバージョンとアプリの targetSdkVersion によって異なります。

Android 11 以前を搭載しているデバイスの場合は、Android 11 以下でバックアップを管理するをご覧ください。
Android 12 以降を搭載したデバイスでは、API レベル 31 以上をターゲットとするアプリは data-extraction-rules 形式を使用します。詳しくは、Android 12 以上でバックアップを管理するをご覧ください。
data-extraction-rules 形式は、クロスプラットフォーム転送（iOS など）もサポートしています。この機能は Android 16 QPR2 から利用できます。詳しくは、クロスプラットフォーム転送を構成するをご覧ください。

Android 11 以下でバックアップを管理する

Android 11（API レベル 30）以下を搭載したデバイスでバックアップ対象のファイルを制御するには、このセクションの手順を行います。

次の例に示すように、AndroidManifest.xml ファイルで、android:fullBackupContent 属性を <application> 要素に追加します。この属性で、バックアップルールを格納する XML ファイルを指定します。
```
<application ...
 android:fullBackupContent="@xml/backup_rules">
</application>
```
@xml/backup_rules という XML ファイルを res/xml/ ディレクトリ内に作成します。このファイルで、<include> 要素と <exclude> 要素を使用したルールを追加します。次のサンプルでは、device.xml を除くすべての共有の環境設定がバックアップされます。
```
<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
 <include domain="sharedpref" path="."/>
 <exclude domain="sharedpref" path="device.xml"/>
</full-backup-content>
```

バックアップに必要なデバイスの条件を定義する

アプリが機密情報をデバイスに保存する場合は、アプリのデータがユーザーのバックアップに含まれる条件を指定できます。Android 9（API レベル 28）以降では、以下の条件を追加できます。

clientSideEncryption: ユーザーのバックアップがクライアント側のシークレットで暗号化される。ユーザーが Android 9 以降でバックアップを有効化し、デバイスに画面ロック（PIN、パターン、パスワードのいずれか）を設定していれば、Android 9 以降が実行されているデバイスでこの形式の暗号化が有効化されます。
deviceToDeviceTransfer: ユーザーが、デバイス間のローカル転送をサポートしている別のデバイス（Google Pixel など）にバックアップを転送する。

開発デバイスを Android 9 にアップグレードした場合、アップグレード後にデータのバックアップを無効にしてから再度有効にする必要があります。なぜならば、Android がクライアント側のシークレットを使用してバックアップを暗号化するには、事前に [設定] または設定ウィザードでユーザーに通知する必要があるからです。

バックアップ対象の条件を宣言するには、一連のバックアップルール内の <include> 要素で requireFlags 属性を所定の値に設定します。

backup_rules.xml

<?xml version="1.0" encoding="utf-8"?>
<full-backup-content>
    <!-- App data isn't included in user's backup
         unless client-side encryption is enabled. -->
    <include domain="file" path="."
             requireFlags="clientSideEncryption" />
</full-backup-content>

アプリがキー値バックアップシステムを実装している場合、またはBackupAgent を自分で実装している場合、BackupDataOutput オブジェクトの転送フラグのセットとカスタムバックアップエージェントの FLAG_CLIENT_SIDE_ENCRYPTION_ENABLED または FLAG_DEVICE_TO_DEVICE_TRANSFER フラグとの間でビット単位の比較を行うことで、これらの条件付き要件をバックアップロジックに適用することもできます。

次のコードスニペットは、この方法の使用例を示しています。

Kotlin

class CustomBackupAgent : BackupAgent() {
    override fun onBackup(oldState: ParcelFileDescriptor?,
            data: BackupDataOutput?, newState: ParcelFileDescriptor?) {
        if (data != null) {
            if ((data.transportFlags and
                    FLAG_CLIENT_SIDE_ENCRYPTION_ENABLED) != 0) {
                // Client-side backup encryption is enabled.
            }

            if ((data.transportFlags and FLAG_DEVICE_TO_DEVICE_TRANSFER) != 0) {
                // Local device-to-device transfer is enabled.
            }
        }
    }

    // Implementation of onRestore() here.
}

Java

public class CustomBackupAgent extends BackupAgent {
    @Override
    public void onBackup(ParcelFileDescriptor oldState, BackupDataOutput data,
            ParcelFileDescriptor newState) throws IOException {
        if ((data.getTransportFlags() &
                FLAG_CLIENT_SIDE_ENCRYPTION_ENABLED) != 0) {
            // Client-side backup encryption is enabled.
        }

        if ((data.getTransportFlags() &
                FLAG_DEVICE_TO_DEVICE_TRANSFER) != 0) {
            // Local device-to-device transfer is enabled.
        }
    }

    // Implementation of onRestore() here.
}

Android 12 以上でバックアップを管理する

アプリが Android 12（API レベル 31）以上をターゲットにしている場合、Android 12 以上を搭載したデバイスでバックアップ対象のファイルを追加または削除するには、このセクションの手順を行います。

次の例に示すように、AndroidManifest.xml ファイルで、android:dataExtractionRules 属性を <application> 要素に追加します。この属性で、バックアップルールを格納する XML ファイルを指定します。
```
<application ...
 android:dataExtractionRules="backup_rules.xml">
</application>
```
backup_rules.xml という XML ファイルを res/xml/ ディレクトリ内に作成します。このファイルで、<include> 要素と <exclude> 要素を使用したルールを追加します。次のサンプルでは、device.xml を除くすべての共有の環境設定がバックアップされます。
```
<?xml version="1.0" encoding="utf-8"?>
<data-extraction-rules>
 <cloud-backup [disableIfNoEncryptionCapabilities="true|false"]>
   <include domain="sharedpref" path="."/>
   <exclude domain="sharedpref" path="device.xml"/>
 </cloud-backup>
</data-extraction-rules>
```

構成ファイルの XML 構文

構成ファイルの XML 構文は、アプリがターゲットとし実行される Android のバージョンによって異なります。

Android 11 以下

Android 11 以下を搭載したデバイスのバックアップを制御する構成ファイルには、次の XML 構文を使用します。

<full-backup-content>
    <include domain=["file" | "database" | "sharedpref" | "external" |
                     "root" | "device_file" | "device_database" |
                     "device_sharedpref" | "device_root" ] path="string"
    requireFlags=["clientSideEncryption" | "deviceToDeviceTransfer"] />
    <exclude domain=["file" | "database" | "sharedpref" | "external" |
                     "root" | "device_file" | "device_database" |
                     "device_sharedpref" | "device_root" ] path="string" />
</full-backup-content>

Android 12 以上

アプリが Android 12（API レベル 31）以上をターゲットにしている場合、Android 12 以上を搭載したデバイスのバックアップを制御する構成ファイルには次の XML 構文を使用します。

<data-extraction-rules>
  <cloud-backup [disableIfNoEncryptionCapabilities="true|false"]>
    ...
    <include domain=["file" | "database" | "sharedpref" | "external" |
                     "root" | "device_file" | "device_database" |
                     "device_sharedpref" | "device_root" ] path="string"/>
    ...
    <exclude domain=["file" | "database" | "sharedpref" | "external" |
                     "root" | "device_file" | "device_database" |
                     "device_sharedpref" | "device_root" ] path="string"/>
    ...
  </cloud-backup>
  <device-transfer>
    ...
    <include domain=["file" | "database" | "sharedpref" | "external" |
                     "root" | "device_file" | "device_database" |
                     "device_sharedpref" | "device_root" ] path="string"/>
    ...
    <exclude domain=["file" | "database" | "sharedpref" | "external" |
                     "root" | "device_file" | "device_database" |
                     "device_sharedpref" | "device_root" ] path="string"/>
    ...
  </device-transfer>
  <cross-platform-transfer platform="ios">
    ...
    <include domain=["file" | "database" | "sharedpref" | "external" |
                     "root" | "device_file" | "device_database" |
                     "device_sharedpref" | "device_root" ] path="string"/>
    ...
    <exclude domain=["file" | "database" | "sharedpref" | "external" |
                     "root" | "device_file" | "device_database" |
                     "device_sharedpref" | "device_root" ] path="string"/>
    ...
    <platform-specific-params bundleId="string" teamId="string" contentVersion="string"/>
    ...
  </cross-platform-transfer>
</data-extraction-rules>

構成の各セクション（<cloud-backup>、<device-transfer>、<cross-platform-transfer>）には、そのタイプの転送にしか適用されないルールが含まれます。このように分けることで、たとえば、あるファイルやディレクトリを Google ドライブのバックアップから除外しつつ、デバイス間（D2D）転送やクロスプラットフォーム転送には含めるといったことが可能になります。これは、クラウドにバックアップするには大きすぎるがデバイス間の転送は問題なくできるファイルがある場合に便利です。

<device-transfer> セクションがないなど、特定のバックアップモードに関するルールがない場合、バックアップ対象のファイルセクションに記載されているように、no-backup ディレクトリと cache ディレクトリを除くすべてのコンテンツに対して、そのモードが完全に有効になります。

アプリでは、<cloud-backup> セクションに disableIfNoEncryptionCapabilities フラグを設定することで、ユーザーがロック画面を表示した場合など、暗号化可能な場合にのみバックアップが行われるようにできます。この制約を設定すると、ユーザーのデバイスが暗号化をサポートしていない場合はバックアップがクラウドに送信されなくなりますが、D2D 転送はサーバーに送信されないため、暗号化をサポートしていないデバイスでも動作し続けます。

要素の追加と除外の構文

<full-backup-content> タグ、<cloud-backup> タグ、<device-transfer> タグ（デバイスの Android バージョンとアプリの targetSDKVersion によって異なります）内で、<include> 要素と <exclude> 要素を次のように定義します。

<include>

バックアップするファイルまたはフォルダを指定します。デフォルトでは、ほぼすべてのアプリファイルが自動バックアップの対象に含まれています。<include> 要素を指定すると、デフォルトではどのファイルもバックアップの対象に含まれなくなり、指定したファイルだけがバックアップされるようになります。複数のファイルをバックアップの対象に含めるには、複数の <include> 要素を使用します。

Android 11 以下では、この要素に requireFlags 属性を含めることもできます。この属性について詳しくは、バックアップに必要なデバイスの条件を定義する方法についてのセクションをご覧ください。

getCacheDir()、getCodeCacheDir()、getNoBackupFilesDir() から返されたディレクトリ内のファイルは、対象に含めようとしても必ず除外されます。

<exclude>

バックアップ時に除外するファイルまたはフォルダを指定します。通常、以下のファイルはバックアップから除外します。

デバイス固有の ID（サーバーにより発行された ID またはデバイスで生成された ID）が指定されているファイル。たとえば、Firebase Cloud Messaging（FCM）では、ユーザーがアプリを新しいデバイスにインストールするたびに登録トークンを生成する必要があります。古い登録トークンが復元されると、アプリが予想外の動作をすることがあります。
アプリのデバッグに関連するファイル。
アプリの 25 MB のバックアップ容量を超えるサイズの大きいファイル。

<include> 要素と <exclude> 要素にはそれぞれ、以下の 2 つの属性を含める必要があります。

domain

リソースの場所を指定します。この属性の有効な値は次のとおりです。

root: このアプリに属するすべてのプライベートファイルが保存される、ファイルシステム上のディレクトリ。
file: getFilesDir() が返すディレクトリ。
database: getDatabasePath() が返すディレクトリ。SQLiteOpenHelper で作成されたデータベースはここに格納されます。
sharedpref: SharedPreferences が格納されるディレクトリ。
external: getExternalFilesDir() が返すディレクトリ。
device_root: root に似ていますが、デバイス保護ストレージに使用します。
device_file: file に似ていますが、デバイス保護ストレージに使用します。
device_database: database に似ていますが、デバイス保護ストレージに使用します。
device_sharedpref: sharedpref に似ていますが、デバイス保護ストレージに使用します。

path

バックアップの対象に含める、または対象から除外するファイルまたはフォルダを指定します。次の点に注意してください。

この属性は、ワイルドカードや正規表現の構文をサポートしていません。
./ を使用して現ディレクトリを参照できますが、セキュリティ上の理由から、.. などを使用して、親ディレクトリを参照することはできません。
ディレクトリを指定すると、そのディレクトリ内のすべてのファイルと再帰的サブディレクトリにルールが適用されます。

クロスプラットフォーム転送を設定する

Android 16 QPR2（API レベル 36.1）以降では、Android 以外のデバイスとの間でデータを転送するための自動バックアップを設定できます。これを行うには、Android 12 以降の構文に示すように、<data-extraction-rules> 構成内に <cross-platform-transfer> 要素を追加します。必須の platform 属性を使用して、ターゲットプラットフォームを指定する必要があります。サポートされている値は ios のみです。

このセクション内では、要素の追加と除外の構文で説明されている標準の <include> 要素と <exclude> 要素を使用して、転送するデータを指定できます。

また、システムがアプリをターゲットプラットフォーム上の対応するアプリと照合できるように、<platform-specific-params> 要素を含める必要があります。この要素には次の必須属性があります。

bundleId: 他のプラットフォームのアプリのバンドル ID（iOS アプリのバンドル ID など）。
teamId: 他のプラットフォームのアプリのチーム ID（iOS アプリのチーム ID など）。
contentVersion: エクスポートされるデータ形式に関連付けられた、ユーザー定義のバージョン文字列。

bundleId 属性と teamId 属性は、データの整合性とアプリ間の適切な照合を検証するために使用されます。これにより、エクスポート時にデータが他のプラットフォームの指定されたアプリにのみ転送され、インポート時にこの Android アプリがその特定のアプリからのみデータをインポートすることが保証されます。

XML ルールで提供されるよりも詳細なデータ変換と転送プロセスを制御するには、カスタム BackupAgent を実装して、クロスプラットフォーム転送 API を使用します。

iOS 転送のファイルマッピング

iOS にファイルを転送する場合、<include> ルールで指定した Android の domain と path は、特定のディレクトリ構造にマッピングされます。次の表は、Android の domain に基づいて、転送先のルートを基準とした iOS の転送先のパスを示しています。

Android `domain`	iOS でのパス（転送ルートからの相対パス）
`root`	`app/`
`file`	`app/files/`
`database`	`app/databases/`
`sharedpref`	`app/shared_prefs/`
`external`	`external/files/`
`device_root`	`device/app/`
`device_file`	`device/app/files/`
`device_database`	`device/app/databases/`
`device_sharedpref`	`device/app/shared_prefs/`

たとえば、<include domain="file" path="my_settings.txt"/> に含まれるファイルは、転送先のルートに対する相対パス app/files/my_settings.txt で iOS 側で利用可能になります。

BackupAgent を実装する

自動バックアップを実装するアプリでは、BackupAgent を実装する必要はありません。ただし、カスタムの BackupAgent を必要に応じて実装できます。通常、以下のような場合に BackupAgent を実装します。

バックアップイベント（onRestoreFinished()、onQuotaExceeded() など）の通知を受け取りたい場合。これらのコールバックメソッドは、アプリが実行されていない場合でも実行されます。
XML ルールでは、バックアップするファイルセットを簡単に表現できない場合。このようなレアケースでは、onFullBackup(FullBackupDataOutput) をオーバーライドする BackupAgent を実装し、目的のファイルを保存します。システムのデフォルトの実装を保持するには、スーパークラスで super.onFullBackup() を使用して対応するメソッドを呼び出します。

デフォルトでは、BackupAgent を実装すると、アプリが Key-Value ペアのバックアップと復元を行うものと想定されます。代わりにファイルベースの自動バックアップを使用するには、アプリのマニフェストで android:fullBackupOnly 属性を true に設定します。

自動バックアップおよび復元処理が行われている間、システムはアプリを制限付きモードで起動して、競合を引き起こす可能性があるファイルにアプリがアクセスしないようにするとともに、アプリが BackupAgent でコールバックメソッドを実行できるようにします。この制限付きモードでは、アプリのメインアクティビティは自動的に開始されず、コンテンツプロバイダは初期化されません。また、アプリのマニフェストで宣言されたサブクラスではなく、基本クラス Application がインスタンス化されます。

BackupAgent には、Key-Value バックアップで使用される抽象メソッド onBackup() および onRestore() を実装する必要があります。Key-Value バックアップを実行しない場合は、これらのメソッドの実装を空のままにしておくことができます。

詳細については、BackupAgent を拡張するをご覧ください。

BackupAgent でのクロスプラットフォーム転送を処理する

Android 16 QPR2（API レベル 36.1）以降、BackupAgent でいくつかの新しい API を使用して、クロスプラットフォームのデータ転送をより適切にサポートできるようになりました。

新しいトランスポートフラグ:

FLAG_CROSS_PLATFORM_TRANSFER_IOS: このフラグは、BackupAgent に提供される transportFlags に追加されます。
- onFullBackup では、現在のバックアップオペレーションが iOS デバイスへのデータエクスポートの一部である場合に、このフラグが設定されます。
- 新しい onRestoreFile オーバーロードでは、iOS デバイスからデータがインポートされている場合にこのフラグが設定されます。

新しい onRestoreFile メソッド:

単一の FullRestoreDataInput パラメータを受け取る onRestoreFile の新しいオーバーロードが導入されました。このオブジェクトは、復元オペレーションに関する詳細なコンテキストを提供します。

FullRestoreDataInput.getTransportFlags(): 現在の復元オペレーションのトランスポートフラグを返します。これには FLAG_CROSS_PLATFORM_TRANSFER_IOS が含まれる場合があります。
FullRestoreDataInput.getContentVersion(): クロスプラットフォーム転送中に、別のプラットフォームのソースアプリによって提供されたコンテンツバージョン文字列を返します。ソースから提供されない場合、この値は空の文字列になります。

新しいサイズ推定方法:

onEstimateFullBackupBytes(): このメソッドを使用すると、アプリがバックアップするデータの推定サイズを指定できます。バックアップ中にアプリが重要なデータ変換を実行する場合や、大量のデータを処理する場合は、デフォルトのシステムドライランを回避して効率を向上させることができるため、実装を強く推奨します。バックアップが小規模で単純なアプリの場合、通常はこのメソッドは必要ありません。

使用例:

Kotlin

// In your custom BackupAgent class

override fun onFullBackup(out: FullBackupDataOutput) {
    // Check if this is a cross-platform export to iOS
    if ((out.transportFlags and FLAG_CROSS_PLATFORM_TRANSFER_IOS) != 0) {
        Log.d(TAG, "onFullBackup for iOS transfer")
        // Your custom export logic here
        // Call fullBackupFile() for files to include
    }
}

override fun onRestoreFile(input: FullRestoreDataInput) {
    if ((input.transportFlags and FLAG_CROSS_PLATFORM_TRANSFER_IOS) != 0) {
        val sourceContentVersion = input.contentVersion
        Log.d(TAG, "onRestoreFile from iOS, content version: $sourceContentVersion")
        // Your custom import logic here, using input.data, input.destination, etc.
    }
}

// Optional: Provide an estimate of the backup size
override fun onEstimateFullBackupBytes(): Long {
    return calculateEstimatedBackupSize()
}

Java

// In your custom BackupAgent class

@Override
public void onFullBackup(FullBackupDataOutput out) throws IOException {
    // Check if this is a cross-platform export to iOS
    if ((out.getTransportFlags() & FLAG_CROSS_PLATFORM_TRANSFER_IOS) != 0) {
        Log.d(TAG, "onFullBackup for iOS transfer");
        // Your custom export logic here
        // Call fullBackupFile() for files to include
    }
}

@Override
public void onRestoreFile(FullRestoreDataInput input) {
    if ((input.getTransportFlags() & FLAG_CROSS_PLATFORM_TRANSFER_IOS) != 0) {
        String sourceContentVersion = input.getContentVersion();
        Log.d(TAG, "onRestoreFile from iOS, content version: " + sourceContentVersion);
        // Your custom import logic here, using input.getData(), input.getDestination(), etc.
    }
}

// Optional: Provide an estimate of the backup size
@Override
public long onEstimateFullBackupBytes() {
    return calculateEstimatedBackupSize();
}

自動バックアップでユーザーデータをバックアップする コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

バックアップ対象のファイル

バックアップの場所

バックアップ スケジュール

復元スケジュール

バックアップを有効または無効にする

ファイルを追加または除外する

Android 11 以下でバックアップを管理する

バックアップに必要なデバイスの条件を定義する

Kotlin

Java

Android 12 以上でバックアップを管理する

構成ファイルの XML 構文

Android 11 以下

Android 12 以上

要素の追加と除外の構文

クロスプラットフォーム転送を設定する

iOS 転送のファイル マッピング

BackupAgent を実装する

BackupAgent でのクロス プラットフォーム転送を処理する

Kotlin

Java

自動バックアップでユーザーデータをバックアップする

バックアップスケジュール

iOS 転送のファイルマッピング

BackupAgent でのクロスプラットフォーム転送を処理する