📚 课程目录第1章 QtMCU 开发环境搭建与第一个 QtQuick 界面

1. QtMCU 开发环境搭建与第一个 QtQuick 界面

任务目标

本案例将完成一个可在Qt for MCU环境中运行的Qt Quick应用，在模拟器或开发板上显示文本Hello Qt for MCU。通过本案例，你将掌握Qt for MCU项目的最小结构、构建流程以及如何在目标设备上验证运行结果。

环境准备

开始前请确认以下工具链已安装：

Qt for MCU SDK 2.x（包含QML运行时与编译器）
目标板BSP（如STM32F769 Discovery、NXP i.MX RT1050等）或使用桌面模拟器
CMake 3.16+ 与对应编译器（如ARM GCC或桌面GCC）

安装完成后，将SDK中的qtmcuxx工具加入系统PATH，并确认qtmcuxx --version可正常输出版本信息。

项目结构

创建以下三个文件，构成最小可构建项目：

HelloMCU/
├── CMakeLists.txt
├── qmldir
└── Main.qml

完整实现代码

CMakeLists.txt — 项目构建配置：

cmake_minimum_required(VERSION 3.16)
project(HelloMCU LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

find_package(Qt6 COMPONENTS Quick REQUIRED)
qt_add_executable(HelloMCU
    Main.qml
)

target_link_libraries(HelloMCU PRIVATE Qt6::Quick)

# Qt for MCU 部署配置
qt_generate_qmldir(HelloMCU)
qt_deploy_qml_runtime(HelloMCU)

qmldir — QML模块声明：

module HelloMCU
Main.qml

Main.qml — 应用主界面：

import QtQuick 2.15
import QtQuick.Controls 2.15

ApplicationWindow {
    visible: true
    width: 320
    height: 240
    title: "Hello Qt for MCU"

    Text {
        anchors.centerIn: parent
        text: "Hello Qt for MCU"
        font.pixelSize: 24
        color: "#2E8B57"
    }
}

构建与运行

在项目根目录执行以下命令完成构建（以桌面模拟器为例）：

mkdir build && cd build
cmake .. -DCMAKE_PREFIX_PATH=/path/to/qt-mcu-sdk
cmake --build . --target HelloMCU

构建成功后，运行生成的可执行文件（桌面模拟器）或烧录至开发板：

./HelloMCU    # 桌面模拟器运行

验证方法

通过以下标准判断案例是否成功：

编译通过：CMake配置与编译过程无错误，生成HelloMCU可执行文件或固件镜像。
界面显示：运行后窗口（或开发板屏幕）中央显示绿色文本Hello Qt for MCU，字体清晰可读。
无崩溃退出：程序持续运行，关闭窗口或断电前无异常退出或卡死。

若在开发板上运行，需根据具体BSP调整CMake中的工具链文件路径，并确认屏幕驱动已正确初始化。

常见问题

编译报错找不到Qt6：检查CMAKE_PREFIX_PATH是否指向Qt for MCU SDK的安装目录。
模拟器运行黑屏：确认显卡驱动支持OpenGL ES 2.0，或改用-software参数强制软件渲染。
开发板无显示：验证BSP的显示控制器初始化代码已正确执行，且屏幕接口与项目配置一致。