1. 课程导入
欢迎进入《Qt嵌入式部署与量产工程》课程。很多开发者已经能够在桌面环境用 Qt 写出漂亮的界面，也能在开发板上跑通一个“Hello World”程序，但一旦进入真实产品阶段，问题就会集中爆发：交叉编译工具链版本不匹配、Qt 库裁剪后缺少插件、触摸屏坐标错乱、程序开机启动失败、固件升级后界面黑屏、批量生产时每台设备表现不一致。本课程要解决的，正是从“能跑”到“可部署、可量产、可维护”之间的工程鸿沟。
一、核心概念：部署与量产到底在做什么
Qt 嵌入式部署，本质上是把在宿主机上开发出的 Qt 应用程序，经过交叉编译、依赖收集、环境配置和系统集成，最终稳定运行在目标硬件平台上的过程。它涉及四个关键对象：宿主机（开发 PC）、目标板（ARM 或其他架构设备）、工具链（编译器、链接器、sysroot）和运行环境（Qt 库、插件、字体、显示与输入驱动）。
量产工程则更进一步，关注的是“一致性”和“可重复性”。单台设备能跑不代表一千台都能跑；手动配置成功不代表产线工人能复制。量产要求固件可版本化、烧录可自动化、参数可校准、故障可追溯。因此，部署解决“能不能运行”，量产解决“能不能稳定地批量运行”。
- 交叉编译：在 x86 宿主机上生成 ARM 目标代码，必须保证头文件、库和链接器来自同一 sysroot。
- Qt 运行库：包括 QtCore、QtGui、QtWidgets、QtQml 等，裁剪不当会导致运行时缺库或插件加载失败。
- 平台插件：如 eglfs、linuxfb、xcb，决定 Qt 如何与显示系统对接，是嵌入式部署的高频故障点。
- 系统集成：包括开机自启、看门狗、日志、分区挂载、权限与安全策略。
- 量产烧录：通过 SD 卡、USB、网络或专用治具批量写入固件，并校验版本与校验和。
二、整体知识框架：从开发到产线的五层结构
为了便于理解，我们把课程内容组织为五层结构。下层是上层的基础，上层是下层的交付目标。下图展示了从宿主机开发环境到量产产线的完整关系，其中工具链和 Qt 运行库是贯穿始终的支撑层。
三、实战路线图：按阶段推进的学习路径
本课程共 30 章，建议按以下四个阶段推进。每个阶段都有明确的交付物，避免“学完就忘”。
| 阶段 | 核心任务 | 关键交付物 | 常见风险 |
|---|---|---|---|
| 阶段一：环境与编译 | 搭建交叉编译工具链，配置 sysroot，完成 Qt 库裁剪与编译 | 可用的工具链、Qt 运行库、qmake/CMake 配置 | 工具链与库版本不一致，导致链接失败 |
| 阶段二：部署与运行 | 将程序与依赖部署到目标板，配置平台插件、字体、输入设备 | 目标板可稳定启动的 Qt 应用 | eglfs/linuxfb 配置错误，触摸坐标偏移 |
| 阶段三：系统集成与优化 | 开机自启、看门狗、日志、启动时间与内存优化 | 可长期运行的集成固件 | 启动脚本权限不足，日志占满分区 |
| 阶段四：量产与维护 | 固件打包、版本管理、批量烧录、产线校准与追溯 | 可复制的量产流程与固件包 | 烧录工具不稳定，版本混淆导致返修困难 |
四、典型场景与误区复盘
先看一个真实场景：某团队在开发板上手动运行 Qt 程序一切正常，但做成开机自启后黑屏。排查发现，手动运行时 shell 已加载了 QT_QPA_PLATFORM=eglfs 等环境变量，而自启脚本没有继承这些变量，导致 Qt 找不到平台插件。这类问题在部署阶段非常典型。
# 手动运行（正常）
export QT_QPA_PLATFORM=eglfs
export QT_QPA_EGLFS_INTEGRATION=eglfs_kms
./myapp
# 开机自启脚本（黑屏）
#!/bin/sh
/opt/myapp/myapp &
# 缺少环境变量，Qt 无法加载平台插件本课程后续将围绕这条路线图逐层展开：先解决交叉编译与 Qt 库构建，再进入目标板部署与显示输入适配，然后做系统集成与性能优化，最后落到固件打包、批量烧录与产线追溯。每一章都会给出可操作的命令、配置和检查点，帮助你把知识转化为可交付的工程能力。