中文（简体） | English

KernelSU_Action

⚠️ ⚠️ ⚠️ 先阅读 README！！！

Plus版本，可以编译内核、AnyKernel3 和 boot 镜像

编译 Non-GKI 内核的 Action，可选添加 Magisk 和 KernelSU，具有一定的普遍性。

⚠️ 本项目的本质是简化配置编译环境等步骤（所有类似的仓库都是如此），内核编译的各项参数仍需你自己寻找，否则编译将失败！

已测试的内核版本

5.15
5.10
5.4
4.19
4.14
4.9
4.4
其他版本 可能 支持，但是你必须自行测试！

使用

⚠️ ⚠️ ⚠️ 编译成功后，会在 Action 上传 AnyKernel3 等一系列内容，已经关闭设备检查，请确保手机已经解锁后再刷入！

Star 本仓库，然后点击 “Use this template”,按照你想要的方式创建仓库

Star 是作者的动力来源，请不要吝啬你的 Star！

将配置文件改名为 config.properties（名称可以自定义，只要是纯文本文件即可）
在配置文件中编写你喜欢的配置，配置文件的注释可以在本README.md的下半部分找到。
打开工作流文件（名称可自定义，默认为 build-kernel.yml ），找到以下内容：

    steps:
    - name: Check out
      uses: actions/checkout@v3

    - name: Read Building Configuration
      run: |


->>>>>>> CONFIG_ENV=config.properties.example <<<<<<<-


        echo "KERNEL_SOURCE=$(cat $CONFIG_ENV | grep -w "KERNEL_SOURCE" | head -n 1 | cut -d "=" -f 2)" >> $GITHUB_ENV
        echo "KERNEL_SOURCE_BRANCH=$(cat $CONFIG_ENV | grep -w "KERNEL_SOURCE_BRANCH" | head -n 1 | cut -d "=" -f 2)" >> $GITHUB_ENV
        echo "KERNEL_CONFIG=$(cat $CONFIG_ENV | grep -w "KERNEL_CONFIG" | head -n 1 | cut -d "=" -f 2)" >> $GITHUB_ENV

将 config.properties.example 改为你的配置文件名称；

如果你创建了一个叫 config_abcdefg.envaaa 的配置文件，那你就应该在这里填写 config_abcdefg.envaaa。

之后进入 Actions，点击绿色按钮I understand my workflows, go ahead and enable them. 点击选项（默认为 Build ）会看见右边的大对话框的上面会有Run workflows，点击它会启动构建。若勾选 Release，则会发布 Release。

警告 ⚠️ ⚠️ ⚠️

请务必先仔细，认真阅读并理解以下的配置文件注释！！！

❓如何编写配置❓

配置

其中有些配置互相矛盾，请搞清逻辑关系后再进行配置！！！

Kernel

Kernel Source

（HTTP链接）

修改为你的内核仓库地址

例如: https://github.com/magojohnji/msm-4.14.git

支持 git 仓库或者 zip 压缩包、tar.gz 压缩包的直链

Tips：此项应首选 git 仓库

Kernel Source Branch

（字符串）

修改为你的内核分支名称

例如: TDA，base，su，13，R，请自行查阅

Kernel Config

（字符串）

修改为你的内核配置文件名

例如: vendor/wayne_defconfig，vendor/violet-perf_defconfig，munch_defconfig 等

Tips：可在内核源码的 arch/arm64/configs(/vendor) 中寻找

Arch

（字符串）

修改为你的 CPU 架构，一般为 arm64

例如: arm64

Kernel Image Name

（字符串）

修改为需要刷写的 kernel binary，一般与你的 aosp-device tree 里的 BOARD_KERNEL_IMAGE_NAME 是一致的

例如: Image.gz-dtb

常见还有 Image、Image.gz

Clang

Enable Clang

（ true 或 false ）

我们提供可自定义是否开启 Clang 编译

Use AOSP Clang

（ true 或 false ）

可以选择是否用 AOSP 的 Clang

AOSP CLANG System

（字符串）

Clang所适用的系统

例如： darwin-universal darwin-x86 linux-x86 windows-x86 windows-x86_32

默认为 linux-x86，需要自定义请去 AOSP Clang 查看。

AOSP Clang Branch

（字符串）

我们提供可自定义 Google 上游分支的选项，主要的有分支有：

Clang 分支
main
master
master-kernel-build-2021
master-kernel-build-2022

