Qt 非常适合进行嵌入式开发，尤其在 Linux 嵌入式平台（如 ARM 设备）上。以下是 Qt 嵌入式开发的完整流程和关键步骤：

1. 准备工作

• 目标平台确认
  • 确定硬件平台（如 NXP i.MX6/8，树莓派，全志 H 系列等）
  • 确认操作系统（嵌入式 Linux 如 Yocto、Buildroot、Ubuntu Core 等）
• 安装 Qt
  • 下载 Qt 安装程序： https://www.qt.io/download
  • 安装时勾选：
  • Qt 5.15 LTS 或 Qt 6.x
  • Qt Creator（集成开发环境）
  • 目标平台的交叉编译工具链（如 gcc-arm-linux-gnueabihf）

2. 创建交叉编译工具链

核心概念：构建 SDK

需为目标设备生成定制化的 Qt 工具链（包含编译器 + Qt 库）。

# 示例：构建适用于 ARM 的 Qt（使用 Yocto）
$ source poky/oe-init-build-env   # 进入 Yocto 环境
$ bitbake qtbase                 # 编译 Qt 基础库
$ bitbake meta-toolchain-qt5     # 生成 SDK 安装包
$ ./tmp/deploy/sdk/poky-glibc-x86_64-meta-toolchain-qt5-cortexa72.sh  # 安装 SDK

关键配置选项

./configure -platform linux-g++ -xplatform linux-arm-gnueabi-g++ \
-prefix /opt/qt-embedded \
-opensource -confirm-license \
-no-opengl -no-gui -no-widgets \  # 按需裁剪模块
-qt-zlib -qt-libjpeg -no-sql-sqlite

3. Qt Creator 配置

1. 打开 Qt Creator → 工具 → 选项
2. 添加编译器
   • 路径： /opt/sdk/gcc-arm-linux-gnueabihf/bin/arm-linux-gnueabihf-g++
3. 添加 Qt 版本
   • 指定交叉编译的 qmake： /opt/qt-embedded/bin/qmake
4. 创建设备套件 (Kit)
   • 组合：编译器 + Qt 版本 + 目标设备（通过 SSH 或物理连接）

4. 开发应用程序

嵌入式图形方案选择

关键代码配置

// main.cpp
#include <QGuiApplication>
#include <QQuickView>

int main(int argc, char *argv[]) {
    qputenv("QT_QPA_PLATFORM", "eglfs");       // 指定图形后端
    qputenv("QT_QPA_EGLFS_FORCE888", "1");     // 强制 32 位色深

    QGuiApplication app(argc, argv);
    QQuickView view;
    view.setSource(QUrl("qrc:/main.qml"));
    view.setResizeMode(QQuickView::SizeRootObjectToView);
    view.showFullScreen();  // 全屏模式
    return app.exec();
}

5. 部署到设备

方式一：通过 Qt Creator

• 在 Kit 中配置目标设备的 IP 地址和 SSH 登录信息
• 点击 ▶ 按钮自动交叉编译 → 推送可执行文件 → 在设备上运行

方式二：手动部署

# 在开发机上交叉编译
$ qmake && make -j4

# 复制文件到设备
$ scp myapp root@192.168.1.100:/opt

# 在设备上执行
$ export QT_QPA_PLATFORM=eglfs  # 设置环境变量
$ export QT_QPA_EVDEV_TOUCHSCREEN_PARAMETERS=/dev/input/event0
$ /opt/myapp

6. 优化技巧

1. 裁剪 Qt 模块
   • 移除不需要的模块（如 -no-sql-mysql -no-dbus）
   • 最小化编译：Configure Options Reference
2. 资源优化
   • 使用 rcc 编译资源到二进制
   • 压缩 QML/图像资源
3. 启动优化
   • 静态链接编译：-static
   • 使用 Precomiled Headers

7. 调试技巧

• 远程调试
  • 在 Qt Creator 中直接调试设备上的进程（需安装 gdbserver）
• 日志输出

  $ export QT_LOGGING_RULES=*.debug=true
  $ ./myapp >> /var/log/qt.log

• 帧率监控

  // 在 QML 中添加
  FpsItem { anchors.top: parent.top }

常见问题解决

• 触摸屏无响应
  检查 /dev/input/eventX 设备权限，设置环境变量：

  export QT_QPA_GENERIC_PLUGINS=evdevtouch:/dev/input/event0

• 黑屏/花屏
  • 确认 GPU 驱动已加载（lsmod | grep dw_mipi_dsi）
  • 尝试更换平台插件：linuxfb 或 vnc
• 字体缺失
  • 复制字体到设备：cp /usr/share/fonts/truetype/* /opt/fonts
  • 设置路径：export QT_QPA_FONTDIR=/opt/fonts

参考资源

1. Qt 官方嵌入式文档
2. Yocto 集成 Qt 指南
3. Qt for Device Creation

? 提示：对于树莓派等流行设备，可直接使用预编译的 Qt 镜像，如 Qt Raspberry Pi Image 或 Boot2Qt。