You will need something from your Stock ROM first. Get them all and Try to modify it using the procedure.
- Get Your Stock Recovery
- Extract The Recovery Into Ramdisk & Kernel
- Create A GitHub Repository
- Make Notes from build.prop
- Add Some Stock Files
- Create "Android.mk"
- Create "AndroidProducts.mk"
- Create "BoardConfig.mk"
- Create "omni_$$DEVICE$$.mk"
- Publish the GitHub Repository
- Create An Account in Travis CI
- Create
.travis.ymlin GitHub Repo - Fire-Up The Build
- Flash The TWRP
- Troubleshooting
- You have to get your device's Stock
"recovery.img"from the Official Firmware which you can (or maybe can't) get from the device manufacturer's website. - You have to get the
build.propfile (from ROM's /system/build.prop) because there are a few key things that we need.- Use ADB to Pull the file by the command
adb pull /system/build.prop
- Use ADB to Pull the file by the command
- Use
Carliv Image Kitchento extract the image from Windows or Linux. - Need a Guide to Use it? Read This.
- Go to https://github.com/ and SignUp there.
- You have to Create an online GitHub Repository with the name of the device.
- For Example: something like
android_device_Walton_PrimoRX5ortwrp_device_Walton_PrimoRX5or whatever you want to call it.
- For Example: something like
- Go to https://github.com/settings/tokens/new/
- It will take you to a page to create a New personal access token.
- Name your Token as anything you like, for example: "GitHubToken" and save the Token Value in Notepad. We will need it later.
- Write down the keys and their values in Notepad or something of the followings:
- For ease, I am showing from my device.
As in "Keys" = "Values"
ro.build.product=gionee6735_65u_m0 # Company Given Codename for the Device. ro.product.board=Primo_RX5 # The Board Name for Build. ro.product.brand=WALTON # The Brand and The Manufacturer ro.product.manufacturer=WALTON # can be of the Same Name. ro.product.name=Primo_RX5 # The Device Name and/or The Codename ro.product.device=Primo_RX5 # we will be using. ro.product.model=Primo RX5 # A Nickname, we will ignore it. ro.mediatek.platform=MT6735 # The Chipset Platform of the Project. ro.mediatek.project.path=device/gionee/gionee6735_65u_m0 # The Original Build Location from Company. ro.product.cpu.abi=arm64-v8a # Shows if the device is 6-bit or 32-bit.
- Create a Folder named
prebuiltand put the unpackedrecovery.img-kernelinside it. Rename that file tozImage - Create another Folder named
recovery. Go in there and create a folder namedroot - In the
rootfolder, Put yourfactory_init.*.rcfiles,meta_init.*.rcfiles,ueventd.mt****.rc,init.recovery.mt****.rcfiles - Make a new folder named
etcinsideroot. Make a file namedrecovery.fstab- Use THIS FILE as a reference point and edit it.
- You Have to edit the Mount Addresses (Like /dev/block/platform/mtk-msdc.0/11230000.msdc0/by-name/system), Alternate Short Mount Addresses (Like /dev/block/mmcblk0p20).
You can get Some of the Mount Addresses by ADB Commands from PC, using
adb shell cat /proc/self/mountstatsoradb shell cat /proc/self/mountsoradb shell cat /proc/self/mountinfo. Also check whether the Basic FSType (emmc or ext4) of the partitions match with your devices. If you fail to know the Alternate Short Mount Addresses, Just erase them.
- Make a new folder named
sbininsideroot. Make a file namedpermissive.shwith File Permission set to "644" by usingchmod a+x permissive.shshell command- The file must contain the below content:
#!/sbin/sh setenforce 0 # Get your device's block path where "system", "recovery", etc. lives. # That can be "/dev/block/bootdevice/by-name" or something like that. mkdir -p /dev/block/platform/mtk-msdc.0/by-name/ busybox mount -o bind /dev/block/platform/mtk-msdc.0/11230000.msdc0/by-name/ /dev/block/platform/mtk-msdc.0/by-name/
- The file must contain the below content:
- Make a new File, name it
Android.mk, with the below content# Replace $$DEVICE$$ with your Device Name's Value. Mine is Primo_RX5. # Replace $$BRAND$$ with your Brand's / Manufacturer's Value, Mine is WALTON ifneq ($(filter $$DEVICE$$,$(TARGET_DEVICE)),) LOCAL_PATH := device/$$BRAND$$/$$DEVICE$$ include $(call all-makefiles-under,$(LOCAL_PATH)) endif
- Make a new File, name it
AndroidProducts.mk, with the below content# Replace $$DEVICE$$ with your Device Name's Value. # Replace $$BRAND$$ with your Brand's / Manufacturer's Value. # The part of last line in mine looks like "omni_Primo_RX5.mk" LOCAL_PATH := device/$$BRAND$$/$$DEVICE$$ PRODUCT_MAKEFILES := $(LOCAL_PATH)/omni_$$DEVICE$$.mk
- Make a new File, name it
BoardConfig.mk, with the below contentLOCAL_PATH := device/$$BRAND$$/$$DEVICE$$ TARGET_BOARD_PLATFORM := mt6735 # From ro.mediatek.platform, but lowercase value TARGET_NO_BOOTLOADER := true TARGET_BOOTLOADER_BOARD_NAME := Primo_RX5 # From ro.product.board # These two are for MTK Chipsets only BOARD_USES_MTK_HARDWARE := true BOARD_HAS_MTK_HARDWARE := true # Recovery TARGET_USERIMAGES_USE_EXT4 := true TARGET_USERIMAGES_USE_F2FS := true # To add info about F2FS Filesystem Data Block # Put The Size of your Recovery Partition below, get it from your "MT****_Android_scatter.txt" BOARD_RECOVERYIMAGE_PARTITION_SIZE := 16777216 # BOARD_USES_FULL_RECOVERY_IMAGE := true # Uncomment this line if you want to remove size restriction BOARD_FLASH_BLOCK_SIZE := 0 # Might be different for your chip BOARD_HAS_NO_REAL_SDCARD := true # Depricated # BOARD_HAS_NO_SELECT_BUTTON := true # Depricated BOARD_SUPPRESS_SECURE_ERASE := true BOARD_HAS_NO_MISC_PARTITION := true # Delete if your partition table has /misc BOARD_RECOVERY_SWIPE := true BOARD_USES_MMCUTILS := true BOARD_SUPPRESS_EMMC_WIPE := true BOARD_CHARGER_SHOW_PERCENTAGE := true RECOVERY_SDCARD_ON_DATA := true # Optional: If /sdcard partition is emulated on /data partition # TWRP stuff TW_EXCLUDE_SUPERSU := true # true/false: Add SuperSU or not TW_INCLUDE_CRYPTO := true # true/false: Add Data Encryption Support or not TW_INPUT_BLACKLIST := "hbtp_vm" # Optional: Disables virtual mouse TW_SCREEN_BLANK_ON_BOOT := true TW_THEME := portrait_hdpi # Set the exact theme you wanna use. If resulation doesn't match, define the height/width DEVICE_RESOLUTION := 720x1280 # The Resolution of your Device TARGET_SCREEN_HEIGHT := 1280 # The height TARGET_SCREEN_WIDTH := 720 # The width TARGET_RECOVERY_PIXEL_FORMAT := "RGBA_8888" # Set the Brightness Control File Path below (as per your chip/device) TW_BRIGHTNESS_PATH := /sys/class/leds/lcd-backlight/brightness TW_SECONDARY_BRIGHTNESS_PATH := /sys/devices/platform/leds-mt65xx/leds/lcd-backlight/brightness # Set the Path of Logical Units (LUNs) for Storage below (as per your chip/device) TARGET_USE_CUSTOM_LUN_FILE_PATH := /sys/devices/platform/mt_usb/musb-hdrc.0.auto/gadget/lun%d/file TARGET_USE_CUSTOM_LUN_FILE_PATH := /sys/class/android_usb/android0/f_mass_storage/lun/file TW_MAX_BRIGHTNESS := 255 TW_DEFAULT_BRIGHTNESS := 80 # Set custom brightness, low is better TW_INCLUDE_NTFS_3G := true # Include NTFS Filesystem Support TW_INCLUDE_FUSE_EXFAT := true # Include Fuse-ExFAT Filesystem Support TWRP_INCLUDE_LOGCAT := true # Include LogCat Binary TW_INCLUDE_FB2PNG := true # Include Screenshot Support TW_DEFAULT_LANGUAGE := en # Set Default Language TW_EXTRA_LANGUAGES := false # Kernel TARGET_IS_64_BIT := true # true/false: Determine if the device is 64-bit or not TARGET_PREBUILT_KERNEL := $(LOCAL_PATH)/prebuilt/zImage TARGET_PREBUILT_RECOVERY_KERNEL := $(LOCAL_PATH)/prebuilt/zImage # Get the CMDLine, Base, Pagesize and offsets from Unpacked recovery image and put below BOARD_KERNEL_CMDLINE := bootopt=64S3,32N2,64N2 androidboot.selinux=permissive BOARD_KERNEL_BASE := 0x40078000 BOARD_KERNEL_PAGESIZE := 2048 BOARD_MKBOOTIMG_ARGS := --ramdisk_offset 0x03f88000 --tags_offset 0x0df88000 # Set FSTAB TARGET_RECOVERY_FSTAB := $(LOCAL_PATH)/recovery/root/etc/recovery.fstab TARGET_BOARD_SUFFIX := _64 # Remove if the device is 32-bit TARGET_USES_64_BIT_BINDER := true # Remove if the device is 32-bit # Architecture # According to the device's architecture (64-bit or 32-bit) ifeq ($(TARGET_IS_64_BIT),true) TARGET_ARCH := arm64 TARGET_ARCH_VARIANT := armv8-a TARGET_CPU_ABI := arm64-v8a TARGET_CPU_ABI2 := TARGET_CPU_VARIANT := cortex-a53 TARGET_2ND_ARCH := arm TARGET_2ND_ARCH_VARIANT := armv7-a-neon TARGET_2ND_CPU_ABI := armeabi-v7a TARGET_2ND_CPU_ABI2 := armeabi TARGET_2ND_CPU_VARIANT := cortex-a53 TARGET_CPU_ABI_LIST_64_BIT := $(TARGET_CPU_ABI) TARGET_CPU_ABI_LIST_32_BIT := $(TARGET_2ND_CPU_ABI),$(TARGET_2ND_CPU_ABI2) TARGET_CPU_ABI_LIST := $(TARGET_CPU_ABI_LIST_64_BIT),$(TARGET_CPU_ABI_LIST_32_BIT) else TARGET_ARCH := arm TARGET_ARCH_VARIANT := armv7-a-neon TARGET_CPU_ABI := armeabi-v7a TARGET_CPU_ABI2 := armeabi TARGET_CPU_VARIANT := cortex-a7 TARGET_CPU_ABI_LIST := $(TARGET_CPU_ABI),$(TARGET_CPU_ABI2) endif
- Make a new File, name it
omni_$$DEVICE$$.mk, with the below content$(call inherit-product, $(SRC_TARGET_DIR)/product/full_base.mk) # Add this line if your device is 64-bit $(call inherit-product, $(SRC_TARGET_DIR)/product/core_64_bit.mk) # Otherwise, If you have 32-bit device, add the below line instead of above line $(call inherit-product, $(SRC_TARGET_DIR)/product/core_minimal.mk # Another common config inclusion $(call inherit-product, $(SRC_TARGET_DIR)/product/embedded.mk) # If you are building from OmniROM's minimal source, Inherit some common Omni stuff. $(call inherit-product, vendor/omni/config/common.mk) # Replace $$DEVICE$$ with your Device Name's Value. # Replace $$BRAND$$ with your Brand's / Manufacturer's Value. PRODUCT_COPY_FILES += device/$$BRAND$$/$$DEVICE$$/prebuilt/zImage:kernel # Fles under $(LOCAL_PATH)/recovery/root/ gets automatically copied into recovery # PRODUCT_COPY_FILES += $(LOCAL_PATH)/recovery/root/*:root/* PRODUCT_DEVICE := $$DEVICE$$ PRODUCT_NAME := omni_$$DEVICE$$ PRODUCT_BRAND := $$BRAND$$ PRODUCT_MODEL := $$DEVICE$$ PRODUCT_MANUFACTURER := $$BRAND$$ # Forcefully add mtp support (adb is already there) PRODUCT_DEFAULT_PROPERTY_OVERRIDES += \ persist.sys.usb.config=mtp # Add fingerprint from Stock ROM build.prop PRODUCT_BUILD_PROP_OVERRIDES += \ # These lines are from my device. You MUST Replace yours. BUILD_FINGERPRINT="WALTON/Primo_RX5/Primo_RX5:6.0/MRA58K/1465782828:user/release-keys" \ PRIVATE_BUILD_DESC="full_gionee6735_65u_m0-user 6.0 MRA58K 1465782828 release-keys"
- If you have done the above process entirely online inside github.com, then it is okay.
- But, if you have done the above things Locally on your PC, Just upload the entire Folder or
git pushto server.No detail or tutorial will be provided here. This is A-B-C of Git, Man!
- Go to https://travis-ci.org/ and SignUp there using GitHub.
- Go to https://travis-ci.org/profile/ and Add the Repository there by tapping on the Radio Button switch at the right side of the Repository name.
- Now, On its further right corner, you will find an individual repository
Settingsbutton. Click it. You will be on the Repository's Settings Page Now.- Go below where "Environment Variables" is written.
- Add "GitOAUTHToken" as New Environment Variables' Name and put your GitHub Token's value as it's Value here.
- To Start the Build Process, go to your created TWRP Device Tree in GitHub.
- Make a file named
.travis.ymlwith below contentos: linux dist: bionic language: generic sudo: required git: depth: 1 addons: apt: update: - true services: - docker before_install: - docker pull fr3akyphantom/droid-builder:latest before_script: - cd $HOME && mkdir twrp # download the TWRP Compressed Source Files from PhantomZone54's Release # Uncomment & Use below line If Building for Lollipop-based Devices # - TWRP_SOURCE="https://github.com/PhantomZone54/twrp_sources_norepo/releases/download/v3.3.1-20200222/MinimalOmniRecovery-twrp-5.1-norepo-20200222.tar.xz" # Use below line If Building for Marshmallow-based Devices - TWRP_SOURCE="https://github.com/PhantomZone54/twrp_sources_norepo/releases/download/v3.3.1-20200222/MinimalOmniRecovery-twrp-6.0-norepo-20200222.tar.xz" # Uncomment & Use below line If Building for Nougat-based Devices # - TWRP_SOURCE="https://github.com/PhantomZone54/twrp_sources_norepo/releases/download/v3.3.1-20200222/MinimalOmniRecovery-twrp-7.1-norepo-20200222.tar.xz" - wget -q ${TWRP_SOURCE} -O $HOME/twrp.tar.xz - tar -xJf twrp.tar.xz --directory $HOME/twrp/ && rm twrp.tar.xz script: # Replace your $$USERNAME$$, $$REPO_URL$$, $$BRAND$$, $$DEVICE$$ - cd $HOME/twrp/ && git clone https://github.com/$$USERNAME$$/$$REPO_URL$$.git device/$$BRAND$$/$$DEVICE$$ - rm -rf bootable/recovery && git clone https://github.com/omnirom/android_bootable_recovery -b android-9.0 --depth 1 bootable/recovery - | docker run --rm -i -e USER_ID=$(id -u) -e GROUP_ID=$(id -g) -v "$(pwd):/home/builder/twrp/:rw,z" -v "${HOME}/.ccache:/srv/ccache:rw,z" fr3akyphantom/droid-builder bash << EOF cd /home/builder/twrp/ source build/envsetup.sh # Choose build flavor as "eng" or "userdebug" BUILD_FLAVOR="eng" lunch omni_$$DEVICE$$-${BUILD_FLAVOR} make -j$(nproc --all) recoveryimage exit EOF after_success: - export version=$(cat bootable/recovery/variables.h | grep "define TW_MAIN_VERSION_STR" | cut -d '"' -f2) - cp $HOME/twrp/out/target/product/$$DEVICE$$/recovery.img $HOME/twrp/TWRP-$version-$$DEVICE$$-$(date +"%Y%m%d")-Unofficial.img - cd $HOME/twrp/ # Optional: You might need to switch from https://transfer.sh to https://file.io # - curl -s --upload-file TWRP-$version-$$DEVICE$$-$(date +"%Y%m%d")-Unofficial.img https://transfer.sh/ && echo "" deploy: skip_cleanup: true provider: releases # The secret api_key will be loaded from the environment variables api_key: $GitOAUTHToken file_glob: true file: $HOME/twrp/*.img on: tags: false repo: $$USERNAME$$/$$REPO_URL$$ # Optional: If you want to deploy on different repository branch: master # Optional: Needs to be exact as the config branch branches: only: - master # Set travis builder branch(es) names except: - /^(?i:untagged)-.*$/ - /^v\d+\.\d+(\.\d+)?(-\S*)?$/
- When you save the .travis.yml file for the first time, the build will automatically start.
- You can see the progress of the build on https://travis-ci.org/$$USERNAME$$/$$REPO_URL$$/
- After the first build, you can see the result on the GitHub Repository's Releases Page at https://github.com/$$USERNAME$$/$$REPO_URL$$/releases/
- You can also download the file from viewing the Travis CI log, where the script uploaded it into https://transfer.sh/
- Flash the newly-build Recovery. It is better Not to Use with Stock ROM.
- If The Recovery does not Boot,
- Unpack the Stock Recovery Image again, and double-check properties used in TWRP Tree
- Double-check files that are included in the Tree
- If the Recovery starts Upside-Down,
- Edit BoardConfig.mk and insert the below line before the
includepart (last line)BOARD_HAS_FLIPPED_SCREEN := true
- Edit BoardConfig.mk and insert the below line before the
please read and understand about some updates/informations:
Custom Recovery for MediaTek devices-0.md
0. Copying firmware files to the Device Tree - Mediatek.md
If your device has A10+ so write in there.