或者其它分支，请根据自己的需求在 https://android.googlesource.com/platform/prebuilts/clang/host/linux-x86 中寻找

AOSP Clang Version

（字符串）

填写需要使用的 Clang 版本

Clang 版本	对应 Android 版本	AOSP-Clang 版本
12.0.5	Android S	r416183b
14.0.6	Android T	r450784d
14.0.7		r450784e
15.0.1		r458507

谷歌官方文档如此，但经验证个别版本无法下载，如果无法下载请设为 r450784e

一般 Clang12 就能通过大部分 4.14 及以上的内核的编译我自己的 Redmi Note 7 Pro (Kenrel 4.14) 使用的是 ~~r450784d~~ r450784e

Tips：如仍提示错误，则可去 AOSP Clang 中寻找可用分支、版本

Use Custom Clang

（ true 或 false ）

可以使用除 Google 官方以外的 Clang，如 ZyCromerZ-Clang

Custom Clang Source

（HTTP链接）

支持 git 仓库或者 zip 压缩包、tar.gz 压缩包的直链

Tips：如果是 git 仓库，请填写包含.git的链接

Custom Clang Branch

（字符串）

如果使用自定义 Clang，则可自定义第三方 Clang 的分支，例如 main

GCC

Enable GCC

（ true 或 false ）

可以配置是否启用 GCC 交叉编译

Enable AOSP GCC ARM64

（ true 或 false ）

是否下载 Google 官方的 AOSP GCC，启用 GCC 64 交叉编译

如果 Enable GCC 设为false，则此项无意义

Enable GCC ARM32

（ true 或 false ）

是否下载 Google 官方的 AOSP GCC，启用 GCC 32 交叉编译

如果 Enable GCC 设为false，则此项无意义

AOSP GCC System

（字符串）

用于编译内核的系统类型

Tips：如果使用 macOS 编译，则填写 darwin-x86

AOSP GCC ARM64 Version

（字符串）

顾名思义，AOSP GCC ARM64 的版本号，一般默认为 aarch64-linux-android-4.9

AOSP GCC ARM32 Version

（字符串）

顾名思义，AOSP GCC ARM32 的版本，一般默认为 arm-linux-androideabi-4.9

AOSP GCC Android Version

（字符串）

顾名思义，AOSP GCC 所对应的 Android 的版本

如：12.1.0，10.0.0

AOSP GCC Release

（字符串）

顾名思义，AOSP GCC 所对应的发布版本号

如：r27

