Halium-9.0 - Using Gitlab CI scripts¶
For some devices, Halium-9.0 (and later) ports can be built based on just the kernel source code for your specific device and SoC (system on chip). This method makes use of scripts that download and prepare the kernel source, build the boot image and combine this together with other necessary components, thus creating the files needed which can subsequently be flashed to the device.
Setting up the build environment¶
Assuming you have already installed the tools specified in the section on Setting up the build environment, there are just a few more to add before your build environment is complete. Run this commmand to add them:
sudo apt install android-tools-mkbootimg bc bison build-essential \ ca-certificates cpio curl flex git kmod libssl-dev libtinfo5 python2 \ sudo unzip wget xz-utils img2simg jq
Obtaining kernel source¶
Locate the kernel source code for your device. Fork this repo to your own Github account so that you can easily make any necessary adjustments as your work progresses. Make a note of the link to your repo. It needs to be specified in a configuration script for the build (see Configure, build and install).
Clone a Gitlab CI repo to base your build on¶
Ideally you should base your build on a previous build for a device with similar platform/SoC. However, if unsure, use the repo for Xiaomi-violet
Configure, build and install¶
Go through the file
deviceinfo and make all necessary adjustments so that it conforms to your device. The first lines should be self-explanatory.
To complete the
deviceinfo_flash_offset_ lines, you will need to obtain and examine an existing
boot.img for your particular device, e.g. from a LineageOS ROM. Lineage provides a Python script for reading the information in question. Download this script and run it on the boot image you have obtained:
<path-to-unpack_bootimg.py> --boot_img <path-to-boot.img>
This tool will not supply the base offset, only the others, and it gives the absolute value. In other words, the value returned by the script for the kernel offset is in fact the (base offset + kernel offset). In the same manner, the other values are also the sum of the base offset and the offset value in question. Note that offset values for devices that share the same SoC will be the same.
Using this information, you can calculate the correct values for the offsets to be specified in the file
deviceinfo. If in doubt, seek help.
When you have finished editing
deviceinfo, carefully read and follow the instructions on this page to build and install, remembering to replace ‘violet’ with your device’s codename.