A set of nix packages (derivations) to build Android boot.img
and AnyKernel installation zip files for given kernel source code.
This code is for my personal use and is for reference only. I do not guarantee stability or backwards compatibility.
Currently I build boot images for 3 devices..
.#amazon-fire-hd-karnak
: Amazon Fire HD 8 2018. Kernel compiles, but KernelSU doesn't work for lack of 32-bit userland app..#moto-rtwo-lineageos-21
: Motorola Edge 2023, unofficial LineageOS 21. Working perfectly..#oneplus-8t-blu-spark
: OnePlus 8T, Blu_spark kernel for LineageOS 21. Working perfectly.
See kernels.nix
for definitions of pipelines (builds for different devices).
pipeline
takes these arguments:
arch
: Kernel architecture, usuallyarm64
.anyKernelVariant
: Variant of AnyKernel used during packaging. Can have two values:osm0sis
: Official version. Works with devices before Android Generic Kernel Image (GKI).kernelsu
: Modified by KernelSU team. Works with devices using GKI.
clangVersion
: Version of clang used in kernel build.- Can be set to any version present in nixpkgs. Currently the value can be 8 to 17.
- If set to
latest
, will use the latest clang in nixpkgs. Recommended. - If set to
null
, uses Google's GCC 4.9 toolchain instead.
enableKernelSU
: Whether to apply KernelSU patch.kernelDefconfigs
: List of kernel config files applied during build.- Older kernels usually have a single
_defconfig
file. Newer devices may have several. - If you're building for a open source third party ROM, check the
android_device_[Codename of your device]
repo andandroid_device_[Codename of your device]_common
repo, take a look at theBoardConfig.mk
andBoardConfigCommon.mk
, and take note of all config files inTARGET_KERNEL_CONFIG
variable. - If you do not have access to such repos, you will need to do some guesswork.
- Older kernels usually have a single
kernelImageName
: Generated kernel image name at end of compilation process. UsuallyImage
. If you are unsure, again check theBoardConfig.mk
orBoardConfigCommon.mk
, and look forBOARD_KERNEL_IMAGE_NAME
.kernelMakeFlags
: Additional make flags passed to kernel build process. Can be used to ignore some compiler warnings.kernelPatches
: List of patch files to be applied to kernel.kernelSrc
: Source code of the kernel. Can be supplied withfetchgit
,fetchGitHub
or alike, or provided with nvfetcher, which is already set up in this repo.oemBootImg
: Optional, a working boot image for your device, either from official OS or a third party OS (like LineageOS). If this is provided, aboot.img
will be generated, which can be directly flashed onto your device.
GPLv3.