meta-starryos 使用说明

层添加

• 在 conf/bblayers.conf 的 BBLAYERS 中加入本层路径，例如：
• BBLAYERS += "/home/yean/yocto-starryos/meta-starryos"

机器选择

• aarch64：starryos-crosvm-aarch64、starryos-qemu-aarch64
• x86_64：starryos-crosvm-x86_64、starryos-qemu-x86_64
• riscv64：starryos-crosvm-riscv64、starryos-qemu-riscv64

构建示例

• export MACHINE=starryos-crosvm-aarch64
• bitbake starryos-minimal-image

先决条件检查

• bash meta-starryos/scripts/check-env.sh，确保已安装 bitbake dtc qemu-system-aarch64 crosvm cargo，并存在 /opt/toolchain-musl-aarch64/bin/aarch64-linux-musl-gcc
• 在 build/conf/bblayers.conf 启用：
  • /home/yean/yocto-starryos/meta-openembedded/meta-oe
  • /home/yean/yocto-starryos/meta-starryos

常见问题

• quilt-native incompatible：未启用 meta-openembedded/meta-oe 或机器 tune 引用错误（aarch64 使用 conf/machine/include/arm/armv8a/tune-cortexa57.inc）。
• gnutls_handshake() failed：宿主网络/TLS代理异常，确认 git 可访问 GitHub；或设置正确的代理/证书。
• starryos-rsa-sign-app not found：若需构建 starryos-secure-image，请在 recipes-apps/starryos-secure-app/ 下补充该二进制及 LICENSE。

批量构建（矩阵）

• 执行：bash meta-starryos/scripts/build-matrix.sh
• 将依次构建如下组合：
• 机器：starryos-{crosvm,qemu}-{aarch64,x86_64,riscv64}
• 镜像：starryos-{minimal,secure,release,test}-image

使用 kas 并行构建

• 安装：pip install kas
• 运行：kas build meta-starryos/kas/kas-matrix.yml
• 说明：自动根据 kas-matrix.yml 的机器与镜像列表运行并行构建，适合在 CI 环境批量产出。

运行示例

• 赋予脚本执行权限：
• chmod +x meta-starryos/scripts/run-crosvm.sh meta-starryos/scripts/run-qemu.sh
• crosvm：
• bash meta-starryos/scripts/run-crosvm.sh
• qemu：
• bash meta-starryos/scripts/run-qemu.sh

重要说明

• 平台/架构参数：在 recipes-kernel/starryos/starryos_1.0.bb 中使用 STARRYOS_PLATFORM 与 STARRYOS_ARCH 控制目标与设备树。
• 若上游未提供 ${STARRYOS_PLATFORM} 目标，配方将回退到 crosvm 并给出警告。
• 设备树按 ${PLATFORM}-${ARCH} 命名并安装到 /boot，脚本会自动从 tmp/deploy/images/${MACHINE} 查找。