Yocto recipe构建时如何指定.pro文件及解决未打包文件报错
避免非必要文件部署到目标设备的处理方案
你遇到的报错是Yocto构建流程的强制校验触发的,不代表这些非必要文件已经被写入目标设备镜像。本质是do_install阶段将文件拷贝到recipe的临时构建根目录(${D})后,没有任何软件包的FILES变量匹配这些路径,Yocto担心开发者漏配打包规则才抛出提示。针对这类场景,可按以下优先级处理:
- 源头规避:调整
do_install的安装逻辑,从一开始就不要把非必要文件拷贝到${D}目录。比如原来的安装流程默认把测试脚本、示例配置、构建中间产物全拷入临时目录,直接删除对应的安装命令行,只保留需要部署的二进制、动态库、配置文件的安装步骤,从根源减少多余文件。 - 安装后清理:如果部分文件在构建过程中确实需要生成,但不需要部署,直接在
do_install的最后追加清理逻辑,把多余文件从${D}目录删除。示例:do_install_append() { # 删除所有不需要部署的文件,比如测试可执行文件、调试配置、临时文档 rm -f ${D}${bindir}/unit_test rm -rf ${D}${datadir}/example_config rm -f ${D}${sysconfdir}/debug.ini } - 注意不要为了消错随意修改
FILES变量把多余文件塞进主部署包,否则会导致本来不需要的文件被真正打入目标设备镜像,和需求相悖。
指定构建使用的.pro文件的配置方法
因为项目源码内存在多个.pro文件,默认qmake类Yocto recipe会自动扫描源码目录(${S})下的所有.pro文件参与构建,这也是很多多余文件的主要来源。要指定具体使用的.pro,直接使用qmake.bbclass提供的QMAKE_PROFILES变量即可:
- 在你的recipe文件中,为
QMAKE_PROFILES显式赋值需要构建的.pro文件的完整源码路径。这个变量的优先级高于默认的自动扫描逻辑,一旦显式赋值,构建流程就只会使用指定的.pro文件,不会自动匹配目录下其他.pro。示例:
配置完成后,qmake流程会只根据指定的.pro生成Makefile,后续调用qmake自带的install目标时,也只会安装该.pro定义的部署产物,其他.pro对应的构建、安装逻辑完全不会被触发。# 项目源码目录下有 app.pro、unit_test.pro 两个文件,这里只指定部署需要的app.pro QMAKE_PROFILES = "${S}/app.pro" - 配置注意事项:
- 赋值必须使用源码目录下的绝对路径,不要写相对路径,避免qmake找不到目标文件。
- 如果需要联合构建多个.pro文件,用空格分隔多个路径赋值即可,比如
QMAKE_PROFILES = "${S}/core_module.pro ${S}/app_main.pro"。
落地推荐流程
实际操作中建议先通过QMAKE_PROFILES排除不需要构建的.pro文件,从根源上减少非目标文件的生成;再调整do_install逻辑,只拷贝真正需要部署的产物,最后搭配安装后的清理逻辑删除临时目录下的多余文件,既可以彻底避免触发校验报错,也不会把非必要文件打入目标设备镜像。
内容的提问来源于stack exchange,提问作者Kmarconi
相关产品推荐
相关产品推荐

