2. 开发环境搭建
Qt 与 OpenGL ES 的集成开发，本质上是一条“桌面编写 → 交叉编译 → 目标板运行 → 远程调试”的链路。环境搭建是否规范，直接决定后续渲染代码能否顺利跑通。本节围绕四个关键环节展开：Qt 安装与配置、OpenGL ES 开发库准备、交叉编译工具链部署、模拟器与真机调试环境准备。
一、核心原理：为什么环境要分层搭建
Qt 在桌面端通常使用 OpenGL 或软件光栅后端，而嵌入式目标板多使用 OpenGL ES（GLES）。两者 API 子集不同，头文件、库名、EGL 上下文创建方式也不同。因此开发环境必须区分“宿主机构建环境”和“目标机运行环境”：
- 宿主机构建环境：安装 Qt、编译器、CMake/qmake，用于编写和本地验证逻辑。
- 交叉编译环境：使用目标架构工具链，把 Qt 库和应用编译成目标板可执行文件。
- 目标机运行环境：提供 libGLESv2、libEGL、GPU 驱动和 Qt 运行库。
- 调试环境：通过 ADB、SSH、GDB 或 Qt Creator 远程部署与断点调试。
只有这四层对齐，才能避免“桌面能跑、板子黑屏”的典型问题。
二、Qt 安装与配置要点
推荐使用 Qt 官方在线安装器，选择与目标板 Qt 版本一致的组件。若目标板使用 Qt 5.15，则宿主机也安装 Qt 5.15，避免版本差异导致 ABI 不兼容。安装时至少勾选：
- Qt 对应版本（如 Qt 5.15.2）的 Desktop 与 Sources 组件；
- Qt Creator；
- CMake 与 Ninja（若使用 CMake 构建）；
- 对应交叉编译工具链的 Qt 版本（若官方提供）。
安装完成后，在 Qt Creator 中配置 Kit：编译器、Qt 版本、调试器、CMake 工具四项必须齐全。交叉编译 Kit 还需指定 sysroot 与目标设备。一个常见的 qmake 配置片段如下：
# 交叉编译 qmake 配置示例
./configure -prefix /opt/qt5.15-arm64 \
-opensource -confirm-license \
-xplatform linux-aarch64-gnu-g++ \
-sysroot /opt/sysroot-aarch64 \
-opengl es2 \
-no-xcb -no-openssl \
-nomake examples -nomake tests-opengl es2 表示 Qt 使用 OpenGL ES 2.0 后端，这是嵌入式板卡最常用的配置。若目标板支持 GLES 3.x，可改为 -opengl es2 并运行时请求 3.x 上下文。三、OpenGL ES 开发库准备
OpenGL ES 开发库分为“头文件”和“运行库”两部分。头文件通常来自 Khronos 官方或目标板 SDK，运行库由 GPU 厂商提供。典型文件包括：
| 文件/库 | 作用 | 常见路径 |
|---|---|---|
| GLES2/gl2.h | OpenGL ES 2.0 函数声明 | /usr/include/GLES2 |
| EGL/egl.h | EGL 上下文与表面管理 | /usr/include/EGL |
| libGLESv2.so | GLES 渲染函数实现 | /usr/lib/aarch64-linux-gnu |
| libEGL.so | EGL 接口实现 | /usr/lib/aarch64-linux-gnu |
| libmali.so / libGLESv2.so | GPU 厂商驱动（如 Mali、Adreno） | 目标板 /usr/lib |
在 Qt 工程中，通过 QT += opengl 或 CMake 的 find_package(Qt5 COMPONENTS OpenGL REQUIRED) 引入。若直接调用 GLES API，还需在 .pro 中链接：
LIBS += -lGLESv2 -lEGL
INCLUDEPATH += /opt/sysroot-aarch64/usr/include四、交叉编译工具链部署
交叉编译工具链是环境搭建中最容易出错的环节。核心是“三对齐”：架构对齐、sysroot 对齐、Qt 版本对齐。以 aarch64 为例，安装工具链后验证：
aarch64-linux-gnu-gcc -v
# 输出 target: aarch64-linux-gnu
# 确认 sysroot 路径与目标板根文件系统一致随后在 Qt Creator 中新建 Kit，指定编译器为 aarch64-linux-gnu-g++，Qt 版本为交叉编译出的 qmake，sysroot 指向目标板根文件系统。构建时 Qt Creator 会自动把应用编译为目标架构。
五、模拟器与真机调试环境准备
模拟器适合早期验证 UI 与逻辑，但 OpenGL ES 渲染行为与真机差异较大，最终必须上真机。常见调试方式：
- ADB 部署：Android 目标板通过
adb push推送可执行文件与 Qt 库。 - SSH 部署：Linux 目标板通过
scp传输，ssh远程执行。 - GDB 远程调试：目标板运行
gdbserver :1234 ./app，宿主机用aarch64-linux-gnu-gdb连接。 - Qt Creator 远程设备：配置设备 IP、用户名、密码，一键部署与调试。
# 真机调试典型命令
scp ./myapp root@192.168.1.100:/opt/app/
ssh root@192.168.1.100 "export QT_QPA_PLATFORM=eglfs; /opt/app/myapp"
# 若报 GL 错误，检查：
# echo $QT_QPA_PLATFORM
# ls /usr/lib/libGLESv2.so六、常见误区与复盘
- 误区一：桌面端用 OpenGL，目标板用 GLES，却直接复用桌面代码。应使用 Qt 的 QOpenGLFunctions 抽象层，或条件编译区分。
- 误区二：只拷贝可执行文件，忘记拷贝 Qt 插件与字体。应使用
linuxdeployqt或手动打包 plugins、fonts。 - 误区三：忽略 EGL 上下文创建失败。应在 main 中检查
QOpenGLContext::create()返回值并打印日志。 - 误区四：交叉编译时未指定 sysroot，导致链接到宿主机库。应在 Kit 中明确 sysroot 路径。