目录:

  1. 下载qt-opensource-linux-x64-5.12.12.run版本;
  2. 安装qt-opensource-linux-x64-5.12.12.run版本;
  3. 配置QT开发环境
  4. 问题分析和解决

Qt是嵌入式开发的必备工具之一,Qt5包含了qt-creator集成开发环境,可以方便的进行界面设计与业务编码调试

推荐安装qt 5.12版其为LTS长期支持版本,以安装 QT 5.12 版本为例

1.首先从Qt官网上下载Qt的安装包

下载网址:http://download.qt.io/archive/qt/

如 qt-opensource-linux-x64-5.12.8.run

完整下载地址是

http://download.qt.io/archive/qt/5.12/5.12.8/qt-opensource-linux-x64-5.12.12.run

2. 安装

cd 到 qt-opensource-linux-x64-5.12.12.run 文件所在的目录下

使用chmod命令给该文件添加x可执行权限并运行

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

在命令端口中输入命令开始安装

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

按提示选择安装路径,比如我的安装路径 /mnt/toolkits/qt/5.12.12/ 并等待安装结束;

3. 安装后的配置

由于Qt5包含了qt-creator集成开发环境,如果想自己通过qmake编译,需要进行一些设置。

3.1 首先在/usr/share/qtchooser/目录中添加一个default.conf文件;

如果没有qtchooser目录,则先通过 sudo apt install qtchooser 进行安装;

将第一行改为自己安装路径(这是我的安装路径/mnt/toolkits/qt/5.12.8)下的bin目录的路径,第二行改为qt 5.12.8目录的路径

编辑后的 /usr/share/qtchooser/default.conf 文件内容如下

/opt/Qt5.12.12/5.12.12/gcc_64/bin

/opt/Qt5.12.12/5.12.12/

后面再执行qt相关的命令时实际是调用了qtchooser, 然后qtchooser再根据配置的路径进行查找;

3.2 如果项目开发编译时提示没有-lGl,则是缺少 OpenGL 库,需要手动安装。

sudo apt-get install mesa-common-dev

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

3.3 如果QT开发C/C++,需要安装gcc/g++编译工具及其依赖;

sudo apt-get install build-essential

3.4 如果QT开发python语言的程序还需要pyqt5相关的依赖包

sudo apt-get install python3-pip

sudo python3 -m pip install pyqt5

由于安装QT开发环境时已经安装了qt-creator,qt-designer等工具,可以不再安装pyqt5-tools

# sudo python3 -m pip install pyqt5-tools

4、qt缺少xcb问题终极解决办法

这个是QT开发者经常遇到的问题,无论开发或者程序部署,关于部署的文档,之前我曾经写过一个文档,感兴趣的朋友可以网上翻翻看。

这里主要是记录安装qt-opensource-linux-x64-5.12.12.run,终端执行qtcreator命令之后提示xcb相关的错误。

This application failed to start because it could not find or load the Qt platform plugin "xcb"

in "".

Available platform plugins are: eglfs, linuxfb, minimal, minimalegl, offscreen, xcb, xcb.

Reinstalling the application may fix this problem.

经过分许无非有几种类别:

  1. 部署程序的目录当中没有platforms文件夹,或者platforms中的文件不全,可以通过ldd 程序或动态库名字,查看程序依赖的库是否存在 no项。
  2. 另外就是QT本身的xcb库依赖的二级动态链接库的依赖,有特殊的要求,就是与QT开发平台的目录结构一致,一般情况就是因为可执行程序上两层级目录没有lib文件夹(lib中的文件来自Qt5.12.12/5.12.12/gcc_64库文件,也可以通过脚本抓取依赖的库文件);
  3. 执行qtcreator时候提示这个文件多半是环境没有配置好,通过第三步的操作,可以解决这个问题。


  1. 在Terminal下直接输入命令就能打开QtCreator
  • qtcreator所在原始目录是
    /usr/local/QtCreator-2.8.1/bin/
  • 首先在/usr/bin/目录下创建一个启动脚本qtcreator
~$ sudo vi /usr/bin/qtcreator
  • 里面的内容
#!/bin/sh
export QT_HOME=/usr/local/QtCreator-2.8.1/bin/
$QT_HOME/qtcreator $*

第一行是一个特殊的注释,和.py文件开头加个#!/usr/bin/env python3一样的作用。第2行是添加原始路径,第三行添加启动程序。

然后给它执行权限

/usr/bin$ sudo chmod a+x qtcreator

然后在terminal敲个qtc,再tab一下,就能出现qtcreator了,第一步完成

2.添加桌面快捷方式

如果还想添加桌面快捷方式,也不难。

  • 进入/usr/share/applications/,然后新建一个qtcreator.desktop
~$ sudo vi /usr/share/applications/qtcreator.desktop
  • 进入编辑模式,写入以下内容,然后保存退出
[Desktop Entry]
Type=Application
Name=qtcreator
Comment=QtCreator
Exec=/usr/local/QtCreator-2.8.1/bin/qtcreator
Terminal=false
Categories=Development;IDE;C++;
  • 完成之后会在/usr/share/applications/目录下生成一个qtcreator,右键把它Copy to Desktop就好了~