Home

TWRP Building Wiki

Setup build environment

Host OS: Ubuntu 16.04+ or BBQ LINUX (recommended)

## BBQ LINUX users can skip these package installations, just update it by -> sudo pacman -Suy <-
# Required packages
sudo apt-get install bison build-essential curl flex git gnupg gperf liblz4-tool libncurses5-dev libsdl1.2-dev libwxgtk3.0-dev libxml2 libxml2-utils lzop pngcrush schedtool squashfs-tools xsltproc zip zlib1g-dev
# Additional packages for 64bit destro
sudo apt-get install g++-multilib gcc-multilib lib32ncurses5-dev lib32readline6-dev lib32z1-dev
# JDK
sudo apt-get install openjdk-8-jdk # Ubuntu 16.04+
or
sudo apt-get install openjdk-7-jdk # Ubuntu 14.04

Create twrp dir:

 mkdir ~/twrp && cd ~/twrp

Get a minimal TWRP source

Recommended version: omni_twrp_5.1_norepo

Other versions: TWRP Source releases

Get the right version of source i.e. don't try higher version then your stock rom unless you're using a custom kernel which supports the latest source.

# Download the desired source (for ex: 5.1_norepo)
aria2c -x16 -s16 https://github.com/TwrpBuilder/twrp-sources/releases/download/omni_twrp-5.1.1-20180211/omni_twrp-5.1.1-20180211-norepo.tar.xz
# Extract the source:
tar -xvf omni_twrp-5.1.1-20180211-norepo.tar.xz --directory ~/twrp/

Clone common device tree

git clone https://github.com/TwrpBuilder/device_generic_twrpbuilder.git ~/twrp/device/generic/twrpbuilder

Make device tree

Download the latest TWRP-Tree-Generator and save it in ~/twrp/

Put any working recovery.img in ~/twrp/

Make the device tree:

java -jar TwrpBuilder-1.0-SNAPSHOT.jar -r recovery.img

Output be like this:

Building tree using: recovery.img
Found gzip comression in ramdisk
Making "omni_q417".mk
Making Android.mk
Making AndroidProducts.mk
Making kernel.mk
Generating fstab
/data ext4 /dev/block/mmcblk0p3
/system ext4 /dev/block/mmcblk0p6
/cache ext4 /dev/block/mmcblk0p2
found mt6735 platform
Found 64 bit arch
Build fingerPrint: Micromax/Q417/Q417:5.1/LMY47D/1446202623:user/release-keys
tree ready for q417 at `device/micromax/q417`
Warning :- Check recovery fstab before build

Note down the "omni_q417" as it is needed for lunch ;)

Verify `device/micromax/q417/recovery.fstab` for mount points

Build the TWRP

. build/envsetup.sh
lunch "omni_q417"-eng    #device code from previous step(without quotes)
make -j4 recoveryimage

Troubleshooting

Make sure you've openjdk not oraclejdk

For GCC 7.x (Ubuntu 17.10+):

export LC_ALL=C

also in file external/sepolicy/tools/check_seapp.c add __attribute__((fallthrough)); above line: 740

 735:		else {
 736:	  		log_error(
 737:				"Unknown option character `\\x%x'.\n",
 738:				optopt);
 739: 		}
 740:		__attribute__((fallthrough));
 741:	default:
 742:		exit(EXIT_FAILURE);
 743:	}