Tips：以上 AOSP Gcc 如需自定义请去 [AOSP Gcc](如需自定义请至 https://android.googlesource.com/platform/prebuilts/gcc/) 自行寻找可用分支、版本

Use Custom Gcc 64

（ true 或 false ）

可以配置是否使用自定义的 Gcc 64

如果 Enable GCC 设为false，则此项无意义

Custom Gcc 64 Source

（HTTP链接）

自定义 Gcc 64 的源代码，支持 git 仓库或者 zip 压缩包、tar.gz 压缩包的直链

Tips：如果是 git 仓库，请填写包含.git的链接

Custom Gcc 64 Branch

（字符串）

如果使用自定义 Gcc 64，则可自定义第三方 Gcc 的分支，例如 main

Custom Gcc 64 Bin

（字符串）

可自定义 Gcc 64 的执行文件名称，AOSP Gcc 为 aarch64-linux-android-

Use Custom Gcc 32

（ true 或 false ）

可以配置是否使用自定义的 Gcc 32

如果 Enable GCC 设为false，则此项无意义

Custom Gcc 32 Source

（HTTP链接）

自定义 Gcc 32 的源代码，支持 git 仓库或者 zip 压缩包、tar.gz 压缩包的直链

Tips：如果是 git 仓库，请填写包含.git的链接

Custom Gcc 32 Branch

（字符串）

如果使用自定义 Gcc 32，则可自定义第三方 Gcc 的分支，例如 main

Custom Gcc 32 Bin

（字符串）

可自定义 Gcc 32 的执行文件名称，AOSP Gcc 为 arm-linux-androideabi-

Enable KernelSU

（ true 或 false ）

启用 KernelSU，用于排查内核故障或单独编译内核

Kernel Installer

（HTTP链接）

KernelSU 的安装脚本链接，以便使用第三方版本

Tips： tiann 原版：https://raw.githubusercontent.com/tiann/KernelSU/main/kernel/setup.sh MlgmXyysd修改版：https://raw.githubusercontent.com/MlgmXyysd/KernelSU_Debug/master/kernel/setup.sh

KernelSU Branch or Tag

（字符串）

选择 KernelSU 的分支或 tag:

main 分支(开发版): KERNELSU_TAG=main
最新 TAG(稳定版): KERNELSU_TAG=
指定 TAG(如v0.5.2): KERNELSU_TAG=v0.5.2

请自行寻找

KernelSU Manager signature size and hash

（字符串）

自定义KernelSU管理器签名的size值和hash值，如果不需要自定义管理器则请留空或填入官方默认值：

KSU_EXPECTED_SIZE=0x033b

KSU_EXPECTED_HASH=0xb0b91415

可键入ksud debug get-sign <apk_path>获取apk签名的size值和hash值

Build KernelSU Boot IMG

（ true 或 false ）

从之前的 Workflows 合并进来的，可以查看历史提交

编译含KernelSU的 boot.img，需要你提供 KernelSU Source boot image

KernelSU Source Boot Image

（HTTP链接）

故名思义，提供一个源系统可以正常开机的 boot 镜像，需要直链，最好是同一套内核源码以及与你当前系统同一套设备树从 aosp 构建出来的。ramdisk 里面包含分区表以及 init，没有的话构建出来的镜像会无法正常引导。

例如: https://raw.githubusercontent.com/abc/def/main/boot/boot.img

Disable LTO

（ true 或 false ）

LTO 用于优化内核，但有些时候会导致错误

Disable CC_WERROR

（ true 或 false ）

用于修复某些不支持或关闭了Kprobes的内核，修复KernelSU未检测到开启Kprobes的变量抛出警告导致错误

Add Kprobes Config

（ true 或 false ）

自动在 defconfig 注入参数，启用 Kprobes 支持

Add overlayfs Config

（ true 或 false ）

为 KernelSU 模块和 system 分区读写提供支持，自动在 defconfig 注入参数

Enable ccache

（ true 或 false ）

启用缓存，让第二次编译内核更快，最少可以减少 2/5 的时间

Need DTBO

（ true 或 false ）

上传 DTBO 部分设备需要

Extra cmds

（字符串）

有的内核需要加入一些其它编译命令，才能正常编译，一般不需要其它的命令，请自行搜索自己内核的资料请在命令与命令之间用空格隔开

例如: LLVM=1 LLVM_IAS=1

TC Custom cmds

（字符串）

编译工具链配置，~~自己改改这些配置应该都会吧 :)~~ 自行询问内核作者或分析内核编译脚本

有用的技巧（恭喜你读完了 `配置` 部分）

如果想要在修改文件后自动构建，则可以将 build-kernel.yml 的开头部分改成这样：

name: Build
on:
  push:
    branches: [ main ]
  workflow_dispatch:
    inputs:
      release:
        description: "Release"
        required: true
        default: false
        type: boolean

如果想要每天定时编译，则可以将 build-kernel.yml 的开头部分改成这样：

（每天 2:00 UTC 执行）

name: Build
on:
  schedule:
    - cron: "0 2 * * *"
  workflow_dispatch:
    inputs:
      release:
        description: "Release"
        required: true
        default: false
        type: boolean

当然你也可以将他们混合起来 :-)

config.properties实例

文件

这个文件适用于编译 RMX1971 Kernel 4.9 (Realme Q) 的带有 KernelSU 的内核：

KERNEL_SOURCE=https://gitlab.com/kssrao13882/kernel_realme_sdm710.git
KERNEL_SOURCE_BRANCH=13
KERNEL_CONFIG=KharaMe_defconfig
KERNEL_IMAGE_NAME=Image.gz
ARCH=arm64

ENABLE_CLANG=true
USE_AOSP_CLANG=false
AOSP_CLANG_SYSTEM=
AOSP_CLANG_BRANCH=
AOSP_CLANG_VERSION=
USE_CUSTOM_CLANG=true
CUSTOM_CLANG_SOURCE=https://github.com/kdrag0n/proton-clang.git
CUSTOM_CLANG_BRANCH=master

ENABLE_GCC=true
ENABLE_AOSP_GCC_ARM64=true
ENABLE_AOSP_GCC_ARM32=true
AOSP_GCC_SYSTEM=linux-x86
AOSP_GCC_ARM64_VERSION=aarch64-linux-android-4.9
AOSP_GCC_ARM32_VERSION=arm-linux-androideabi-4.9
AOSP_GCC_ANDROID_VERSION=12.1.0
AOSP_GCC_RELEASE=r27
USE_CUSTOM_GCC_64=false
CUSTOM_GCC_64_SOURCE=
CUSTOM_GCC_64_BRANCH=
CUSTOM_GCC_64_BIN=aarch64-linux-android-
USE_CUSTOM_GCC_32=false
CUSTOM_GCC_32_SOURCE=
CUSTOM_GCC_32_BRANCH=
CUSTOM_GCC_32_BIN=arm-linux-androideabi-

