📚 课程目录第1章课程导入

1. 课程导入

在嵌入式设备上，用户与机器的交互体验往往决定了产品的第一印象。从工业控制面板、医疗监护仪，到智能家居中控屏、车载仪表，这些设备都需要在有限的处理器性能、内存和功耗预算下，呈现出流畅、稳定、可维护的人机界面。Qt Quick 正是为这类场景而生的一套声明式 UI 技术栈，它把界面描述、动画、状态管理和 C++ 业务逻辑有机地结合在一起，成为嵌入式 HMI 开发的主流选择之一。

本课程的目标不是让你记住零散的 API，而是建立一条从“界面描述”到“设备落地”的完整工程链路。学完本课程，你应当能够独立完成一个嵌入式 HMI 项目的架构设计、界面开发、性能调优与交叉编译部署。

一、学习目标：从会写到会交付

本课程围绕四个层次的能力展开，建议你在学习过程中不断对照检查自己的掌握程度：

语言与描述层：熟练使用 QML 语法、属性绑定、信号与槽、组件化封装，理解声明式 UI 与命令式逻辑的边界。
架构与集成层：掌握 QML 与 C++ 的交互方式，包括上下文属性、Q_PROPERTY、Q_INVOKABLE、模型视图以及注册自定义类型。
性能与体验层：理解 Qt Quick 的渲染机制，能够定位掉帧、内存增长、启动缓慢等问题，并给出可落地的优化方案。
工程与部署层：能够配置交叉编译工具链、裁剪 Qt 模块、打包运行时依赖，并针对目标板进行调试与验证。

学习建议：每学完一个模块，都在真实或模拟的嵌入式目标上跑一遍。Qt Quick 的很多问题只在目标设备上才会暴露，桌面端运行正常不代表设备端可用。

二、核心概念：理解 Qt Quick 的“三层结构”

Qt Quick 并不是单一技术，而是由多个协作层组成的体系。理解下面这张结构关系图，是后续所有章节的基础。

三层之间通过属性绑定和信号槽双向通信：QML 层声明“界面应该是什么样”，运行时层负责高效地把这种描述变成屏幕上的像素，而 C++ 层提供真实的数据与硬件能力。任何一层的设计失误，都会在另外两层表现为卡顿、闪烁或逻辑错乱。

三、整体知识框架：一条主线，四个阶段

本课程共 30 章，内容按工程推进顺序组织，可以概括为下表所示的四个阶段。建议你把它当作学习地图，随时定位自己所在的位置。

阶段	核心内容	关键产出
基础入门	QML 语法、Item 体系、布局、属性绑定、信号与槽	可运行的静态界面与简单交互
组件与架构	自定义组件、模型视图、状态与动画、C++ 集成	可复用的组件库与数据驱动界面
性能与体验	场景图原理、渲染优化、内存管理、启动加速	流畅稳定的目标设备界面
工程与部署	交叉编译、模块裁剪、依赖打包、目标板调试	可交付的嵌入式 HMI 固件

四、典型应用场景与常见误区

Qt Quick 在嵌入式领域的典型场景包括：工业 HMI 触摸屏、医疗设备操作界面、车载中控与仪表、智能家居面板、手持终端等。这些场景的共同点是：界面需要动画与状态反馈、硬件资源受限、产品生命周期长、需要持续维护。

初学者最容易陷入的误区，是把桌面端 Qt Quick 的开发习惯直接搬到嵌入式设备上。下面这些坑在真实项目中非常常见：

过度依赖 QML 动态创建：大量使用 Loader 和动态对象，导致启动慢、内存碎片化。
在 QML 中写复杂逻辑：把业务计算放进 JavaScript 表达式，既难调试又影响绑定性能。
忽视渲染线程：在 UI 线程做耗时操作，造成界面卡死或掉帧。
不做模块裁剪：把整个 Qt 打包进设备，镜像体积远超预期。

排障提示：当目标设备出现界面卡顿但 CPU 占用不高时，优先检查是否触发了软件渲染回退，以及场景图是否因频繁创建销毁节点而反复重建。

下面是一段最小的 QML 示例，它展示了声明式界面与 C++ 数据绑定的基本形态。后续章节会逐步展开其中的每一个细节。

import QtQuick 2.15
import QtQuick.Controls 2.15

ApplicationWindow {
    visible: true
    width: 480
    height: 272
    title: "嵌入式 HMI"

    Column {
        anchors.centerIn: parent
        spacing: 12

        Text {
            text: "设备温度：" + device.temperature + " ℃"
            font.pixelSize: 20
        }

        Button {
            text: "刷新"
            onClicked: device.refresh()
        }
    }
}

在这段代码中，device 是从 C++ 注册到 QML 上下文的对象，temperature 是它的一个可绑定属性。当 C++ 侧发出属性变更通知时，界面会自动更新，无需手动刷新。这正是 Qt Quick 声明式编程的核心价值：描述关系，而不是描述步骤。