从零构建 Linux|08 配置自定义 Linux

（虚机）QEMU 引导 → linux kernel → rootfs → init → hello（真机）UEFI/BIOS → GRUB → linux kernel         → rootfs → init → services → hello

build-qemux86-64/      → MACHINE = qemux86-64build-genericx86-64/  → MACHINE = genericx86-64

meta/recipes-core/images/core-image-base.bb

SUMMARY = "A console-only image that fully supports the target device hardware."IMAGE_FEATURES += "splash"LICENSE = "MIT"inherit core-image

MACHINE（qemux86-64 / genericx86-64）  → PREFERRED_PROVIDER_virtual/kernel = linux-yocto  → 菜谱 meta/recipes-kernel/linux/linux-yocto_*.bb  → 编出 bzImage（及模块）  → 镜像类 / wic 把内核放进启动分区  → inherit core-image 把用户态包装进 rootfs

bitbake -e virtual/kernel | grep -E '^(PREFERRED_PROVIDER_virtual/kernel|PN|PV)='bitbake -e core-image-base | grep "^IMAGE_INSTALL="

PACKAGE_CLASSES ?= "package_deb"EXTRA_IMAGE_FEATURES += "package-management"

poky/meta-demo/  conf/layer.conf          # create-layer 生成  conf/templates/    qemux86-64/      local.conf.sample      bblayers.conf.sample    genericx86-64/      local.conf.sample      bblayers.conf.sample  recipes-example/hello/    hello_1.0.bb    files/hello.c

# 以下均在 WSL2 Ubuntu 中；假定已按第 7 篇克隆好 pokycd ~/yocto/pokysource oe-init-build-env build-bootstrap# 如果指向bitbake-layers报错，则需要安装下面的依赖sudo apt install chrpath diffstat gawk zstd# 当前目录已是 build-bootstrap/，layer 建在上一级 poky 下bitbake-layers create-layer ../meta-demobitbake-layers add-layer ../meta-demobitbake-layers show-layers

# 仍在 build-bootstrap 环境中grep LAYERSERIES_COMPAT ../meta-demo/conf/layer.conf

LAYERSERIES_COMPAT_meta-demo = "scarthgap"

# 仍建议在已 source 的 build-bootstrap 终端中操作rm -rf ../meta-demo/recipes-example/examplemkdir -p ../meta-demo/recipes-example/hello/filescat > ../meta-demo/recipes-example/hello/files/hello.c << 'EOF'#include <stdio.h>int main(void){    puts("Hello from Yocto-built Linux");return 0;}EOFcat > ../meta-demo/recipes-example/hello/hello_1.0.bb << 'EOF'SUMMARY = "Minimal hello demo"LICENSE = "MIT"LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"SRC_URI = "file://hello.c"S = "${WORKDIR}"do_compile() {${CC}${CFLAGS}${LDFLAGS} \      hello.c -o hello}do_install() {    install -d ${D}${bindir}    install -m 0755 hello \${D}${bindir}/hello}EOF

hello.c 就是标准 C 小程序：打印一行字后退出。菜谱含义：

1. SRC_URI：源码来自同目录 files/hello.c；
2. do_compile：用目标编译器把 hello.c 编成可执行文件 hello；
3. do_install：把结果安装到目标根文件系统的 /usr/bin/hello；
4. 许可证相关行是 Yocto 的常规要求；LIC_FILES_CHKSUM 必须写成同一行的 file://…;md5=…（中间用 ; 连接）。若把 md5= 换到下一行，BitBake 会把它当成另一个非法 URL。

文件名 hello_1.0.bb 里的 1.0 表示版本号；包名是 hello。

可选：立刻确认 BitBake 能看见 hello（仍在 build-bootstrap）：

bitbake -s | grep "^hello"

配置模板：两套 MACHINE 各一份

模板文件名必须以 .sample 结尾。oe-init-build-env 在首次创建 build 目录时，会把模板拷成 conf/local.conf 与 conf/bblayers.conf。

推荐做法：先在 build-bootstrap 里改好一份可用配置，再用 bitbake-layers save-build-conf导出成模板，避免整份手抄。

