aiden
/
Android_boot_image_editor
mirror of https://github.com/cfig/Android_boot_image_editor
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Parsing and re-packing Android boot.img/vbmeta.img/payload.bin, supporting Android 13 preview
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
40 Commits
4 Branches
13 Tags
261 MiB
Java 61.2%
C 12.7%
Kotlin 12%
Python 10.9%
C++ 3%
Other 0.2%
 
 
 
 
 
 
master
rc
dev
bin
android-7.1.1_r6
android-10
android-11
android-8.1.0_r2
android-9
v12.0
v13
v13_r2
v13_r3
v14_r1
v14_r2
v14_r3
v15_r1
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '24499bb9a5'
${ noResults }
Go to file
Yu Yezhong 24499bb9a5 add macro CFIG_NO_FIX_STAT to disable fix_stat() for mkbootfs 
just in case some geeks do not want the "fix stat" behavior
of Android cpio, a.k.a mkbootfs.

Test:
original attributes:
drw------- 2 yu yu 4.0K 2017-04-11 16:43 T1
drwxrwxrwx 2 yu yu 4.0K 2017-04-11 16:43 T2

generated boot image w/ fix_stat():
drwxr-xr-x   2 root   root        0 1969-12-31 18:00 T1
drwxr-xr-x   2 root   root        0 1969-12-31 18:00 T2

define CFIG_NO_FIX_STAT and disable fix_stat():
drw-------   2 root   root        0 1969-12-31 18:00 T1
drwxrwxrwx   2 root   root        0 1969-12-31 18:00 T2
 		8 years ago
abootimg sync with android-7.1.1_r6 (#8) 9 years ago
boot_signer update to android master on May.30.2016, not tested 9 years ago
bouncycastle sync with android-7.1.1_r6 (#8) 9 years ago
gradle/wrapper Squashed commit of all strict checkings 9 years ago
security update to android master on May.30.2016, not tested 9 years ago
src add macro CFIG_NO_FIX_STAT to disable fix_stat() for mkbootfs 8 years ago
.travis.yml add self test in travis-ci 9 years ago
LICENSE.md Update LICENSE.md 9 years ago
README.expert.md mass update for next generation boot.img 9 years ago
README.md update readme: we also support recovery.img 8 years ago
build.gradle add macro CFIG_NO_FIX_STAT to disable fix_stat() for mkbootfs 8 years ago
gradlew add wrapper 9 years ago
gradlew.bat add wrapper 9 years ago
settings.gradle mass update for next generation boot.img 9 years ago

README.md

Android_boot_image_editor

Build Status

Utilies for editing Android boot.img or recovery.img.

Prerequisite

Host OS requirement:

Linux or Mac.

Target Android requirement:

(1) Targeted boot.img(or recovery.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) for the following Android releases:

  • Marshmallow (API Level 23)
  • Lollipop (API Level 21,22)
  • AOSP master

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
./gradew 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

./gradew 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
./gradew unpack
./gradew 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.