Android backup extractor

Utilitário para extrair e reempacotar backups Android criados com adb backup (ICS+). Baseado em grande parte no BackupManagerService.java do AOSP.

Construção

Requer Java 11. Lidar com backups criptografados requer a política de jurisdição de força ilimitada JCE (não necessária se estiver usando a versão atual do Java 9).

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

Use uma das ferramentas listadas abaixo para construir ou veja Releases para binários pré-construídos (arquivos jar executáveis).

Com Eclipse:

Baixe a versão mais recente do jar do Bouncy Castle Provider (bcprov-jdk15on-*.jar) de aqui:

Coloque o jar do Bouncy Castle mais recente em lib/, importe no Eclipse e ajuste o caminho de construção se necessário. Use o script abe para iniciar o utilitário.

Com Maven (requer pelo menos JDK11):

Para criar um jar all-in-one auto-executável: mvn clean package e então:

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

Com Ant:

Use o script Ant incluído para criar um jar all-in-one e execute com: (você ainda precisa colocar o jar do Bouncy Castle em lib/; modifique a propriedade bcprov.jar de acordo)

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

(Obrigado a Jan Peter Stotz por contribuir com o arquivo build.xml)

Com Gradle:

Use o Gradle para criar um jar all-in-one: ./gradlew e então:

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

Uso

Sintaxe:

• unpack: abe unpack <backup.ab> <backup.tar> [password]
• pack: abe pack <backup.tar> <backup.ab> [password]
• pack para 4.4: abe pack-kk <backup.tar> <backup.ab> [password] (cria backups versão 2, compatíveis com Android 4.4.3)

Se o nome do arquivo for -, os dados são lidos da entrada padrão ou escritos na saída padrão.

Se a senha não for fornecida na linha de comando, a variável de ambiente ABE_PASSWD é tentada. Se você não especificar uma senha, o arquivo de backup não será criptografado, apenas compactado.

Empacotando arquivos tar

• O Android é muito particular sobre a ordem dos arquivos no arquivo tar. O formato está descrito aqui.
• Arquivos tar incompatíveis levam a erros ou até travamentos do sistema.
• Aplicativos com a flag allowBackup definida como false não são copiados nem restaurados.
  • (você pode tentar restaurar manualmente via adb push e adb shell)
• Os erros são impressos apenas no logcat, fique atento ao BackupManagerService.

A maneira mais segura de empacotar um arquivo tar é obter a lista de arquivos do arquivo backup.tar original:

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

E então use essa lista para construir o arquivo tar. No diretório de backup extraído:

tar cf restore.tar -T package.list

Agora você pode empacotar restore.tar e tentar adb restore restore.ab

Releases

Releases são construídas com Travis CI a partir do branch master e incluem um jar executável completo.

Use os binários por sua conta e risco. Nenhuma garantia ou suporte é fornecido.

Por favor, reporte apenas bugs no próprio extrator de backup, não posso responder perguntas sobre desempacotar/reempacotar backups ou arquivos tar. (Veja Uso para um mini guia de uso.)

Notas

Mais detalhes sobre o formato de backup e a implementação da ferramenta no post do blog associado.