当前位置：首页 > news >正文

保姆级教程：在Ubuntu 22.04上为i.MX6ULL交叉编译QT6.6.0（含完整toolchain.cmake配置）

news 2026/7/29 6:28:10

保姆级教程：在Ubuntu 22.04上为i.MX6ULL交叉编译QT6.6.0（含完整toolchain.cmake配置）

嵌入式开发中，QT框架因其跨平台特性和丰富的UI组件库而广受欢迎。但对于刚接触嵌入式QT开发的新手来说，如何正确配置交叉编译环境往往是个令人头疼的问题。本文将手把手带你完成在Ubuntu 22.04系统上为NXP i.MX6ULL开发板交叉编译QT6.6.0的全过程，从工具链配置到最终安装，每个步骤都配有详细说明和避坑指南。

1. 环境准备与工具链安装

在开始之前，我们需要确保Ubuntu 22.04系统已经安装了必要的依赖包。打开终端，执行以下命令：

sudo apt update sudo apt install -y build-essential cmake ninja-build git python3 \ libgl1-mesa-dev libxcb-xinerama0-dev libfontconfig1-dev \ libfreetype6-dev libx11-dev libxext-dev libxfixes-dev \ libxi-dev libxrender-dev libxcb1-dev libx11-xcb-dev \ libxcb-glx0-dev libxcb-keysyms1-dev libxcb-image0-dev \ libxcb-shm0-dev libxcb-icccm4-dev libxcb-sync-dev \ libxcb-xfixes0-dev libxcb-shape0-dev libxcb-randr0-dev \ libxcb-render-util0-dev libxkbcommon-dev libxkbcommon-x11-dev

接下来，我们需要下载并安装适用于i.MX6ULL的交叉编译工具链。这里我们使用gcc-linaro-14.0.0版本：

wget https://releases.linaro.org/components/toolchain/binaries/14.0.0-2023.06/arm-linux-gnueabihf/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf.tar.xz sudo tar -xvf gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf.tar.xz -C /usr/local/arm/

添加工具链到系统PATH环境变量：

echo 'export PATH=/usr/local/arm/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf/bin:$PATH' >> ~/.bashrc source ~/.bashrc

验证工具链是否安装成功：

arm-linux-gnueabihf-gcc --version

2. 获取QT6.6.0源码并配置编译环境

首先下载QT6.6.0源码包：

wget https://download.qt.io/official_releases/qt/6.6/6.6.0/single/qt-everywhere-src-6.6.0.tar.xz tar -xvf qt-everywhere-src-6.6.0.tar.xz cd qt-everywhere-src-6.6.0

创建toolchain.cmake文件，这是交叉编译的关键配置文件：

# toolchain.cmake set(CMAKE_SYSTEM_NAME Linux) set(CMAKE_SYSTEM_PROCESSOR arm) set(CROSS_COMPILER /usr/local/arm/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf) set(CMAKE_C_COMPILER ${CROSS_COMPILER}-gcc) set(CMAKE_CXX_COMPILER ${CROSS_COMPILER}-g++) set(CMAKE_SYSROOT /usr/local/arm/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf/arm-linux-gnueabihf/libc) set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++17") # 标准路径设置 set(CMAKE_FIND_ROOT_PATH ${CMAKE_SYSROOT}) set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)

接下来，我们需要为i.MX6ULL创建特定的设备配置。在qtbase/mkspecs/devices/目录下创建linux-imx6ull-g++文件夹，并添加qmake.conf文件：

mkdir -p qtbase/mkspecs/devices/linux-imx6ull-g++

