【qt5.9.9交叉编译并运行到目标板完整版(无界面版本)】在嵌入式开发中，Qt 是一个非常常用的图形库框架，尤其适用于需要跨平台支持的项目。对于一些不需要图形界面的应用程序，比如后台服务、数据采集系统或控制模块，使用 Qt 的无界面版本可以有效减少资源占用，提升运行效率。本文将详细介绍如何在 Linux 环境下对 Qt 5.9.9 进行交叉编译，并将其部署到目标开发板上，实现无界面模式下的运行。
一、环境准备
在进行交叉编译之前，需要确保本地开发环境已经安装了必要的工具链和依赖项。以下是一些基本要求：
- 操作系统：推荐使用 Ubuntu 16.04 或更高版本（如 20.04），便于兼容性处理。
- 交叉编译工具链：根据目标板的架构选择对应的工具链。例如，若目标板为 ARM 架构，则需安装 `arm-linux-gnueabihf-gcc` 等工具。
- Qt 源码包：下载 Qt 5.9.9 的开源版本，可以从 [Qt 官网](https://download.qt.io/official_releases/qt/5.9/5.9.9/) 获取。
- 目标板信息：了解目标板的 CPU 架构、内核版本、系统类型（如 Debian、Buildroot 等）。
二、配置交叉编译环境
1. 安装交叉编译工具链
若未安装，可通过以下命令安装：
```bash
sudo apt-get install gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf
```
2. 设置环境变量
在终端中设置交叉编译路径，以便后续构建时识别：
```bash
export PATH=/usr/arm-linux-gnueabihf/bin:$PATH
```
3. 解压 Qt 源码包
下载后解压至合适目录，例如：
```bash
tar -xvf qt-everywhere-opensource-src-5.9.9.tar.xz
cd qt-everywhere-opensource-src-5.9.9
```
三、配置与编译 Qt
1. 创建编译目录
为了避免污染源码目录，建议新建一个 build 文件夹：
```bash
mkdir build && cd build
```
2. 执行 configure 命令
使用 `configure` 脚本指定交叉编译参数，并关闭不必要的模块（如 GUI 相关组件）以减小体积：
```bash
../configure -prefix /opt/qt5.9.9 \
-host-cppflags "-I/usr/include/arm-linux-gnueabihf" \
-target-cppflags "-I/usr/include/arm-linux-gnueabihf" \
-release \
-no-opengl \
-no-widgets \
-no-qtquick \
-no-qtwebengine \
-no-qtwebview \
-no-qtdeclarative \
-no-phonon \
-no-webkit \
-no-sql-mysql \
-no-sql-psql \
-no-sql-sqlite \
-no-multimedia \
-no-gui \
-nomake examples \
-nomake tests \
-sysroot /usr/arm-linux-gnueabihf
```
> 注意：以上参数可根据实际需求调整，尤其是 `-no-xxx` 参数用于移除不需要的功能模块。
3. 开始编译
编译过程可能耗时较长，取决于机器性能：
```bash
make -j4
```
4. 安装到指定路径
将编译后的 Qt 安装到目标路径：
```bash
sudo make install
```
四、部署到目标板
1. 复制 Qt 库文件
将 `/opt/qt5.9.9` 目录下的所有内容通过 SSH 或 USB 复制到目标板的相应路径中，例如 `/usr/local/qt5.9.9`。
2. 设置环境变量
在目标板上配置环境变量，使应用程序能够找到 Qt 库：
```bash
export LD_LIBRARY_PATH=/usr/local/qt5.9.9/lib:$LD_LIBRARY_PATH
export QT_DIR=/usr/local/qt5.9.9
```
3. 编写测试程序
编写一个简单的 Qt 控制台应用，验证是否能正常运行。例如：
```cpp
include
include
int main(int argc, char argv[]) {
QCoreApplication app(argc, argv);
qDebug() << "Qt application is running without GUI.";
return app.exec();
}
```
4. 编译并运行测试程序
使用交叉编译器编译该程序，并复制到目标板运行：
```bash
arm-linux-gnueabihf-g++ -o test_app main.cpp -I/usr/local/qt5.9.9/include -L/usr/local/qt5.9.9/lib -lQtCore
```
然后在目标板上运行：
```bash
./test_app
```
五、注意事项
- 依赖问题：确保目标板上已安装所有必要的动态链接库，否则可能会出现运行时错误。
- 调试方法：可以使用 `strace` 或 `gdb` 进行远程调试，提高排查效率。
- 性能优化：无界面版本可进一步精简 Qt 模块，降低内存占用和启动时间。
六、总结
通过上述步骤，我们成功地完成了 Qt 5.9.9 的交叉编译，并将其部署到目标开发板上，实现了无图形界面的运行。这种方式适用于对资源敏感的嵌入式场景，同时保持了 Qt 强大的功能和跨平台特性。对于开发者而言，掌握这一流程不仅有助于提升项目灵活性，也能增强对嵌入式系统开发的理解与掌控力。
