Estrattore di backup Android

Utilità per estrarre e reimpacchettare i backup Android creati con adb backup (ICS+). Basato in gran parte su BackupManagerService.java di AOSP.

Compilazione

Richiede Java 11. La gestione dei backup crittografati richiede la policy di giurisdizione illimitata JCE (non necessaria se si utilizza l'attuale release di Java 9).

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

Utilizza uno degli strumenti elencati di seguito per compilare o consulta Releases per binari precompilati (file jar eseguibili).

Con Eclipse:

Scarica l'ultima versione del jar del Provider Bouncy Castle (bcprov-jdk15on-*.jar) da qui:

Metti l'ultimo jar di Bouncy Castle in lib/, importa in Eclipse e regola il percorso di compilazione se necessario. Utilizza lo script abe per avviare l'utilità.

Con Maven (richiede almeno JDK11):

Per creare un jar tutto-in-uno auto-eseguibile: mvn clean package e poi:

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

Con Ant:

Utilizza lo script Ant incluso per creare un jar tutto-in-uno ed esegui con: (devi comunque mettere il jar di Bouncy Castle in lib/; modifica la proprietà bcprov.jar di conseguenza)

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

(Grazie a Jan Peter Stotz per il contributo del file build.xml)

Con Gradle:

Usa gradle per creare un jar tutto-in-uno: ./gradlew e poi:

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

Utilizzo

Sintassi:

• unpack: abe unpack <backup.ab> <backup.tar> [password]
• pack: abe pack <backup.tar> <backup.ab> [password]
• pack per 4.4: abe pack-kk <backup.tar> <backup.ab> [password] (crea backup versione 2, compatibili con Android 4.4.3)

Se il nome del file è -, i dati vengono letti dall'input standard o scritti nell'output standard.

Se la password non viene fornita sulla riga di comando, viene provata la variabile d'ambiente ABE_PASSWD. Se non si specifica una password, l'archivio di backup non verrà crittografato ma solo compresso.

Impacchettamento di archivi tar

• Android è molto particolare riguardo l'ordine dei file nell'archivio tar. Il formato è descritto qui.
• Archivi tar incompatibili portano a errori o addirittura crash di sistema.
• Le app con il flag allowBackup impostato su false non vengono né sottoposte a backup né ripristinate.
  • (puoi provare a ripristinare manualmente tramite adb push e adb shell)
• Gli errori vengono solo stampati su logcat, cerca BackupManagerService.

Il modo più sicuro per impacchettare un archivio tar è ottenere l'elenco dei file dal file backup.tar originale:

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

E poi usare quell'elenco per costruire il file tar. Nella directory di backup estratta:

tar cf restore.tar -T package.list

Ora puoi impacchettare restore.tar e provare adb restore restore.ab

Releases

Releases sono compilate con Travis CI dal branch master e includono un fat jar eseguibile.

Utilizza i binari a tuo rischio. Nessuna garanzia o supporto fornito.

Segnala solo bug nell'estrattore di backup stesso, non posso rispondere a domande riguardanti lo spacchettamento/reimpacchettamento di backup o file tar. (Vedi Utilizzo per una mini guida all'uso.)

Note

Maggiori dettagli sul formato di backup e sull'implementazione dello strumento nel post del blog associato.