Linux UOS 编译Qt源码&Qt Creator源码调试

在编译前请安装好 Qt Creator，图形界面安装请参考：

Linux 统信UOS 搭建Qt开发环境

也可以使用以下命令一键安装 Qt Creator（推荐）：

sudo apt install g++ gdb cmake qt5-default qtcreator

1. 下载源码

Qt Downloads：https://download.qt.io/

有两个地方，有不同的版本：

https://download.qt.io/new_archive/qt/

https://download.qt.io/archive/qt/

我们选择5.11.3的版本：

https://download.qt.io/new_archive/qt/5.11/5.11.3/

进入 single 文件夹下载 tar.xz 格式源码：

• 下载后解压备用

2. 安装编译所依赖的库

温馨提示：

在安装以下库的过程中，依赖啥库就使用 sudo apt install xxx 安装啥库

• 安装开发工具包

sudo apt update
sudo apt install build-essential
# GNU / Linux进行开发的手册页
sudo apt-get install manpages-dev

• 基础编译环境

sudo apt-get build-dep qt5-default # 建立qt5编译的环境
sudo apt-get install libxcb-xinerama0-dev 
sudo apt-get install perl python git

• libxcb

sudo apt-get install '^libxcb.*-dev' libx11-xcb-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev libxkbcommon-x11-dev

• OpenGL

sudo apt-get install libgl1-mesa-dev
sudo apt-get install libglu1-mesa-dev
sudo apt-get install libegl1-mesa-dev
sudo apt-get install freeglut3-dev

3. configure 配置

• 打开第1步中解压的文件夹

• 键入以下 configure 命令进行配置

./configure -confirm-license --prefix="/data/home/uos/QT5/build/5.11.3" -opensource -debug

参数	含义
-confirm-license	自动确认许可证（使用开源或是商业）
–prefix	指定部署目录(默认 /usr/local/Qt-5.11.3)
-opensource	编译和链接Qt开源版本
-debug	编译和链接debug版本

可参考：Qt源码编译configure配置参数_xi_gua_gua的博客

• 配置完成，生成了 Makefile

这里提示使用 make 进行编译，make install 进行安装。

4. make 构建安装

• 构建

提示：-j<num> num代表编译的线程数目

make -j8

开始编译，此过程比较漫长，大概 分钟，根据电脑配置不同而不同。

构建完成：

• 安装

现在软件已经被构建好并且可以执行，接下来要做的就是将可执行文件复制到最终的路径。make install 命令就是将可执行文件、第三方依赖包和文档复制到正确的路径。

make install

5. 修改环境变量

在终端输入：

sudo vim ~/.bashrc

在末尾添加以下内容：

export QTDIR=/data/home/uos/QT5/build/5.11.3
export PATH=$QTDIR/bin:$PATH  
export MANPATH=$QTDIR/man:$MANPATH  
export LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH
export QT_QPA_PLATFORM_PLUGIN_PATH=$QTDIR/plugins/platforms
export QT_PLUGIN_PATH=$QTDIR/plugins
export PKG_CONFIG_PATH=$QTDIR/lib/pkgconfig

/data/home/uos/QT5/build/5.11.3 调试刚才 make install 的文件夹。

• 更新一下源头

6. 在 Qt Creator 配置新的构建套件

• 打开Qt Creator-工具-选项-Kits-Qt Versions

• 添加，选择刚才编译出来的Qt 5.11.3 下 bin 目录的 qmake

• 应用

• 添加构建套件

新建工程，选择新的构建套件进行测试：

成功运行：

7. 调试程序

• Qt Creator 常用调试快捷键

快捷键	操作
F5	开始调试
Shift+F5	停止调试
F9	设置和取消断点
F10	单步前进
F11	单步进入函数
Shift+F11	单步跳出函数

• 如果没有安装 gdb 调试器，点击调试会报错

• 这时候，就需要我们先安装调试环境，在终端输入以下命令：

sudo apt install gdb

• 执行以上命令后，Qt 会自动配置好gdb，现在就可以开始调试了：

• 完成后重启 QtCreator ，打开刚才的工程，打上断点，现在就可以调试了：

8. Qt源码调试

• 首先在需要调试的工程里面加载 qtbase 项目：

• 选择临时套件

• 等待配置完成

• 切换到自己的项目，现在就可以进入源码调试了：