Ubuntu 18.04下Qt 5.12嵌入式开发环境搭建指南

1. 嵌入式Linux Qt开发环境搭建概述

在嵌入式设备开发领域，Qt框架因其跨平台特性和丰富的UI组件库而广受欢迎。选择Ubuntu 18.04作为开发平台主要基于其长期支持(LTS)特性与Qt框架的良好兼容性。对于需要图形界面的嵌入式设备（如工业HMI、智能家居控制面板等），Qt提供了从底层驱动到上层应用的完整解决方案。

我在多个车载娱乐系统和工业控制面板项目中采用Qt进行开发，发现其信号槽机制和布局系统能显著提升开发效率。特别是在资源受限的嵌入式环境，Qt的模块化设计允许开发者只编译必要的组件，这对存储空间通常只有几十MB的嵌入式设备至关重要。

2. Ubuntu 18.04基础环境配置

2.1 系统源配置优化

国内开发者建议更换软件源以提升下载速度。阿里云源配置步骤如下：

1. 备份原始源列表文件：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

2. 编辑源列表文件：

sudo nano /etc/apt/sources.list

3. 替换为阿里云18.04(bionic)源：

deb http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse

4. 更新软件包索引：

sudo apt update && sudo apt upgrade -y

注意：执行升级时建议关闭其他正在运行的程序，避免依赖冲突。曾遇到因未完全升级导致Qt依赖库版本不匹配的情况，重新执行完整升级后解决。

2.2 基础开发工具安装

Qt开发需要的基础工具链包括：

sudo apt install -y build-essential make cmake clang gdb

对于嵌入式交叉编译还需安装：

sudo apt install -y gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf

3. Qt 5.12完整安装指南

3.1 安装包获取与校验

官方下载地址：

wget https://download.qt.io/archive/qt/5.12/5.12.12/qt-opensource-linux-x64-5.12.12.run

赋予执行权限：

chmod +x qt-opensource-linux-x64-5.12.12.run

3.2 安装组件选择策略

执行安装程序：

./qt-opensource-linux-x64-5.12.12.run

组件选择建议：

• 必选：Qt 5.12.2 > Desktop gcc 64-bit
• 推荐：Qt Charts、Qt Data Visualization
• 可选：Qt Script（传统项目兼容）、Qt WebEngine
• 嵌入式开发需添加：Qt for Device Creation

经验：在SSD存储设备上，完整安装约需要25GB空间。曾因/tmp分区空间不足导致安装失败，可通过设置TMPDIR环境变量指定临时目录：

export TMPDIR=/path/to/large/space

3.3 常见安装问题解决

问题1：XCB插件加载失败

qt.qpa.plugin: Could not load the Qt platform plugin "xcb"

解决方案：

sudo apt install -y libxcb-xinerama0 libxcb-icccm4 libxcb-image0 \
libxcb-keysyms1 libxcb-render-util0 libxcb-shape0

问题2：OpenGL链接错误

error: cannot find -lGL

解决方法：

sudo apt install -y libgl1-mesa-dev libglu1-mesa-dev

4. Qt Creator配置详解

4.1 编译器检测与配置

Qt Creator首次启动后需配置工具链：

1. 进入"Tools" > "Options" > "Kits"
2. 在"Compilers"标签添加Clang编译器：
   • C: /usr/bin/clang
   • C++: /usr/bin/clang++
3. 在"Debuggers"标签配置GDB路径

4.2 创建测试项目验证

新建Widgets Application项目时注意：

1. 构建系统选择qmake（兼容性最好）
2. 初始模板建议选择MainWindow
3. 在.pro文件中添加中文支持：

QT += core gui
QT += widgets

# 添加中文支持
QMAKE_CXXFLAGS += -finput-charset=UTF-8

5. 中文输入法集成方案

5.1 Fcitx输入法安装

sudo apt install -y fcitx fcitx-pinyin fcitx-module-cloudpinyin \
fcitx-ui-classic fcitx-config-gtk

环境变量配置（~/.profile追加）：

export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx

5.2 Qt Creator输入法支持

关键步骤：

1. 安装Qt输入法插件：

sudo apt install fcitx-frontend-qt5

2. 复制插件到Qt目录：

sudo cp /usr/lib/x86_64-linux-gnu/qt5/plugins/platforminputcontexts/libfcitxplatforminputcontextplugin.so \
/opt/Qt5.12.2/Tools/QtCreator/lib/Qt/plugins/platforminputcontexts/

3. 验证输入法：
   • 重启Qt Creator
   • 在文本编辑区域尝试切换输入法（Ctrl+Space）

踩坑记录：在虚拟机环境中，需要额外配置共享剪贴板才能正常使用输入法。VMware需安装open-vm-tools：

sudo apt install -y open-vm-tools-desktop

6. 嵌入式开发环境扩展

6.1 交叉编译工具链配置

1. 下载ARM工具链（示例使用Linaro）：

wget https://releases.linaro.org/components/toolchain/binaries/latest-7/arm-linux-gnueabihf/gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz

2. 解压并添加环境变量：

tar -xvf gcc-linaro-7.5.0-2019.12-x86_64_arm-linux-gnueabihf.tar.xz
echo 'export PATH=$PATH:/path/to/toolchain/bin' >> ~/.bashrc

6.2 Qt交叉编译配置

1. 在Qt Creator中创建新Kit
2. 指定交叉编译器路径
3. 配置qmake参数：

./configure -xplatform linux-arm-gnueabi-g++ \
-prefix /usr/local/qt-embedded \
-no-opengl \
-qt-freetype \
-no-largefile \

7. 开发效率提升技巧

7.1 常用插件推荐

1. FakeVim：提供Vim编辑模式
2. Beautifier：代码格式化
3. QML Profiler：性能分析工具

安装方法： "Help" > "About Plugins"

7.2 调试技巧

1. 条件断点：右键点击断点设置条件
2. 内存检测：

valgrind --tool=memcheck --leak-check=full ./your_app

3. QML调试：

qmlscene --qtquick2.debugger your_qml_file.qml

8. 项目部署实践

8.1 目标设备环境准备

1. 创建Qt运行环境：

scp -r /opt/Qt5.12.2/5.12.2/gcc_64/lib root@target:/usr/local/qt5/lib

2. 设置设备环境变量：

export LD_LIBRARY_PATH=/usr/local/qt5/lib:$LD_LIBRARY_PATH

8.2 精简部署方案

使用linuxdeployqt工具：

./linuxdeployqt your_app -qmake=/opt/Qt5.12.2/5.12.2/gcc_64/bin/qmake

经验：在嵌入式设备上部署时，建议使用静态编译减少依赖。曾遇到动态链接库版本冲突问题，改用静态编译后解决。