Android backup extractor

Utilidad para extraer y reempaquetar respaldos de Android creados con adb backup (ICS+). Basado en gran parte en BackupManagerService.java de AOSP.

Construcción

Requiere Java 11. El manejo de respaldos cifrados requiere la política de jurisdicción de fuerza ilimitada de JCE (no es necesaria si se usa la versión actual de Java 9).

http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html

Use una de las herramientas listadas abajo para construir o vea Lanzamientos para binarios preconstruidos (archivos jar ejecutables).

Con Eclipse:

Descargue la última versión del jar de Bouncy Castle Provider (bcprov-jdk15on-*.jar) desde aquí:

Coloque el último jar de Bouncy Castle en lib/, importe en Eclipse y ajuste la ruta de construcción si es necesario. Use el script abe para iniciar la utilidad.

Con Maven (requiere al menos JDK11):

Para crear un jar auto-ejecutable todo-en-uno: mvn clean package y luego:

java -jar target/abe.jar pack|unpack|pack-kk ...

Con Ant:

Use el script Ant incluido para crear un jar todo-en-uno y ejecute con: (aún necesita colocar el jar de Bouncy Castle en lib/; modifique la propiedad bcprov.jar en consecuencia)

java -jar abe.jar pack|unpack|pack-kk ...

(Gracias a Jan Peter Stotz por contribuir el archivo build.xml)

Con Gradle:

Use gradle para crear un jar todo-en-uno: ./gradlew y luego:

java -jar build/libs/abe-all.jar pack|unpack|pack-kk ...

Uso

Sintaxis:

• descomprimir: abe unpack <backup.ab> <backup.tar> [password]
• comprimir: abe pack <backup.tar> <backup.ab> [password]
• comprimir para 4.4: abe pack-kk <backup.tar> <backup.ab> [password] (crea respaldos versión 2, compatibles con Android 4.4.3)

Si el nombre de archivo es -, los datos se leen desde la entrada estándar o se escriben en la salida estándar.

Si la contraseña no se proporciona en la línea de comandos, se prueba la variable de entorno ABE_PASSWD. Si no se especifica una contraseña, el archivo de respaldo no se cifrará sino que solo se comprimirá.

Empaquetando archivos tar

• Android es muy particular sobre el orden de los archivos en el archivo tar. El formato se describe aquí.
• Los archivos tar incompatibles provocan errores o incluso fallos del sistema.
• Las aplicaciones con la bandera allowBackup establecida en false no se respaldan ni restauran.
  • (puede intentar restaurar manualmente mediante adb push y adb shell)
• Los errores solo se imprimen en logcat, busque BackupManagerService.

La forma más segura de empaquetar un archivo tar es obtener la lista de archivos del archivo backup.tar original:

tar tf backup.tar | grep -F "com.package.name" > package.list

Y luego usar esa lista para construir el archivo tar. En el directorio de respaldo extraído:

tar cf restore.tar -T package.list

Ahora puede empaquetar restore.tar e intentar adb restore restore.ab

Lanzamientos

Lanzamientos se construyen con Travis CI desde la rama master e incluyen un jar gordo ejecutable.

Use los binarios bajo su propio riesgo. No se proporciona garantía ni soporte.

Por favor, reporte solo errores en el extractor de respaldos en sí, no puedo responder preguntas sobre descompresión/recompresión de respaldos o archivos tar. (Vea Uso para una mini guía de uso.)

Notas

Más detalles sobre el formato de respaldo y la implementación de la herramienta en la publicación de blog asociada.