Parsing and re-packing Android boot.img/vbmeta.img/payload.bin, supporting Android 13 preview
 
 
 
 
 
 
Go to file
Jonas Hackenberg fce93d5117 Fix typo: gradew -> gradlew ()
Thank you very much for your project.
Worked perfectly without any issues.
I just noticed this typos in the readme.
abootimg fix errors for gradle 4.0
boot_signer update to android master on May.30.2016, not tested
bouncycastle update base code to android-8.1.0_r2
gradle/wrapper squashed update
mkbootfs update base code to android-8.1.0_r2
security update to android master on May.30.2016, not tested
src update base code to android-8.1.0_r2
.gitattributes guide linguist to behave better
.travis.yml add self test in travis-ci
LICENSE.md Update LICENSE.md
README.expert.md mass update for next generation boot.img
README.md Fix typo: gradew -> gradlew ()
build.gradle update base code to android-8.1.0_r2
debug.kts squashed update
gradlew upgrade to support gradle 4.0
gradlew.bat upgrade to support gradle 4.0
settings.gradle update base code to android-8.1.0_r2

README.md

Android_boot_image_editor

Build Status License

This tool focuses on editing Android boot.img(also recovery.img and recovery-two-step.img).

Prerequisite

Host OS requirement:

Linux or Mac.

Target Android requirement:

(1) Targeted boot.img(or recovery.img / recovery-two-step.img) MUST follows AOSP verified boot flow, which means it packs linux kernel, rootfs , and a optional second state bootloader, then sign it with OEM/USER keys.

(2) These utilities are known to work for Nexus (or Nexus compatible) boot.img(or recovery.img/recovery-two-step.img) for the following Android releases:

  • AOSP master
  • Lollipop (API Level 21,22) - Oreo (API Level 26,27)

You can get a full Android version list here.

Usage

Get tools via git:

git clone https://github.com/cfig/Android_boot_image_editor.git
cd Android_boot_image_editor

Then put your boot.img at $(CURDIR)/boot.img, then start gradle 'unpack' task:

cp <original_boot_image> boot.img
./gradlew unpack

Your get the flattened kernel and /root filesystem under $(CURDIR)/build/unzip_boot:

build/unzip_boot/
├── bootimg.json
├── kernel
├── second
└── root

Then you can edit the actual file contents, like rootfs or kernel. Now, pack the boot.img again

./gradlew pack

You get the repacked boot.img at $(CURDIR):

boot.img.signed

If you are working with recovery.img

If you are working with recovery.img, the steps are similar:

cp <original_recovery_image> recovery.img
./gradlew unpack
./gradlew pack

And you get recovery.img.signed

example & test

An example boot.img has been placed at src/test/resources/boot.img, which is extracted from Nexus 5x(code: bullhead) factory images from Google, you can take it as a quick start.

boot.img layout

Read layout of Android boot.img. We now support os_version and os_patch_level.

References

boot_signer https://android.googlesource.com/platform/system/extras

bouncycastle https://android.googlesource.com/platform/external/bouncycastle

cpio / fs_config https://android.googlesource.com/platform/system/core