ENABLE_KERNELSU=true
KERNELSU_INSTALLER=https://raw.githubusercontent.com/tiann/KernelSU/main/kernel/setup.sh
KERNELSU_TAG=main
KSU_EXPECTED_SIZE=
KSU_EXPECTED_HASH=
BUILD_KERNELSU_BOOT_IMG=true
KERNELSU_SOURCE_BOOT_IMAGE=https://raw.githubusercontent.com/magojohnji/MAKSU/main/boot/boot_PE13_rmx1971.img

DISABLE-LTO=false
DISABLE_CC_WERROR=false
ADD_KPROBES_CONFIG=true
ADD_OVERLAYFS_CONFIG=true
ENABLE_CCACHE=true
NEED_DTBO=false
BUILDER_HOST=Github-Action

TC_CUSTOM_CMDS:CLANG_TRIPLE=aarch64-linux-gnu- CROSS_COMPILE=aarch64-linux-androidkernel-
EXTRA_CMDS:

这个文件适用于编译 violet Kernel 4.14 (Redmi Note 7 Pro) 的带有 KernelSU 的内核：

KERNEL_SOURCE=https://github.com/magojohnji/msm-4.14.git
KERNEL_SOURCE_BRANCH=R
KERNEL_CONFIG=vendor/violet-perf_defconfig
KERNEL_IMAGE_NAME=Image.gz-dtb
ARCH=arm64

ENABLE_CLANG=true
USE_AOSP_CLANG=false
AOSP_CLANG_SYSTEM=
AOSP_CLANG_BRANCH=
AOSP_CLANG_VERSION=
USE_CUSTOM_CLANG=true
CUSTOM_CLANG_SOURCE=https://gitlab.com/Panchajanya1999/azure-clang.git
CUSTOM_CLANG_BRANCH=main

ENABLE_GCC=true
ENABLE_AOSP_GCC_ARM64=false
ENABLE_AOSP_GCC_ARM32=false
AOSP_GCC_SYSTEM=
AOSP_GCC_ARM64_VERSION=
AOSP_GCC_ARM32_VERSION=
AOSP_GCC_ANDROID_VERSION=
AOSP_GCC_RELEASE=
USE_CUSTOM_GCC_64=true
CUSTOM_GCC_64_SOURCE=https://github.com/magojohnji/gcc-arm64.git
CUSTOM_GCC_64_BRANCH=gcc-master
CUSTOM_GCC_64_BIN=aarch64-linux-android-
USE_CUSTOM_GCC_32=true
CUSTOM_GCC_32_SOURCE=https://github.com/magojohnji/gcc-arm32.git
CUSTOM_GCC_32_BRANCH=master
CUSTOM_GCC_32_BIN=arm-linux-androideabi-

ENABLE_KERNELSU=true
KERNELSU_INSTALLER=https://raw.githubusercontent.com/tiann/KernelSU/main/kernel/setup.sh
KERNELSU_TAG=main
KSU_EXPECTED_SIZE=
KSU_EXPECTED_HASH=
BUILD_KERNELSU_BOOT_IMG=true
KERNELSU_SOURCE_BOOT_IMAGE=https://raw.githubusercontent.com/magojohnji/bin/main/boot_PE13_violet.img

DISABLE-LTO=false
DISABLE_CC_WERROR=false
ADD_KPROBES_CONFIG=true
ADD_OVERLAYFS_CONFIG=true
ENABLE_CCACHE=true
NEED_DTBO=false
BUILDER_HOST=Github-Action

TC_CUSTOM_CMDS:CROSS_COMPILE=aarch64-linux-gnu- CROSS_COMPILE_ARM32=arm-linux-gnueabi-
EXTRA_CMDS:AR=llvm-ar OBJDUMP=llvm-objdump STRIP=llvm-strip NM=llvm-nm OBJCOPY=llvm-objcopy LD=ld.lld

这个文件适用于编译 munch Kernel 4.19 (Redmi K40S) 的带有 KernelSU 的内核：

