Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nelenkov/android-backup-extractor
Android backup extractor
https://github.com/nelenkov/android-backup-extractor
Last synced: 20 days ago
JSON representation
Android backup extractor
- Host: GitHub
- URL: https://github.com/nelenkov/android-backup-extractor
- Owner: nelenkov
- License: other
- Created: 2012-06-08T13:33:46.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2024-09-25T03:12:55.000Z (about 1 month ago)
- Last Synced: 2024-10-01T22:21:35.559Z (about 1 month ago)
- Language: Java
- Size: 445 KB
- Stars: 2,195
- Watchers: 58
- Forks: 272
- Open Issues: 34
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ccamel - nelenkov/android-backup-extractor - Android backup extractor (Java)
- awesome-repositories - nelenkov/android-backup-extractor - Android backup extractor (Java)
- awesome-hacking-lists - nelenkov/android-backup-extractor - Android backup extractor (Java)
README
Android backup extractor
========================
Utility to extract and repack Android backups created with ```adb backup``` (ICS+).
Largely based on ```BackupManagerService.java``` from AOSP.
# Building
Requires Java 11. Handling encrypted backups requires the JCE unlimited strength
jurisdiction policy (not needed if using current Java 9 release).
http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html
Use one of the tools listed below to build or see [Releases](#releases) for pre-built binaries (runnable jar files).
## With Eclipse:
Download the latest version of Bouncy Castle Provider jar
(```bcprov-jdk15on-*.jar```) from [here](http://www.bouncycastle.org/latest_releases.html):
Drop the latest Bouncy Castle jar in ```lib/```, import in Eclipse and adjust
build path if necessary. Use the ```abe``` script to start the utility.
## With Maven (requires at least JDK11):
To create a self-executable all-in-one jar:
```mvn clean package``` and then:
```java -jar target/abe.jar pack|unpack|pack-kk ...```
## With Ant:
Use the bundled Ant script to create an all-in-one jar and run with:
(you still need to put the Bouncy Castle jar in lib/; modify the
```bcprov.jar``` property accordingly)
```java -jar abe.jar pack|unpack|pack-kk ...```
(Thanks to Jan Peter Stotz for contributing the build.xml file)
## With Gradle:
Use gradle to create an all-in-one jar:
```./gradlew``` and then:
```java -jar build/libs/abe-all.jar pack|unpack|pack-kk ...```
# Usage
## Syntax:
* unpack: ```abe unpack [password]```
* pack: ```abe pack [password]```
* pack for 4.4: ```abe pack-kk [password]```
(creates version 2 backups, compatible with Android 4.4.3)
If the filename is `-`, then data is read from standard input or written to
standard output.
If the password is not given on the command line, then the environment variable
`ABE_PASSWD` is tried. If you don't specify a password the backup archive won't
be encrypted but only compressed.
## Packing tar archives
- Android is **very** particular about the order of files in the tar archive. The format is [described here](https://android.googlesource.com/platform/frameworks/base/+/4a627c71ff53a4fca1f961f4b1dcc0461df18a06).
- Incompatible tar archives lead to errors or even system crashes.
- Apps with the `allowBackup` flag set to `false` are [not backed up nor restored](https://android.googlesource.com/platform/frameworks/base/+/a858cb075d0c87e2965d401656ff2d5bc16406da).
- *(you can try restoring manually via `adb push` and `adb shell`)*
- Errors are only printed to logcat, look out for `BackupManagerService`.
The safest way to pack a tar archive is to get the list of files from the original backup.tar file:
```shell
tar tf backup.tar | grep -F "com.package.name" > package.list
```
And then use that list to build the tar file. In the extracted backup directory:
```shell
tar cf restore.tar -T package.list
```
You can now pack `restore.tar` and try `adb restore restore.ab`
# Releases
[Releases](https://github.com/nelenkov/android-backup-extractor/releases/latest) are built with Travis CI from the master branch and include a runnable fat jar.
Use the binaries at your own risk. No warranty or support provided.
Please report only bugs in backup extractor itself, I can't answer questions regrading unpacking/repacking backups or tar files.
(See [Usage](#usage) for a mini usage guide.)
[](https://travis-ci.com/nelenkov/android-backup-extractor)
# Notes
More details about the backup format and the tool implementation in the [associated blog post](https://nelenkov.blogspot.de/2012/06/unpacking-android-backups.html).