如何在Yocto构建的镜像中添加Qt StateMachine库？

AI 小北

2026-6-25

解决Yocto Kirkstone + meta-qt6 6.7.0中Qt StateMachine库缺失的问题

直接在镜像中添加对应包
Qt StateMachine在meta-qt6中是独立的模块包，你只需要在构建配置里把它加入镜像安装列表即可：
在你的local.conf或者自定义镜像recipe中添加：
```
IMAGE_INSTALL:append = " qt6statemachine"
```
如果需要开发用的头文件和静态库，再追加开发包：
```
IMAGE_INSTALL:append = " qt6statemachine qt6statemachine-dev"
```
要是需要示例程序，再加qt6statemachine-examples即可。
确认meta-qt6中是否存在该模块的Recipe
检查你的meta-qt6源码路径下的recipes-qt/qt6目录，是否有qt6statemachine_6.7.0.bb（或对应版本的bb文件）。如果没有，说明你用的meta-qt6分支没包含这个模块，需要切换到对应Qt 6.7.0的meta-qt6分支（比如6.7分支）。
检查模块编译开关
虽然你提到PACKAGECONFIG里没找到状态机相关配置，但可以打开qt6statemachine.bb文件确认是否有编译控制选项。如果存在默认关闭的配置，在local.conf中开启即可，比如：
```
PACKAGECONFIG:pn-qt6statemachine = "all"
```
不过绝大多数情况下，Qt StateMachine模块默认是开启编译的，不需要额外配置。
版本兼容性注意
注意Poky Kirkstone的官方默认Qt版本是6.4.x，你使用meta-qt6 6.7.0属于跨版本搭配，可能存在部分模块适配问题。如果遇到编译错误，可以尝试使用与Kirkstone兼容的meta-qt6分支（比如kirkstone分支对应的Qt 6.4版本），或者确保meta-qt6的依赖都正确适配了Kirkstone的构建环境。