Qt Creator在UOS20（ARM）下的完整配置流程：从源码编译到项目运行

在国产操作系统UOS20上开发Qt应用，尤其是针对ARM架构的设备，需要经历从源码编译到IDE配置的完整流程。本文将手把手带你完成Qt Creator在UOS20（ARM）环境下的配置，确保你能顺利开展QML和Widgets项目开发。

1. 编译环境准备与源码获取

在开始配置Qt Creator之前，我们需要确保系统具备完整的编译环境。UOS20基于Debian，使用apt包管理器，但ARM架构的特殊性要求我们特别注意依赖项的安装。

首先安装基础编译工具链：

bash复制sudo apt update
sudo apt install build-essential bison flex gperf ruby python libicu-dev

对于Qt5.15.2的ARM编译，推荐使用官方源码包。注意要选择正确的压缩格式：

bash复制wget https://download.qt.io/archive/qt/5.15/5.15.2/single/qt-everywhere-src-5.15.2.tar.xz
tar -xvf qt-everywhere-src-5.15.2.tar.xz

提示：避免使用在Windows系统编辑过的源码包，这可能导致换行符问题影响编译。

2. 配置编译选项与解决依赖

进入解压后的源码目录，创建配置脚本autoConfigure.sh：

bash复制#!/bin/sh
./configure \
-prefix /opt/qt5.15.2_ARM \
-confirm-license \
-opensource \
-release \
-make libs \
-nomake examples \
-pch \
-qt-libjpeg \
-qt-libpng \
-qt-zlib \
-fontconfig \
-system-freetype \
-opengl \
-xcb \
-dbus \
-alsa \
-gif \
-gstreamer 1.0 \
-pulseaudio \
-xplatform linux-aarch64-gnu-g++

关键配置参数说明：

执行配置前，确保安装所有依赖库：

bash复制sudo apt install libxcb* libxkbcommon* libegl1-mesa-dev libgstreamer* pulseaudio*

3. 编译与安装Qt

配置完成后，开始编译过程：

bash复制chmod +x autoConfigure.sh
./autoConfigure.sh
make -j$(nproc)
sudo make install

编译过程中可能遇到的问题及解决方案：

1. location模块编译错误

   • 解决方法：删除qtlocation目录后重新编译

2. QDBus相关链接错误

   • 解决方法：清理构建目录并重新配置

3. xcb插件缺失

   • 确保libxcb版本≥1.9.1
   • 检查/opt/qt5.15.2_ARM/plugins/platforms/是否存在libqxcb.so

4. 系统环境配置

编译安装完成后，需要设置环境变量使系统识别Qt安装：

编辑~/.bashrc文件，添加：

bash复制export PATH=/opt/qt5.15.2_ARM/bin:$PATH
export QT_QPA_PLATFORM_PLUGIN_PATH=/opt/qt5.15.2_ARM/plugins/platforms

使配置立即生效：

bash复制source ~/.bashrc

验证安装：

bash复制qmake --version
# 应显示Qt版本5.15.2

5. Qt Creator配置详解

5.1 安装与基础设置

安装Qt Creator：

bash复制sudo apt install qtcreator

启动Qt Creator后，按以下步骤配置：

1. 添加Qt版本

   • 工具 → 选项 → Kits → Qt Versions
   • 点击"添加"，选择/opt/qt5.15.2_ARM/bin/qmake

2. 配置编译器

   • 工具 → 选项 → Kits → Compilers
   • 添加GCC C++和GCC C编译器
   • 路径通常为/usr/bin/aarch64-linux-gnu-g++

3. 创建编译套件(Kit)

   • 名称：Qt5.15.2 ARM
   • 设备类型：桌面
   • 编译器：选择刚配置的GCC
   • Qt版本：选择刚添加的Qt5.15.2
   • Qt mkspec：linux-aarch64-gnu-g++

5.2 调试配置

对于需要调试的场景，还需配置：

1. 安装gdb调试器：

   bash复制sudo apt install gdb-multiarch
   

2. 在Kit设置中：

   • 调试器选择/usr/bin/gdb-multiarch
   • 设置sysroot路径（如需）

6. 项目创建与问题排查

创建新项目时，选择刚配置的Kit。常见问题及解决方案：

1. 找不到xcb平台插件

   • 确认QT_QPA_PLATFORM_PLUGIN_PATH环境变量设置正确
   • 检查/opt/qt5.15.2_ARM/plugins/platforms/目录是否存在

2. QML应用无法运行

   • 确保编译时启用了-xcb选项
   • 检查OpenGL驱动是否正常

3. 交叉编译问题

   • 确认Kit中mkspec设置正确
   • 检查编译器路径是否指向ARM版本

7. 高级配置与优化

对于生产环境开发，建议进行以下优化：

1. 构建目录分离

   bash复制mkdir qt-build && cd qt-build
   ../qt-everywhere-src-5.15.2/configure [options]
   

2. 模块裁剪

   • 通过-skip参数排除不需要的模块
   • 例如：-skip qtwebengine -skip qtdoc

3. 调试符号分离

   • 编译时添加-force-debug-info
   • 发布时使用strip去除调试符号

4. 静态编译配置

   bash复制-static -no-pch -no-gui -no-widgets
   

在实际项目开发中，我发现最关键的环节是确保xcb和OpenGL相关依赖完整。曾经一个项目因为libxcb版本问题卡了三天，后来通过源码编译最新版libxcb解决了问题。建议在正式开发前，先创建一个简单的QML测试程序验证环境是否配置正确。