Как работает BackupAgent?

Question

Я смотрю на AndroidManifest файлы, и я вижу записи для android:backupAgent и согласно документации android:backupAgent является

Имени класса, реализующим BackupAgent управлять резервным копированием и восстановлением настроек приложения к внешней памяти.

Но я не могу найти интерфейс BackupAgent или любую другую документацию. Может ли кто-нибудь указать мне в правильном направлении?

Answer 1

API BackupAgent еще не затвердел, поэтому это скрытый класс. You can check it out on Android's git, где есть этот комментарий:

/** 
* This is the central interface between an application and Android's 
* settings backup mechanism. 
* 
* @hide pending API solidification 
*/ 

Answer 2

Все, что я могу предложить это source code for android.app.BackupAgent и source code for android.backup.BackupManager.

BackupAgent является абстрактным классом, и в соответствии с javadoc в источнике он является «центральным интерфейсом между приложением и механизмом резервного копирования настроек Android». Он имеет абстрактные методы onBackup() и onRestore().

Существует также BackupManager. В javadoc говорится: «BackupManager - это интерфейс к службе резервного копирования системы. Приложения просто создают экземпляр, а затем используют этот экземпляр для связи с инфраструктурой резервного копирования». Он имеет метод dataChanged(), чтобы позвонить, чтобы запланировать резервную копию, и метод beginRestoreSession(), чтобы начать восстановление.

Теперь, интересные вещи в коде BackupManager являются:

* 
* @hide pending API solidification 
*/ 

и:

/** @hide TODO: REMOVE THIS */ 
public static final boolean EVEN_THINK_ABOUT_DOING_RESTORE = true; 

Таким образом, кажется, что это все еще в стадии разработки, и переменная EVEN_THINK_ABOUT_DOING_RESTORE элементом является простой способ отключить функции резервного копирования. Я предполагаю, что он отключен в производстве Android.