Android backup extractor

Utilitaire pour extraire et reconditionner les sauvegardes Android créées avec adb backup (ICS+). Largement basé sur BackupManagerService.java d'AOSP.

Construction

Nécessite Java 11. La gestion des sauvegardes chiffrées nécessite la politique de juridiction à force illimitée de JCE (non nécessaire si vous utilisez la version actuelle de Java 9).

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

Utilisez l'un des outils listés ci-dessous pour construire ou consultez Versions pour les binaires pré-construits (fichiers jar exécutables).

Avec Eclipse :

Téléchargez la dernière version du jar Bouncy Castle Provider (bcprov-jdk15on-*.jar) depuis ici :

Déposez le dernier jar Bouncy Castle dans lib/, importez dans Eclipse et ajustez le chemin de construction si nécessaire. Utilisez le script abe pour lancer l'utilitaire.

Avec Maven (nécessite au moins JDK11) :

Pour créer un jar autonome tout-en-un : mvn clean package puis :

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

Avec Ant :

Utilisez le script Ant fourni pour créer un jar tout-en-un et exécutez avec : (vous devez toujours placer le jar Bouncy Castle dans lib/ ; modifiez la propriété bcprov.jar en conséquence)

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

(Merci à Jan Peter Stotz pour avoir contribué au fichier build.xml)

Avec Gradle :

Utilisez gradle pour créer un jar tout-en-un : ./gradlew puis :

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

Utilisation

Syntaxe :

• décompresser : abe unpack <backup.ab> <backup.tar> [password]
• compresser : abe pack <backup.tar> <backup.ab> [password]
• pack pour 4.4 : abe pack-kk <backup.tar> <backup.ab> [password] (crée des sauvegardes version 2, compatibles avec Android 4.4.3)

Si le nom de fichier est -, alors les données sont lues depuis l'entrée standard ou écrites sur la sortie standard.

Si le mot de passe n'est pas fourni en ligne de commande, alors la variable d'environnement ABE_PASSWD est essayée. Si vous ne spécifiez pas de mot de passe, l'archive de sauvegarde ne sera pas chiffrée mais seulement compressée.

Empaquetage des archives tar

• Android est très exigeant sur l'ordre des fichiers dans l'archive tar. Le format est décrit ici.
• Des archives tar incompatibles entraînent des erreurs ou même des plantages du système.
• Les applications avec le drapeau allowBackup défini sur false ne sont ni sauvegardées ni restaurées.
  • (vous pouvez essayer de restaurer manuellement via adb push et adb shell)
• Les erreurs sont uniquement imprimées dans logcat, surveillez BackupManagerService.

La façon la plus sûre d'empaqueter une archive tar est d'obtenir la liste des fichiers depuis le fichier backup.tar original :

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

Et ensuite utiliser cette liste pour construire le fichier tar. Dans le répertoire de sauvegarde extrait :

tar cf restore.tar -T package.list

Vous pouvez maintenant empaqueter restore.tar et essayer adb restore restore.ab

Versions

Les versions sont construites avec Travis CI à partir de la branche master et incluent un fat jar exécutable.

Utilisez les binaires à vos propres risques. Aucune garantie ni support fourni.

Veuillez signaler uniquement les bogues dans l'extracteur de sauvegarde lui-même, je ne peux pas répondre aux questions concernant la décompression/recompression des sauvegardes ou des fichiers tar. (Voir Utilisation pour un mini guide d'utilisation.)

Remarques

Plus de détails sur le format de sauvegarde et l'implémentation de l'outil dans le billet de blog associé.