使用meta-qt6构建QML应用的BitBake Recipe报错求助

问题背景 #

使用Yocto Kirkstone版本配合开源meta-qt6层构建简单QML应用，触发CMake错误，确认是CMakeLists.txt配置问题导致编译目标未生成。

通用排查与修复步骤 #

1. 修正CMakeLists.txt的Qt6基础配置 #

确保配置符合Qt6 QML项目的标准要求，示例如下：

cmake_minimum_required(VERSION 3.24.0) # 匹配Kirkstone对应CMake版本

project(your-qml-app VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_INCLUDE_CURRENT_DIR ON)

# 启用Qt自动工具链
set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTORCC ON)
set(CMAKE_AUTOUIC ON)

# 查找Qt6核心模块
find_package(Qt6 REQUIRED COMPONENTS Core Quick)

# 定义编译目标
qt_add_executable(your-qml-app
    main.cpp
    qml.qrc # 若使用资源文件需添加
)

# 配置QML模块属性
set_target_properties(your-qml-app PROPERTIES
    QT_QML_MODULE_VERSION 1.0
    QT_QML_MODULE_URI YourApp
)

qt6_qml_type_registration(your-qml-app)

# 链接Qt6依赖库
target_link_libraries(your-qml-app
    PRIVATE Qt6::Core Qt6::Quick
)

# 指定安装路径（适配Yocto标准）
install(TARGETS your-qml-app
    RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
)

2. 验证Recipe的Qt6依赖配置 #

确保.bb或.bbappend文件正确引入Qt6依赖：

DEPENDS += "qtbase qtdeclarative"
RDEPENDS:${PN} += "qtbase qtdeclarative"

# 继承Qt6构建环境
inherit cmake qt6base

3. 检查项目结构合规性 #

项目需遵循Qt6 QML标准布局：

• 根目录包含：CMakeLists.txt、main.cpp、qml.qrc
• QML文件统一放在qml/目录下
• 资源文件qml.qrc需正确关联QML文件：

<RCC>
    <qresource prefix="/">
        <file>qml/main.qml</file>
    </qresource>
</RCC>

4. 解析CMake报错的关键信息 #

针对不同报错的对应处理：

• 若提示“Qt6 component missing”：检查bblayers.conf中是否正确添加meta-qt6层：

BBLAYERS += "${BSPDIR}/sources/meta-qt6"

• 若提示“target not defined”：确认CMakeLists.txt中qt_add_executable或add_executable语句无语法错误

5. 手动验证CMake配置 #

使用Yocto SDK手动排查配置问题：

source poky/build/tmp/deploy/sdk/environment-setup-*-poky-linux
mkdir build && cd build
cmake .. -DCMAKE_PREFIX_PATH=$OECORE_NATIVE_SYSROOT/usr/lib/cmake/Qt6
make

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