4. 开发环境搭建

Qt for MCUs 的开发环境并不是“装一个 IDE 就能跑”的普通桌面开发流程，它由三层组成：宿主端 IDE（Qt Creator）、Qt for MCUs SDK（含 QML 编译器与运行时库）、目标板支持包与交叉工具链。三者版本必须匹配，否则会出现 QML 编译通过但链接失败、或烧录后屏幕无显示的典型问题。本节按“安装—配置—集成—验证”的顺序，把这条链路一次讲清。

一、核心原理：三层环境与一次构建链路

Qt for MCUs 的构建本质是：Qt Creator 调用 SDK 中的 qmlproject 工具，把 QML 与 C++ 代码编译为中间 C++ 代码，再交给目标板工具链（如 GNU Arm Embedded、IAR、Green Hills）编译链接，最终生成可烧录的 .elf/.hex/.bin。因此环境搭建的关键不是“装软件”，而是让 IDE、SDK、工具链、目标板四者的路径与版本互相认识。

二、方法流程：四步完成环境搭建

1. 安装 Qt Creator：从 Qt 官方在线安装器选择 Qt Creator，建议使用与 SDK 文档一致的版本。安装时勾选“Qt for MCUs”相关组件，或后续通过“帮助—关于插件”确认插件已加载。
2. 安装并注册 Qt for MCUs SDK：运行 SDK 安装包，记录安装路径，例如 C:\Qt\QtMCUs\2.8.0。在 Qt Creator 中通过“编辑—Preferences—Devices—Qt for MCUs”添加 SDK 路径，使 IDE 能识别 qmlproject 与平台库。
3. 导入目标板支持包（BSP）：BSP 通常包含板级初始化、显示驱动、触摸驱动与链接脚本。将 BSP 解压到 SDK 的 boards 目录，或在项目 .qmlproject 中通过 board 字段指定板名。
4. 集成交叉工具链：安装 GNU Arm Embedded 或 IAR，把 arm-none-eabi-gcc 所在目录加入系统 PATH，并在 Qt Creator 的 Kit 中设置编译器、调试器与设备。

三、配置示例：qmlproject 与 Kit 参数

一个最小可用的 .qmlproject 需要声明目标板、工具链与源文件。下面示例以 STM32F769I-DISCO 为例：

import QmlProject 1.1

Project {
    mainFile: "main.qml"
    board: "STM32F769I-DISCO"
    toolchain: "GNU Arm Embedded"
    qmlImportPaths: [ "." ]
    files: [
        "main.qml",
        "ui/",
        "assets/"
    ]
}

在 Qt Creator 中，Kit 的配置项应包含：编译器指向 arm-none-eabi-g++，调试器指向 arm-none-eabi-gdb，设备选择对应 OpenOCD 或 J-Link 配置。若使用命令行验证，可执行：

qmlproject --board STM32F769I-DISCO --toolchain gnuarm \
  --build-dir build/ --generate-code main.qmlproject
arm-none-eabi-gcc --version
openocd -f interface/stlink.cfg -f target/stm32f7x.cfg

四、案例与场景：从零到点亮屏幕

假设拿到一块 STM32F769I-DISCO 开发板，目标是运行一个显示“Hello MCUs”的 QML 界面。操作顺序为：安装 Qt Creator → 安装 Qt for MCUs SDK 2.8 → 导入 STM32F769I-DISCO BSP → 安装 GNU Arm 10.3 工具链 → 新建 Qt for MCUs 项目 → 选择该板 Kit → 构建 → 通过 ST-Link 烧录。若屏幕无显示，优先检查 BSP 中的显示驱动是否与板卡 revision 匹配，以及链接脚本是否把帧缓冲放在正确内存区域。

五、误区与复盘