内核集成
约 922 字大约 3 分钟
YukiSU 只支持外部 CONFIG_KSU=m,不支持 built-in CONFIG_KSU=y。本页将 kernel/ 作为 external module,使用已经配置并成功构建的目标内核树生成 kernelsu.ko。
支持范围与前置条件
- Android 12(API 31)及以上的 ARM64 GKI 2.0 设备;
- Linux 5.10 及以上;当前 CI 目标覆盖到
android17-6.18; - 与真机完全对应的源码、配置、符号版本和构建输出;
- 构建树中已有
vmlinux; CONFIG_MODULES=y、CONFIG_KSU=m;CONFIG_KPROBES=y、CONFIG_KRETPROBES=y、CONFIG_HAVE_SYSCALL_TRACEPOINTS=y;- 可用的 Clang/LLVM、主机 C 编译器、GNU make、Python 3 与 Git。
仓库维护的标准 DDK 目标是:
android12-5.10 android13-5.10 android13-5.15 android14-5.15
android14-6.1 android15-6.6 android16-6.12 android17-6.18这 8 个标准 DDK 目标由 CI 构建。厂商内核仍须匹配上述源码、配置和符号版本。设备升级 Android 后可以保留原有 KMI,因此应按目标 boot 的 kernel release 选择 KMI。
使用目标内核树构建
export KDIR="/path/to/kernel/out"
export CLANG_PATH="/path/to/clang/bin"
export PATH="$CLANG_PATH:$PATH"
export CROSS_COMPILE=aarch64-linux-gnu-
export ARCH=arm64
export LLVM=1
export LLVM_IAS=1
git clone --branch v1.8.0 --recurse-submodules https://github.com/Rouyashiki/YukiSU
cd YukiSU/kernel
test -f include/uapi/supercall.h
make clean
make CONFIG_KSU=m \
CONFIG_KSU_SUPERKEY=y \
CONFIG_KSU_YUKIZYGISK=y \
CC=clang
llvm-strip -d kernelsu.koKDIR 必须指向已经配置和构建的目录。使用 O=out 时通常指向 output tree,不是源码根目录;该目录还应保留 vmlinux,因为末尾的 check_symbol 会用它检查最终 LKM 的未解析符号。
android17-6.18 的 external-module 构建需要 M/MO 分离与新的 srcroot 语义,仓库 kernel/Makefile 与 Kbuild 已处理标准 android17-6.18 DDK 布局。若自定义输出目录名称或 vendor 6.18 构建系统改变了这些变量,需检查 make 日志中的 KMI、KBUILD_ARGS、srctree、objtree,确认它们指向目标源码与输出树。
成功产物位于:
YukiSU/kernel/kernelsu.ko配置选项
CONFIG_KSU_SUPERKEY=y只编入 SuperKey verifier 与可修补数据区。当前有效 salt/hash/验证模式由ksud在镜像修补时写进最终 LKM;设置KSU_SUPERKEY=<value>不能替代镜像修补步骤。常规官方 Manager 仍可走 APK 签名认证。CONFIG_KSU_YUKIZYGISK=y编入 YukiZygisk 内核 Hook;关闭后基础 Root、App Profile 与模块生命周期仍可构建,但不能只靠用户空间文件补回这些 Hook。CONFIG_KSU_KRETPROBES_SUCOMPAT仍由Kconfig声明,但设置它不会切换 sucompat 实现,集成时无需设置。
模块 preinit 的构建条件
preinit runner 是嵌入 LKM 的静态 nolibc 程序。Kbuild 检查目标构建树的 usr/include/linux/unistd.h;缺少已安装的内核 UAPI headers 时,会输出 preinit disabled 并以 KSU_NO_PREINIT 构建。此时生成的 .ko 不具备模块 preinit 能力。需要 preinit 时,先为目标内核安装 UAPI headers,再重新构建并确认日志没有 preinit disabled。
Android 12 到 17 的兼容代码
Kbuild 通过源码探测选择 SELinux credential、seccomp filter release、vfs_getattr、dcache flush、path_umount 等 API 分支;这也是 5.10、5.15、6.1、6.6、6.12 与 6.18 能共用一套源码的原因。移植到厂商内核时,还需测试所选 API 分支的实际行为。
新 bionic 的执行路径还会使用 execveat。当前 TSR 已同时覆盖 ksud 集成、sucompat、ADB root、sulog/init 跟踪与可选 YukiZygisk observer;移植或裁剪 Hook 时应同时测试 execve 与 execveat。
验证
至少检查:
file kernelsu.ko
llvm-readelf -h -S -s kernelsu.ko
modinfo kernelsu.ko还要保留构建使用的 commit、KDIR、配置、kernel release、vmlinux 身份和最终 LKM SHA-256。设备测试应加载该哈希对应的 .ko,检查内核日志,再验证重启与 Root 授权。
要直接使用仓库 DDK 与完整 APK 流程,见构建指南;镜像参数见启动镜像命令。