View source for Install Qt 5 on Ubuntu

{{LangSwitch}}

[[Category:HowTo]]
[[Category:Tutorial]]
[[Category:Tools::QtCreator]]

=Install Qt 5 on Ubuntu=

==Introduction==

This is a tutorial for installation of Qt 5.7.0 to Ubuntu 12.10. It may be used for some newer versions of Qt and Ubuntu. As a counterexample, Ubuntu 16.04 LTS uses an independent system for controlling the Qt version.  Following these directions for Ubuntu 16.04 results in an error where a file can't be found in a qt4 directory, even though you're installing qt5 not 4.  Another difference for OpenGL has been found and added as a note below.

==Installation Guide (Ubuntu package)==

Open a terminal. Type the following command and hit Enter:
<code>
sudo apt-get install qt5-default
</code>

Qt 5.x will be installed.  

==Installation Guide (Qt download page)==

*'''Download'''

Visit Qt downloads page an [https://www.qt.io/download-open-source/#section-2 download a 32-bit or 64-bit Linux installation] depending your version of Ubuntu. The installation file can be also downloaded through the command line using wget.

''Example:''
<code>
wget [https://download.qt.io/new_archive/qt/5.7/5.7.0/qt-opensource-linux-x64-5.7.0.run https://download.qt.io/new_archive/qt/5.7/5.7.0/qt-opensource-linux-x64-5.7.0.run]
</code>

''This is valid until 5.14.2 due to policy change, distributing Open Source Qt linux package is discontinue from 5.15.0. You need to [https://doc.qt.io/qt-5/linux-building.html build] your own package starting from 5.15.0.''

*'''Install'''

Adjust permission, run the installer and follow the instruction to complete the installation.

<code>
chmod +x qt-opensource-linux-x64-5.7.0.run
./qt-opensource-linux-x64-5.7.0.run
</code>

*'''Install g++'''

Open a terminal and execute the following command to install g++:
<code>
sudo apt-get install build-essential
</code>

*'''Install generic font configuration library - runtime'''

Open a terminal and execute the following command to install the full runtime files for the generic font configuration library:
<code>
sudo apt-get install libfontconfig1
</code>

*'''Configure a compiler'''

Launch '''Qt Creator'''. Go to '''Tools > Options'''. Click '''Build & Run''' and select tab '''Kit'''. Configure a compiler if it is not automatically detected.

*'''Install OpenGL libraries'''

Execute the following command to install OpenGL libraries:
<code>
sudo apt-get install mesa-common-dev
</code>

Note: Just installing the above-mentioned mesa-common-dev kit is not sufficient for more recent Ubuntu versions. Based on a comment in the Qt forum<ref>[https://forum.qt.io/topic/59062/qt-5-5-0-problem-running-examples-solved/2 Qt 5.5.0 problem running examples &#91;SOLVED&#93;]. 2015-09-22. [https://web.archive.org/web/20160801041947/https://forum.qt.io/topic/59062/qt-5-5-0-problem-running-examples-solved Archived] from the original on 2016-08-01. Retrieved 2016-08-01. <blockquote>Execute the following command to install OpenGL libraries: sudo apt-get install mesa-common-dev Note: Just installing the above-mentioned mesa-common-dev kit is not sufficient for more recent Ubuntu versions. Based on this comment in the forum an additional package needs installation. Execute following command: sudo apt-get install libglu1-mesa-dev -y Tested with Qt5.3.1 and Ubuntu 14.04 and it solved the problem with missing -lGL.</blockquote></ref> an additional package needs installation. Execute following command:
<code>
sudo apt-get install libglu1-mesa-dev -y
</code>
Tested with Qt5.3.1 and Ubuntu 14.04 and it solved the problem with missing -lGL.

*'''Set file association with pro files'''

When installing from the on-line source the file association is not done automatically.
It also not show up when you try to associate it with file explorer.
Create a file named “Qt-Creator.desktop” and fill the file with the following.

<code>
[Desktop Entry]
Version=1.0
Encoding=UTF-8
Type=Application
Name=QtCreator
Comment=QtCreator
NoDsiplay=true
Exec=(Install folder of QT)/Tools/QtCreator/bin/qtcreator %f
Icon=(Install folder of QT)/5.4/Src/qtdoc/doc/images/landing/icon_QtCreator_78x78px.png
Name[en_US]=Qt-Creator
</code>

Place this file in home .local/share/applications .

Edit a file named “defaults.list” in the same directory .
Add the following line.

<code>
text/qtcreator=Qt-Creator.desktop;
</code>

open file mimeapps.list and check if the following line is present.

<code>
application/vnd.nokia.qt.qmakeprofile=qtcreator.desktop
</code>

if not add it under [added Associations].

Run the following command.

<code>
sudo update-mime-database /usr/share/mime
</code>

now Qt has been added to the list of file associations.

==Troubleshooting==

*'''Qt Creator needs a compiler set up to build'''

Follow the instruction from the previous section to configure compiler for Qt Creator.

*'''error: g++: Command not found'''

''Solution:''
<code>
sudo apt-get install build-essential
</code>

*'''error: GL/gl.h: No such file or directory'''

''Solution:''
<code>
sudo apt-get install mesa-common-dev
</code>

==References==
<div class="references-small">
<references />
</div>