KERNEL_SOURCE=https://github.com/magojohnji/Realking_kernel_sm8250.git
KERNEL_SOURCE_BRANCH=base
KERNEL_CONFIG=munch_defconfig
KERNEL_IMAGE_NAME=Image.gz
ARCH=arm64

ENABLE_CLANG=true
USE_AOSP_CLANG=false
AOSP_CLANG_SYSTEM=
AOSP_CLANG_BRANCH=
AOSP_CLANG_VERSION=
USE_CUSTOM_CLANG=true
CUSTOM_CLANG_SOURCE=https://github.com/ZyCromerZ/Clang/releases/download/18.0.0-20230901-release/Clang-18.0.0-20230901.tar.gz
CUSTOM_CLANG_BRANCH=

ENABLE_GCC=false
ENABLE_AOSP_GCC_ARM64=false
ENABLE_AOSP_GCC_ARM32=false
AOSP_GCC_SYSTEM=
AOSP_GCC_ARM64_VERSION=
AOSP_GCC_ARM32_VERSION=
AOSP_GCC_ANDROID_VERSION=
AOSP_GCC_RELEASE=
USE_CUSTOM_GCC_64=false
CUSTOM_GCC_64_SOURCE=
CUSTOM_GCC_64_BRANCH=
CUSTOM_GCC_64_BIN=aarch64-linux-android-
USE_CUSTOM_GCC_32=false
CUSTOM_GCC_32_SOURCE=
CUSTOM_GCC_32_BRANCH=
CUSTOM_GCC_32_BIN=arm-linux-androideabi-

ENABLE_KERNELSU=true
KERNELSU_INSTALLER=https://raw.githubusercontent.com/tiann/KernelSU/main/kernel/setup.sh
KERNELSU_TAG=main
KSU_EXPECTED_SIZE=
KSU_EXPECTED_HASH=
BUILD_KERNELSU_BOOT_IMG=false
KERNELSU_SOURCE_BOOT_IMAGE=

MIX_KERNELSU_MAGISK_BOOT_IMAGE=false

DISABLE-LTO=false
DISABLE_CC_WERROR=false
ADD_KPROBES_CONFIG=true
ADD_OVERLAYFS_CONFIG=true
ENABLE_CCACHE=true
NEED_DTBO=true
BUILDER_HOST=Github-Action

TC_CUSTOM_CMDS:CROSS_COMPILE=aarch64-linux-gnu-
EXTRA_CMDS:NM=llvm-nm OBJDUMP=llvm-objdump STRIP=llvm-strip

其他

如果你有发现无法运行的情况，或需要添加、修改功能，请提出 Issue 来让我知道！

感谢

xiaoleGun
AnyKernel3
AOSP
tiann
topjohnwu
xiaoxindada
Tonyha
action

LICENSE

MIT License

Copyright (c) 2023 v阿布Abu

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Files

README_ZH-HANS.md

Latest commit

History

README_ZH-HANS.md

File metadata and controls

KernelSU_Action

⚠️ ⚠️ ⚠️ 先阅读 README！！！

已测试的内核版本

使用

警告 ⚠️ ⚠️ ⚠️

❓如何编写配置❓

配置

Kernel

Kernel Source

Kernel Source Branch

Kernel Config

Arch

Kernel Image Name

Clang

Enable Clang

Use AOSP Clang

AOSP CLANG System

AOSP Clang Branch

AOSP Clang Version

Use Custom Clang

Custom Clang Source

Custom Clang Branch

GCC

Enable GCC

Enable AOSP GCC ARM64

Enable GCC ARM32

AOSP GCC System

AOSP GCC ARM64 Version

AOSP GCC ARM32 Version

AOSP GCC Android Version

AOSP GCC Release

Use Custom Gcc 64

Custom Gcc 64 Source

Custom Gcc 64 Branch

Custom Gcc 64 Bin

Use Custom Gcc 32

Custom Gcc 32 Source

Custom Gcc 32 Branch

Custom Gcc 32 Bin

Enable KernelSU

Kernel Installer

KernelSU Branch or Tag

KernelSU Manager signature size and hash

Build KernelSU Boot IMG

KernelSU Source Boot Image

Disable LTO

Disable CC_WERROR

Add Kprobes Config

Add overlayfs Config

Enable ccache

Need DTBO

Extra cmds

TC Custom cmds

有用的技巧（恭喜你读完了 配置 部分）

config.properties实例

文件

其他

感谢

LICENSE

有用的技巧（恭喜你读完了 `配置` 部分）