构建属于你自己的安卓内核镜像

这个 Github Action 可以帮助你构建内核。它可以从一个配置文件中读取多个内核源，并使用不同的工具链构建它们。此外，它还支持使用 KernelSU 进行内核补丁，并上传构建好的内核镜像。

配置文件使用方法 快速开始 本地构建

Github Action

该 Action 包含两个作业：Set-repos 和 Build-Kernel。

Set-repos 作业从配置文件中读取内核源，并将其输出到 Build-Kernel 作业中。Build-Kernel 作业使用输出的内核源构建内核，并上传构建好的内核镜像。

启动方式

事件名称	描述
workflow_dispatch	手动触发构建。

构建流程

步骤	描述
Install prerequisites	安装构建所需的依赖
Setup Anykernel3	克隆 Anykernel3 仓库
Clone kernel source	克隆内核源码仓库
Get toolchains	获取所需的交叉编译工具链
Set args	设置构建参数
Update KernelSU	更新 KernelSU
Make defconfig	生成内核配置文件
Build kernel	编译内核
Upload Image	上传内核镜像文件
Upload Image.gz	上传内核镜像压缩文件
Upload dtb	上传设备树文件
Upload dtbo.img	上传设备树覆盖文件
Pack AnyKernel3.zip	打包 Anykernel3.zip
Upload AnyKernel3 image	上传 Anykernel3 镜像文件
Create GitHub Release	创建 GitHub Release

配置文件解析

基本配置文件案例

🤔 点击查看例子

[
  {
    "kernelSource": {
      "name": "DogDay-KernelSU-Proton-release",
      "repo": "https://codeberg.org/DogDayAndroid/android_kernel_xiaomi_thyme",
      "branch": "lineage-20.0",
      "device": "thyme",
      "defconfig": "thyme_defconfig"
    },
    "withKernelSU": true,
    "toolchains": [
      {
        "repo": "https://github.com/kdrag0n/proton-clang",
        "branch": "master",
        "name": "proton-clang",
        "binPath": ["bin"]
      }
    ],
    "params": {
      "ARCH": "arm64",
      "CC": "proton-clang/bin/clang",
      "externalCommand": {
        "CROSS_COMPILE": "proton-clang/bin/aarch64-linux-gnu-",
        "CROSS_COMPILE_ARM32": "proton-clang/bin/arm-linux-gnueabi-",
        "LD": "proton-clang/bin/ld.lld",
        "AR": "proton-clang/bin/llvm-ar",
        "NM": "proton-clang/bin/llvm-nm",
        "OBJCOPY": "proton-clang/bin/llvm-objcopy",
        "OBJDUMP": "proton-clang/bin/llvm-objdump",
        "READELF": "proton-clang/bin/llvm-readelf",
        "OBJSIZE": "proton-clang/bin/llvm-size",
        "STRIP": "proton-clang/bin/llvm-strip",
        "LDGOLD": "proton-clang/bin/aarch64-linux-gnu-ld.gold",
        "LLVM_AR": "proton-clang/bin/llvm-ar",
        "LLVM_DIS": "proton-clang/bin/llvm-dis"
      }
    },
    "AnyKernel3": {
      "use": true,
      "release": true,
      "repo": "https://github.com/easterNday/AnyKernel3/",
      "branch": "thyme"
    }
  },
  {
    "kernelSource": {
      "name": "DogDay-KernelSU-Proton-noanykernel-release",
      "repo": "https://codeberg.org/DogDayAndroid/android_kernel_xiaomi_thyme",
      "branch": "lineage-20.0",
      "device": "thyme",
      "defconfig": "thyme_defconfig"
    },
    "withKernelSU": true,
    "toolchains": [
      {
        "repo": "https://github.com/kdrag0n/proton-clang",
        "branch": "master",
        "name": "proton-clang",
        "binPath": ["bin"]
      }
    ],
    "params": {
      "ARCH": "arm64",
      "CC": "proton-clang/bin/clang",
      "externalCommand": {
        "CROSS_COMPILE": "proton-clang/bin/aarch64-linux-gnu-",
        "CROSS_COMPILE_ARM32": "proton-clang/bin/arm-linux-gnueabi-",
        "LD": "proton-clang/bin/ld.lld",
        "AR": "proton-clang/bin/llvm-ar",
        "NM": "proton-clang/bin/llvm-nm",
        "OBJCOPY": "proton-clang/bin/llvm-objcopy",
        "OBJDUMP": "proton-clang/bin/llvm-objdump",
        "READELF": "proton-clang/bin/llvm-readelf",
        "OBJSIZE": "proton-clang/bin/llvm-size",
        "STRIP": "proton-clang/bin/llvm-strip",
        "LDGOLD": "proton-clang/bin/aarch64-linux-gnu-ld.gold",
        "LLVM_AR": "proton-clang/bin/llvm-ar",
        "LLVM_DIS": "proton-clang/bin/llvm-dis"
      }
    },
    "AnyKernel3": {
      "use": false,
      "release": true,
      "repo": "https://github.com/easterNday/AnyKernel3/",
      "branch": "thyme"
    }
  },
  {
    "kernelSource": {
      "name": "DogDay-KernelSU-Proton-anykernel-norelease",
      "repo": "https://codeberg.org/DogDayAndroid/android_kernel_xiaomi_thyme",
      "branch": "lineage-20.0",
      "device": "thyme",
      "defconfig": "thyme_defconfig"
    },
    "withKernelSU": true,
    "toolchains": [
      {
        "repo": "https://github.com/kdrag0n/proton-clang",
        "branch": "master",
        "name": "proton-clang",
        "binPath": ["bin"]
      }
    ],
    "params": {
      "ARCH": "arm64",
      "CC": "proton-clang/bin/clang",
      "externalCommand": {
        "CROSS_COMPILE": "proton-clang/bin/aarch64-linux-gnu-",
        "CROSS_COMPILE_ARM32": "proton-clang/bin/arm-linux-gnueabi-",
        "LD": "proton-clang/bin/ld.lld",
        "AR": "proton-clang/bin/llvm-ar",
        "NM": "proton-clang/bin/llvm-nm",
        "OBJCOPY": "proton-clang/bin/llvm-objcopy",
        "OBJDUMP": "proton-clang/bin/llvm-objdump",
        "READELF": "proton-clang/bin/llvm-readelf",
        "OBJSIZE": "proton-clang/bin/llvm-size",
        "STRIP": "proton-clang/bin/llvm-strip",
        "LDGOLD": "proton-clang/bin/aarch64-linux-gnu-ld.gold",
        "LLVM_AR": "proton-clang/bin/llvm-ar",
        "LLVM_DIS": "proton-clang/bin/llvm-dis"
      }
    },
    "AnyKernel3": {
      "use": true,
      "release": false,
      "repo": "https://github.com/easterNday/AnyKernel3/",
      "branch": "thyme"
    }
  }
]

