📖 Fork 与自定义编译指南

手把手教你使用 GitHub Actions 构建自定义 GKI 内核

0
使用前说明 Before You Start
ℹ️

要使用 GitHub Actions,你必须在你自己的仓库中操作——也就是你自己的仓库或你 Fork 后的仓库。请先确认左上角显示的是你的用户名,否则你可能无法运行工作流。

本页只说明两件事:如何 Fork 本仓库,以及如何使用 GitHub Actions 工作流进行构建

1
Fork 仓库 Fork the Repository
  1. 登录 GitHub
  2. 打开上游仓库:zzh20188/GKI_KernelSU_SUSFS
  3. 点击右上角的 Fork 按钮,按提示创建你自己的副本。
  4. Fork 完成后,从左上角侧边栏可随时找到你的 Fork 仓库。
点击 Fork
截图 1:点击右上角的 Fork 按钮
确认 Fork
截图 2:确认 Fork 目标和创建设置
Fork 完成
截图 3:Fork 完成后进入你自己的仓库页面
侧边栏
截图 4:从侧边栏快速找到你的 Fork
2
启用 GitHub Actions Enable GitHub Actions
  1. 进入你 Fork 后的仓库。
  2. 点击顶部的 Actions 标签页。
  3. 如果 GitHub 提示启用工作流,按页面提示完成启用即可。
Actions 页面
截图 5:进入 Actions 页面
启用工作流
截图 6:按提示启用工作流
3
选择并运行工作流 Choose and Run a Workflow
  1. 在 Actions 页面中,选择 构建内核 - 自定义版本
  2. 界面中的 4 个参数决定了你要构建的 GKI 内核版本。
  3. 这些参数可以从 版本查询页面 获取——打开对应版本卡片查看详情。
  4. 将网站上的参数填入工作流输入框,点击 Run workflow 即可开始构建。
💡

简单来说:版本页面告诉你该填什么,工作流按这些参数自动构建。

选择工作流
截图 7:选择「构建内核 - 自定义版本」工作流
查找版本
截图 8:在版本页面找到目标版本
查看参数
截图 9:查看版本详情并确认参数
填写参数
截图 10:将参数填入工作流并运行
运行工作流
截图 11:点击 Run workflow 运行工作流
4
下载构建产物 Download the Artifacts

构建完成后,进入该次工作流运行的详情页面,在页面底部的 Artifacts 区域即可下载产物。

下载产物
截图 12:在运行详情页底部下载 Artifacts
5
同步上游更新 Sync Fork with Upstream

上游仓库有更新时,你可以在 Fork 仓库页面点击 Sync fork 按钮同步最新代码,防止进度落后导致构建失败。

⚠️

注意:千万别点旁边的 Compare 按钮,那不是同步功能。

同步 Fork
截图 13:点击 Sync fork 同步上游更新