仓库基本介绍

仓库基本介绍

注：本页面中$配置名为变量

1.仓库基本结构

config  --- 存储openwrt编译配置与OpenWrt-k额外的配置
files   --- openwrt固件自定义文件
scripts --- 编译时所用的部分脚本
config_build_tool.sh --- OpenWrt-k配置构建工具

2.编译流程

1. planning：根据config/OpenWrt.config定义不同作业配置的矩阵
2. prepare：准备编译移植包所需的源码与一些参数
3. build1: 根据配置打内核补丁、修改部分源码、根据配置添加openclash内核与AdGuardHome核心并编译工具链
4. build-package：编译固件所需的软件包
5. build-Image_Builder：编译Image_Builder与所有kmod（除sfe）
6. 使用4编译的Image Builderkmod添加3编译软件包（除kmod）与4编译的kmod（除sfe）构建镜像

• 注：3与4同时进行，拆成5个job是因为github限制一个job只能运行6小时软件包多点就超时了，除planning外job名后还跟着-$配置名

3 关于此仓库的配置

本仓库的 config/$配置名 文件夹中的*.config文件为配置差异文件制作而来，它好处是这些文件可以在下游项目中进行版本控制。它也较少受到上游更新的影响，因为它只包含更改（见openwrt官网使用配置文件差异文件进行配置）， 编译时 config/$配置名 文件夹中的*.config文件回被合并拓展为完整的config文件（拓展过程中会添加默认软件包与配置，也会添加软件包依赖）

• config 文件夹中不同.config的作用

  default-extpackages.config --- 供OpenWrt-k配置构建工具下载默认拓展软件包配置使用
  OpenWrt.config             --- 目前仅用于定义工作流要编译的配置
  

• config/$配置名 文件夹中不同.config的作用

  image.config      --- 存储镜像的分区大小生成镜像的类型系统启动等待时间等配置（对应Menuconfig中的Target Images）
  target.config     --- 存储编译固件的架构设备等（对应Menuconfig中的Target System、Subtarget、Target Profile、Target Devices）
  kmod.config       --- 存储内核模块（驱动）配置（对应Menuconfig中的Kernel modules）
  luci.config       --- 存储LuCI APP配置（对应Menuconfig中的LuCI）
  network.config    --- 存储网络相关软件包配置（对应Menuconfig中的Network）
  utilities.config  --- 存储工具类软件包配置（对应Menuconfig中的Utilities）
  other.config      --- openwrt剩余的所有配置
  OpenWrt-K/extpackages.config --- 存放拓展软件包配置
  OpenWrt-K/openwrtext.config --- 存放openwrt拓展配置，如：IP、时区等
  OpenWrt-K/compile.config --- 用于定义openwrt编译所用的分支或tag（仅官方源）与配置kmod编译排除列表
  

• 关于kmod编译排除列表: 此列表仅会在添加所有kmod为模块(=m)时进行排除,如果你配置某kmod为模块/编译进固件(=m/y)或被其他软件包(包括没被排除的kmod)依赖则会警告或报错(不会停止工作流)。所以此列表仅应该添加kmod，例如dahdi-linux编译报错你应该将依赖它的软件包kmod-dahdi添加进kmod编译排除列表而不是添加不属于kmod的dahdi-linux。

  注：内核模块(kmod)编译排除列表在仓库根目录的config/$配置名/OpenWrt-K/compile.config中，不同内核模块(kmod)名之间用,(英文逗号)分隔，支持通字符.*。