¿Cómo funciona un BackupAgent?

Question

Estoy buscando en los archivos AndroidManifest y veo entradas para android:backupAgent y según la documentación es android:backupAgent

  

El nombre de la clase que implementa BackupAgent para gestionar la copia de seguridad y restauración de la configuración de la aplicación para almacenamiento externo.

Pero no puedo encontrar una interfaz BackupAgent o cualquier otra documentación. Alguien me puede apuntar en la dirección correcta?

Answer 1

API de BackupAgent no se solidifica aún, por lo que es una clase oculta. Usted puede encontrar esta información en git de Android, donde hay este comentario:

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

Answer 2

Todo lo que puedo ofrecer es la código fuente para android.app.BackupAgent y la código fuente para android.backup.BackupManager .

BackupAgent es una clase abstracta y de acuerdo con el Javadoc en la fuente que "es la interfaz central entre una aplicación y la configuración de Android mecanismo de copia de seguridad." Tiene métodos onBackup() y onRestore() abstractos.

También hay BackupManager. El javadoc dice "BackupManager es la interfaz de servicio de copia de seguridad del sistema. Aplicaciones simplemente ejemplifican uno, y luego usar esa instancia para comunicarse con la infraestructura de copia de seguridad." Tiene un método dataChanged() a llamar para programar un método beginRestoreSession() para iniciar una restauración de copia de seguridad y.

Ahora, las cosas interesantes en el código para BackupManager son:

*
* @hide pending API solidification
*/

y

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

Así que parece que esto es todavía un trabajo en progreso y la variable miembro EVEN_THINK_ABOUT_DOING_RESTORE es una forma fácil de desactivar la funcionalidad de copia de seguridad. Mi conjetura es que está deshabilitado en la producción de Android construye.