😲 单个配置模板

{
  "kernelSource": {
    "name": "",
    "repo": "",
    "branch": "",
    "device": "",
    "defconfig": ""
  },
  "withKernelSU": false,
  "toolchains": [
    {
      "repo": "",
      "branch": "",
      "name": "",
      "binPath": []
    }
  ],
  "params": {
    "ARCH": "",
    "CC": "",
    "externalCommand": {}
  },
  "AnyKernel3": {
    "use": false,
    "release": false,
    "repo": "",
    "branch": ""
  }
}

参数解析

总体来说，一共有如下

字段名称	描述
kernelSource	内核源代码的相关信息，包括名称、仓库地址、分支和设备类型。
withKernelSU	一个布尔值，表示是否使用了名为 `KernelSU` 的内核补丁工具。
toolchains	一个数组，包含了需要用到的工具链的相关信息，包括仓库地址、分支和名称。
params	一个对象，包含了构建参数的相关信息，其中包括了架构类型、交叉编译器、编译器等信息。
AnyKernel3	一个对象，包含了构建内核刷机包的相关信息，其中包括了使用的 `AnyKernel3` 仓库地址、分支等信息。

内核源码配置(kernelSource)

内核源码相关参数	类型	说明	详细说明
`name`	字符串	内核名称	自定义，会在发布的时候使用此字段
`repo`	字符串	内核源码仓库地址	内核源码的 `git` 仓库地址
`branch`	字符串	内核源码所在分支	对应仓库的指定分支
`device`	字符串	设备代号	所需要编译的设备代号或者名称，会在发布的时候使用此字段
`defconfig`	字符串	内核配置文件名称	对应编译的 `defconfig` 文件前缀，例如 `thyme_defconfig` 就填写 `thyme`

工具链配置(toolchains)

这是一个数组，容纳了许多交叉编译工具链的仓库对象，每一个配置对象的参数说明如下：

工具链相关参数	类型	说明	详细说明
`repo`	字符串	工具链仓库地址	工具链对应的 `git` 仓库地址
`branch`	字符串	工具链所在分支	对应仓库的指定分支
`name`	字符串	工具链名称	克隆到本地的文件夹名称，自定义
`binPath`	数组	工具链二进制文件路径	编译时候会用到的 `bin` 文件所在的路径(相对于克隆后所在文件夹的路径) 在编译的时候会转化为绝对路径进行参数设置

编译参数(params)

编译参数	类型	说明	详细说明
`ARCH`	字符串	架构	设备的架构，可以使用 `uname -m` 查询
`CC`	字符串	C 编译器路径	所使用的编译器，一般为 `clang` 或者 `gcc`
`externalCommand`	对象	外部命令路径	编译所需要的额外的参数设定

