Yocto构建rootfs时bitbake无法找到自定义Qt应用qtsimplecalc

核心排查方向与解决方案 #

1. 先单独验证应用包能否构建

跳过镜像构建，直接单独编译qtsimplecalc包，确认包本身能正常生成：

bitbake qtsimplecalc -c cleanall && bitbake qtsimplecalc

如果这一步报错，优先解决编译阶段的问题；若能成功生成包，再排查镜像集成环节。

2. 修正配方（qtsimplecalc.bb）的关键配置

• 移除ALLOW_EMPTY_${PN}：该配置会将包标记为空包，bitbake会判定它无任何可安装内容，完全不符合应用包需求，必须删除。
• 确保FILES_${PN}指向正确路径：明确指定应用可执行文件的安装位置，比如应用编译后安装到/usr/bin时，配置应为：

  FILES_${PN} = "${bindir}/qtsimplecalc"
  

  替换qtsimplecalc为实际生成的可执行文件名，确保与代码中的目标文件名一致。
• 完善Qt相关继承与依赖：确保配方继承了正确的Qt构建类，并声明依赖模块：

  DEPENDS = "qtbase qtdeclarative" # 根据应用实际用到的Qt模块调整
  inherit qt5-cmake # 若用qmake则替换为inherit qt5-qmake
  

• 检查源码拉取配置：如果使用GitHub源码，确保SRC_URI和SRCREV配置正确，示例：

  SRC_URI = "git://github.com/your-repo/qtsimplecalc.git;branch=main"
  SRCREV = "your-commit-hash-or-HEAD"
  S = "${WORKDIR}/git"
  

  无需手动克隆源码，配方会自动完成拉取操作。

3. 确认Layer配置（layer.conf）正确

确保bitbake能定位到你的配方：

• 添加配方路径到BBFILES：

  BBFILES += "${LAYERDIR}/recipes-qt/qtsimplecalc/*.bb"
  

• 确认层的收集与优先级配置：

  BBFILE_COLLECTIONS += "meta-your-layer"
  BBFILE_PATTERN_meta-your-layer = "^${LAYERDIR}/"
  BBFILE_PRIORITY_meta-your-layer = "6" # 优先级高于基础层即可
  

4. 镜像集成的最终验证

当应用包能单独构建成功后，在IMAGE_INSTALL中添加qtsimplecalc，重新构建镜像：

bitbake your-image-name -c cleanall && bitbake your-image-name

示例正确配方 #

SUMMARY = "Simple Qt Calculator"
DESCRIPTION = "Custom embedded Qt calculator application"
HOMEPAGE = "https://github.com/your-repo/qtsimplecalc"
LICENSE = "MIT"
LIC_FILES_CHKSUM = "file://LICENSE;md5=abcdef1234567890"

SRC_URI = "git://github.com/your-repo/qtsimplecalc.git;branch=main"
SRCREV = "a1b2c3d4e5f6g7h8i9j0"

S = "${WORKDIR}/git"

DEPENDS = "qtbase"
inherit qt5-cmake

FILES_${PN} = "${bindir}/qtsimplecalc"

内容的提问来源于stack exchange，提问作者Raj