在 bootstrap 里写好虚机策略

编辑 conf/local.conf（相对当前 build-bootstrap/），找到或追加：

# 虚机：qemux86-64MACHINE ??= "qemux86-64"# 只给本系列镜像追加格式；不要写成全局 IMAGE_FSTYPES:append# （全局追加会渗进 core-image-minimal-initramfs，触发#  「INITRD_IMAGE_LIVE … cannot use … hddimg」解析错误）IMAGE_FSTYPES:pn-core-image-base:append = " \  wic hddimg tar.bz2"# 把 hello 装进镜像（虚机/真机共用）IMAGE_INSTALL:append = " hello"# 两机型共用下载与 sstate：TOPDIR 是当前 build-*/，# 指到 poky 下同一目录，编译 qemux86-64 后再编 genericx86-64# 时，共用模块不必重复下载、也不必从零再编DL_DIR ?= "${TOPDIR}/../downloads"SSTATE_DIR ?= "${TOPDIR}/../sstate-cache"# 中国区可选：用清华镜像加速常见上游下载PREMIRRORS:prepend = "\  git://.*/.* https://mirrors.tuna.tsinghua.edu.cn/git/yocto/ \n \  git://.*/.* https://mirrors.ustc.edu.cn/yocto/ \n \  https?://.*/.* https://mirrors.tuna.tsinghua.edu.cn/yocto/https/ \n \  https?://.*/.* https://mirrors.ustc.edu.cn/yocto/ \n \  ftp://.*/.* https://mirrors.tuna.tsinghua.edu.cn/yocto/ftp/ \n \"# 可选：按 CPU 核数调整（WSL2 勿超过可用内存）# BB_NUMBER_THREADS = "8"# PARALLEL_MAKE = "-j 8"

bblayers.conf 一般不必再手改：前面的 add-layer 已写入 meta-demo。官方默认还会启用 meta、meta-poky、meta-yocto-bsp；qemux86-64 与 genericx86-64 都来自这些基础层，本 demo 不强制引入 meta-intel。

用命令导出两套模板

# 仍在 build-bootstrap 环境中bitbake-layers save-build-conf ../meta-demo qemux86-64# 改成真机 MACHINE 后再导出第二份# （可用编辑器改 conf/local.conf，或：）sed -i 's/^MACHINE ??= "qemux86-64"/MACHINE ??= "genericx86-64"/' conf/local.confbitbake-layers save-build-conf ../meta-demo genericx86-64

生成结果：

meta-demo/conf/templates/qemux86-64/  local.conf.sample  bblayers.conf.samplemeta-demo/conf/templates/genericx86-64/  local.conf.sample  bblayers.conf.sample

save-build-conf 会把本机绝对路径换成 ##OEROOT## 一类占位符，初始化时再还原——这正是模板可提交 Git、可在别人机器复用的关键。

快速核对：

grep 'MACHINE' ../meta-demo/conf/templates/*/local.conf.samplegrep -E 'DL_DIR|SSTATE_DIR' ../meta-demo/conf/templates/*/local.conf.samplegrep 'meta-demo' ../meta-demo/conf/templates/*/bblayers.conf.sample

期望：虚机模板为 qemux86-64，真机为 genericx86-64；两份模板的 DL_DIR / SSTATE_DIR 都指向 ${TOPDIR}/../downloads 与 ${TOPDIR}/../sstate-cache；两份 bblayers 都包含 meta-demo。

IMAGE_FSTYPES 对真机路径很重要：

逐项用白话解释

镜像名字 core-image-base 不必在 local.conf 里强制指定——第 10 篇执行 bitbake core-image-base 时再选定即可。

备选：若你更想手改 sample，也可 mkdir -p 模板目录，再从 meta-poky/conf/templates/default/ 复制 *.sample 后编辑；本系列优先 save-build-conf，少抄文件、少漏 add-layer。

用 TEMPLATECONF 初始化两个正式 build 目录

脚手架完成。下面用模板创建正式双机型目录（与 build-bootstrap 分开）：

cd ~/yocto/poky# 虚机构建目录（首次会从模板生成 conf）TEMPLATECONF=meta-demo/conf/templates/qemux86-64 \source oe-init-build-env build-qemux86-64# 另开终端，或 cd 回 poky 后再初始化真机目录cd ~/yocto/pokyTEMPLATECONF=meta-demo/conf/templates/genericx86-64 \source oe-init-build-env build-genericx86-64

build-bootstrap 完成使命后可删（可选），避免和正式目录搞混：

# 确认不再需要脚手架时再执行# rm -rf ~/yocto/poky/build-bootstrap

要点：

1. TEMPLATECONF 指向模板所在目录（里面有 *.sample），不是某个 sample 文件本身；
2. 路径相对当前 poky 根目录即可；
3. 只有首次创建该 build 目录时才会从模板拷贝；若目录已存在，改模板不会自动覆盖已有 conf/——那时请直接改 build-*/conf/，或删掉空 build 目录后重建（勿误删已有长编译产物，除非你有意为之）；
4. 之后日常进入环境，不必再写 TEMPLATECONF：