对于 externalCommand 部分，下面先给出一个编译时候可能用到的指令例子：

make -j$(nproc --all) \
      O=out \
      ARCH=arm64 \
      CC=clang \
      CLANG_TRIPLE=aarch64-linux-gnu- \
      CROSS_COMPILE=aarch64-linux-gnu- \
      CROSS_COMPILE_ARM32=arm-linux-gnueabi-

其中 -j 和 O=out 这一部分会由编译脚本自动配置好，ARCH 以及 CC 部分对应上面的配置，其他部分则对应 externalCommand 部分，所以对应 toolchains 部分的配置应该为:

"params": {
  "ARCH": "arm64",
  "CC": "clang",
  "externalCommand": {
    "CLANG_TRIPLE": "aarch64-linux-gnu-",
    "CROSS_COMPILE": "proton-clang/bin/aarch64-linux-gnu-",
    "CROSS_COMPILE_ARM32": "proton-clang/bin/arm-linux-gnueabi-"
  }
}

内核刷机包配置(AnyKernel3)

AnyKernel3 参数	类型	说明	详细说明
`use`	布尔值	是否使用 AnyKernel3	如果设置为 `false` 则不打包对应内核刷机包
`release`	布尔值	是否为发布版本	必须 `use` 为 `true` 时才生效，如果设置为 `false` 则不发布对应内核刷机包
`repo`	字符串	AnyKernel3 仓库地址	所使用的 `Anykernel3` 的仓库地址
`branch`	字符串	AnyKernel3 所在分支	对应仓库的指定分支

使用方法

本项目的基础使用方法如下：

在 GitHub 上 fork 本项目
通过 Github 网页或者拉取到本地修改 repos.json 文件，并提交修改
查看 Github 网页的 Action 页面，找到 Build kernels 并 Run workflow
等待编译完成，即可进入对应页面下载编译产物
使用您喜欢的打包软件进行内核打包(AnyKernel3、Android-Image-Kitchen、MagiskBoot 等)

本地构建

如果您并不想在 Github 上重复执行 Action，您可以利用 nektos/act 来在本地环境里测试本构建流程并输出。

普通本地构建(内核源码等使用 `Git` 拉取)

这种方式是推荐的本地测试流程，您只需要安装 nektos/act 并执行如下指令:

# 将构建文件收集到 /tmp/artifacts 文件夹：
act --artifact-server-path /tmp/artifacts

如果您需要放在本地你喜欢的位置，请更改 /tmp/artifacts 为您喜欢的目录即可。

如果中途报错，请加入参数 -v 重新执行获取错误报告并提交 issue ，具体命令如下:

# 将构建文件收集到 /tmp/artifacts 文件夹：
act --artifact-server-path /tmp/artifacts -v

完全本地构建(内核源码等均为本地存储)

用上述方式构建仍然需要内核源码等存储在云端，如果您一定有要全部本地构建的需求，请考虑通过如下方式构建：

搭建本地 Gitea 或 Gitlab 等 Git 服务。随后修改配置文件地址为本地服务地址。
在本地利用 git daemon 指令建立一个二级镜像。

此处仅仅提供思路，并不提供具体教程。

TODO 列表

为第三方编译器添加相对路径支持（现在使用绝对路径）。
使用 ccache 加快编译速度。
通过 wget 添加 .tar.gz 文件作为第三方编译器（现在使用 git 获取工具链）。

致谢

weishu : KernelSU 的开发者
AKR 安卓开发者社区：编译教程提供
DogDayAndroid/KSU_Thyme_BuildBot : 此项目的前身
xiaoleGun/KernelSU_Action ：借鉴部分 Github Action
UtsavBalar1231/Drone-scripts ：借鉴部分 Github Action

贡献者

Star 历史

许可

本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README_cn.md

README_cn.md

构建属于你自己的安卓内核镜像

Github Action

启动方式

构建流程

配置文件解析

基本配置文件案例

参数解析

内核源码配置(kernelSource)

工具链配置(toolchains)

编译参数(params)

内核刷机包配置(AnyKernel3)

使用方法

本地构建

普通本地构建(内核源码等使用 `Git` 拉取)

完全本地构建(内核源码等均为本地存储)

TODO 列表

致谢

贡献者

Star 历史

许可

Files

README_cn.md

Latest commit

History

README_cn.md

File metadata and controls

构建属于你自己的安卓内核镜像

Github Action

启动方式

构建流程

配置文件解析

基本配置文件案例

参数解析

内核源码配置(kernelSource)

工具链配置(toolchains)

编译参数(params)

内核刷机包配置(AnyKernel3)

使用方法

本地构建

普通本地构建(内核源码等使用 Git 拉取)

完全本地构建(内核源码等均为本地存储)

TODO 列表

致谢

贡献者

Star 历史

许可

普通本地构建(内核源码等使用 `Git` 拉取)