Qt交叉编译实战：从.pro文件配置到Raspberry Pi部署

Qt交叉编译实战：从.pro文件配置到Raspberry Pi部署

引用

CSDN

等

12

来源

1.

https://blog.csdn.net/hao745580264_dawei/article/details/140851531

2.

https://cloud.baidu.com/article/3291042

3.

https://blog.csdn.net/DreamerPerple/article/details/138030108

4.

https://blog.csdn.net/qianniulaoren/article/details/139028554

5.

https://blog.csdn.net/2401_85014385/article/details/138865006

6.

https://blog.csdn.net/weixin_65561265/article/details/141856830

7.

https://blog.csdn.net/StringJun/article/details/136907586

8.

https://blog.csdn.net/ZOIpuus/article/details/135586552

9.

https://doc.embedfire.com/linux/rk356x/Qt/zh/latest/lubancat_qt/install/install_arm_2.html

10.

https://www.interelectronix.com/cn/zhendui-raspberry-pi-de-qt-68-jiaochabianyi.html

11.

https://www.cnblogs.com/ybqjymy/p/18074798

12.

https://www.cnblogs.com/zhijun1996/p/18512505

在嵌入式系统开发中，Qt的交叉编译是一个常见需求。通过掌握Qt.pro文件的技巧，你可以更高效地进行Linux环境下的Qt交叉编译。本教程将详细讲解如何设置交叉编译环境、下载并配置Qt源码以及修改.pro文件来支持交叉编译。

在嵌入式系统开发中，Qt的交叉编译是一个常见需求。通过掌握Qt.pro文件的技巧，你可以更高效地进行Linux环境下的Qt交叉编译。本教程将详细讲解如何设置交叉编译环境、下载并配置Qt源码以及修改.pro文件来支持交叉编译。

Qt的交叉编译是指在一台主机（通常是x86架构的PC）上编译出能够在另一台目标机（通常是嵌入式设备）上运行的代码。这种开发模式在嵌入式系统开发中非常常见，因为嵌入式设备的硬件资源有限，不适合直接进行编译工作。

在Qt的交叉编译中，.pro文件扮演着至关重要的角色。它不仅定义了项目的编译规则，还包含了交叉编译所需的特定配置。通过合理配置.pro文件，可以确保项目在不同平台上的兼容性和可移植性。

Qt的.pro文件是qmake工具使用的项目配置文件，它定义了如何构建Qt应用程序或库。通过简单的键值对语法，可以指定源文件、头文件、库依赖、配置选项等。

基本配置指令

• TARGET：指定生成的目标文件名称（不包括扩展名）。
• TEMPLATE：指定项目模板类型，如app（应用程序）、lib（库）、subdirs（子目录）等。
• CONFIG：用于指定编译和链接选项，如debug、release、c++11等。
• QT：指定项目使用的Qt模块，如core、gui、widgets等。

交叉编译相关配置

在交叉编译场景下，以下配置尤为重要：

• QMAKE_CXX：指定交叉编译器的C++编译器路径。
• QMAKE_LINK：指定交叉编译器的链接器路径。
• QMAKE_AR：指定交叉编译器的归档工具路径。
• QMAKE_RANLIB：指定交叉编译器的ranlib工具路径。
• QMAKE_STRIP：指定交叉编译器的strip工具路径。
• QMAKE_LFLAGS：指定链接器的附加选项。
• QMAKE_CXXFLAGS：指定C++编译器的附加选项。

库依赖管理

在交叉编译时，正确处理库依赖至关重要。例如，如果需要去除对libsystemd的依赖，可以在.pro文件中注释掉相关链接：

-LIBS += -lsystemd

以Raspberry Pi为例，介绍完整的Qt交叉编译流程：

环境准备

1. 硬件和软件需求：

   • Raspberry Pi 4
   • raspiOS Bookworm（64位）
   • Ubuntu 22.04 LTS
   • Qt 6.8
   • QtCreator 14.02

2. 安装Raspbian系统：

   • 从Raspberry Pi官网下载最新映像
   • 使用Balena Etcher将映像烧录到SD卡
   • 配置SSH远程连接

安装所需软件

在Raspberry Pi上通过SSH连接并安装必要的开发库：

sudo apt-get install libboost-all-dev libudev-dev libinput-dev libts-dev libmtdev-dev libjpeg-dev libfontconfig1-dev libssl-dev libdbus-1-dev libglib2.0-dev libxkbcommon-dev libegl1-mesa-dev libgbm-dev libgles2-mesa-dev mesa-common-dev libasound2-dev libpulse-dev gstreamer1.0-omx libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-alsa libvpx-dev libsrtp2-dev libsnappy-dev libnss3-dev "^libxcb.*" flex bison libxslt-dev ruby gperf libbz2-dev libcups2-dev libatkmm-1.6-dev libxi6 libxcomposite1 libfreetype6-dev libicu-dev libsqlite3-dev libxslt1-dev

创建Qt安装目录

sudo mkdir /usr/local/qt6

获取交叉编译工具链

确保使用与目标系统相同的GCC版本。例如，如果Raspberry Pi上使用的是GCC 12.2.0，那么需要下载相同版本的交叉编译工具链。

配置Qt源码

下载Qt源码并解压，然后配置编译选项：

./configure -release -opensource -confirm-license -prefix /usr/local/qt6 -sysroot /path/to/sysroot -device linux-rasp-pi4-v3d-g++ -device-option CROSS_COMPILE=/path/to/cross_compiler/bin/aarch64-linux-gnu- -nomake examples -nomake tests

编译和安装Qt

make -j4
sudo make install

配置Qt Creator

1. 打开Qt Creator，进入“工具”->“选项”->“构建与运行”->“Qt版本”
2. 点击“添加”，选择新编译的Qt版本
3. 在“构建套件”中添加新的交叉编译套件
4. 选择正确的Qt版本和编译器
5. 配置sysroot路径

测试交叉编译

创建一个新的Qt项目，确保.pro文件中包含正确的交叉编译配置。然后选择之前配置的交叉编译套件进行构建。如果一切正常，生成的二进制文件应该能够在Raspberry Pi上运行。

1. 库路径问题：确保所有依赖库都已正确安装在目标系统上，并通过sysroot路径正确引用。
2. 编译器版本不匹配：交叉编译器的版本必须与目标系统的GCC版本一致。
3. 环境变量配置：确保所有必要的环境变量（如PATH、LD_LIBRARY_PATH）都已正确设置。
4. Qt版本兼容性：确保Qt源码版本与目标系统兼容。

通过以上步骤，你可以成功搭建Qt的交叉编译环境，并通过合理配置.pro文件，实现高效的嵌入式开发。希望本教程能帮助你更好地掌握Qt交叉编译的核心技术，提升开发效率。