cd ~/yocto/pokysource oe-init-build-env build-qemux86-64# 或source oe-init-build-env build-genericx86-64

执行后，终端当前目录通常变成对应的 build-*/。文中说的 conf/local.conf、conf/bblayers.conf 都相对于当前这个 build 目录。

第 9 篇若继续改 local.conf：虚机 / 真机两边都要改时，优先改两份 *.sample 模板（便于 Git），并同步到已有 build-*/conf/local.conf；或只改已初始化的两份 local.conf。

先校验，再开长构建

完整镜像编译很久，所以先用轻量命令确认配置被识别。以虚机目录为例：

cd ~/yocto/pokysource oe-init-build-env build-qemux86-64bitbake -e | grep "^MACHINE="bitbake -s | grep "^hello"

期望：MACHINE="qemux86-64"，且能列出 hello 包。

再校验真机目录：

cd ~/yocto/pokysource oe-init-build-env build-genericx86-64bitbake -e | grep "^MACHINE="bitbake -s | grep "^hello"

期望：MACHINE="genericx86-64"，同样能列出 hello。

如果找不到 hello：

1. 检查对应 bblayers.conf 是否包含 meta-demo；
2. 检查 recipe 文件名、目录是否按上文放置；
3. 重新 source oe-init-build-env build-… 后再试。

如果报 INITRD_IMAGE_LIVE … cannot use … hddimg：

1. 多半是写了全局 IMAGE_FSTYPES:append = " … hddimg …"；
2. 改成 IMAGE_FSTYPES:pn-core-image-base:append = " wic hddimg tar.bz2"（正式 build-*/conf/local.conf 与两份 *.sample 都改）；
3. 再跑 bitbake -s。

可选：只编译 hello 包，进一步验证菜谱本身：

bitbake hello

本篇小结

到本篇结束，你应该已经完成：

1. 弄清默认镜像：内核经 MACHINE + virtual/kernel 进启动分区，不靠在 core-image-base.bb 里点名；apt 默认不在镜像里，要靠 conf 里的 PACKAGE_CLASSES + package-management；
2. 定下定制原则：改 GRUB Logo、psplash、包管理器、时区、语言时，走 conf / meta-demo，不改 poky 原文件；
3. 理解「一 MACHINE 一 build 目录」：build-qemux86-64 与 build-genericx86-64；
4. 用 bitbake-layers create-layer / add-layer 建好 meta-demo，用命令写入 hello；
5. 用 save-build-conf 导出两套 TEMPLATECONF（含共用的 DL_DIR / SSTATE_DIR），再用 TEMPLATECONF=… 分别初始化正式 build；
6. 真机模板保留可写 U 盘 / 铺硬盘的产物格式；
7. 用 bitbake -e / bitbake -s 在两个正式目录里都做了校验。

下一篇按「方案 B」把启动界面、内核版本、Bootloader Logo、时区语言、裁剪与包管理写进 conf / bbappend；配置如何用 Git 托管见第 12 篇。

系列文章列表：