# qmake.conf include(../common/linux_device_pre.conf) QMAKE_CFLAGS = -march=armv7-a -mfpu=neon -mfloat-abi=hard QMAKE_CXXFLAGS = $$QMAKE_CFLAGS QMAKE_LFLAGS += -static-libstdc++ QMAKE_CC = /usr/local/arm/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-gcc QMAKE_CXX = /usr/local/arm/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-g++ QMAKE_LINK = /usr/local/arm/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-g++ QMAKE_LINK_SHLIB = /usr/local/arm/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-g++ QMAKE_AR = /usr/local/arm/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-ar cqs QMAKE_OBJCOPY = /usr/local/arm/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-objcopy QMAKE_STRIP = /usr/local/arm/gcc-linaro-14.0.0-2023.06-x86_64_arm-linux-gnueabihf/bin/arm-linux-gnueabihf-strip QMAKE_INCDIR_POST += \ $$[QT_SYSROOT]/usr/include \ $$[QT_SYSROOT]/usr/include/arm-linux-gnueabihf

3. 配置QT编译选项

现在我们可以开始配置QT的编译选项了。创建一个构建目录并进入：

mkdir build && cd build

执行CMake配置命令：

cmake ../ \ -GNinja \ -DCMAKE_BUILD_TYPE=Release \ -DCMAKE_TOOLCHAIN_FILE=../toolchain.cmake \ -DCMAKE_INSTALL_PREFIX=/opt/qt6-arm \ -DCMAKE_STAGING_PREFIX=/opt/qt6-arm \ -DQT_HOST_PATH=/opt/qt6-host \ -DQT_QMAKE_TARGET_MKSPEC=devices/linux-imx6ull-g++ \ -DQT_QPA_PLATFORM=linuxfb \ -DFEATURE_opengl=OFF \ -DINPUT_opengl=no \ -DFEATURE_xcb=OFF \ -DFEATURE_tslib=OFF \ -DINPUT_tslib=no \ -DFEATURE_graphs=OFF \ -DINPUT_graphs=no \ -DBUILD_qtgraphs=OFF \ -DQT_BUILD_EXAMPLES=OFF \ -DQT_BUILD_TESTS=OFF \ -DQT_FEATURE_brotli=OFF

关键参数解释：

-GNinja: 使用Ninja作为构建系统，比Make更快
-DCMAKE_TOOLCHAIN_FILE: 指定我们之前创建的交叉编译工具链文件
-DQT_QPA_PLATFORM=linuxfb: 指定使用Linux帧缓冲作为显示后端
-DFEATURE_opengl=OFF: 禁用OpenGL支持，因为i.MX6ULL没有硬件加速
-DCMAKE_INSTALL_PREFIX: 指定QT的安装路径

4. 编译与安装QT

配置完成后，我们可以开始编译QT了。使用以下命令进行并行编译：

cmake --build . --parallel $(nproc)

编译过程可能需要几个小时，具体时间取决于你的系统性能。编译完成后，执行安装命令：

sudo cmake --install .

安装完成后，QT将被安装到/opt/qt6-arm目录下。为了验证安装是否成功，可以检查目标目录：

ls /opt/qt6-arm

你应该看到类似以下的目录结构：

bin include lib libexec mkspecs plugins qml translations

5. 配置开发环境与测试

为了在开发主机上使用交叉编译的QT，我们需要配置一些环境变量。创建一个名为qt6-arm-env.sh的脚本：

#!/bin/bash export QT_HOST_PATH=/opt/qt6-host export QT_TARGET_PATH=/opt/qt6-arm export PATH=$QT_TARGET_PATH/bin:$PATH export PKG_CONFIG_PATH=$QT_TARGET_PATH/lib/pkgconfig:$PKG_CONFIG_PATH export LD_LIBRARY_PATH=$QT_TARGET_PATH/lib:$LD_LIBRARY_PATH

要测试交叉编译环境是否正常工作，可以创建一个简单的QT应用程序：

// main.cpp #include <QApplication> #include <QLabel> int main(int argc, char *argv[]) { QApplication app(argc, argv); QLabel label("Hello, i.MX6ULL!"); label.show(); return app.exec(); }

使用qmake生成Makefile并编译：