Difference between revisions of "Building Qt Creator from Git"

From Qt Wiki
Jump to: navigation, search
 
Line 1: Line 1:
 +
[[Category:HowTo]]<br />[[Category:Developing_with_Qt::Qt 5]]
 +
 
'''English''' [[Building-Qt-Creator-from-Git-SimplifiedChinese|简体中文]]
 
'''English''' [[Building-Qt-Creator-from-Git-SimplifiedChinese|简体中文]]
  
=Building Qt Creator from git=
+
[toc align_right=&quot;yes&amp;quot; depth=&quot;3&amp;quot;]
  
==Dependencies==
+
= Building Qt Creator from git =
  
To build Qt Creator from git, you need to first prepare some dependencies:
+
== Dependencies ==
  
* Qt libraries from Qt 5.3.1 (or newer) are needed. You can use one of the prebuilt packages from [http://qt.io/download the Downloads Page] ''[qt.io]'', or, if you want to go with git all the way, [[Building Qt 5 from Git|compile Qt 5 from git]] ''[qt.io]'' . These Qt modules are required: qtscript, qttools and qtdeclarative.
+
To build Qt Creator from git, you need to first prepare some dependencies:<br />* Qt libraries from Qt 5.3.1 (or newer) are needed. You can use one of the prebuilt packages from &quot;the Downloads Page&amp;quot;:http://qt.io/download, or, if you want to go with git all the way, &quot;compile Qt 5 from git&amp;quot;:http://wiki.qt.io/Building_Qt_5_from_Git . These Qt modules are required: qtscript, qttools and qtdeclarative.
  
If you have Qt installed, you probably have all the other dependencies of Qt Creator, too. There are numerous Qt Creator plugins, and they may require additional packages to be installed (but they usually don’t block the compilation, so don’t worry).
+
If you have Qt installed, you probably have all the other dependencies of Qt Creator, too. There are numerous Qt Creator plugins, and they may require additional packages to be installed (but they usually don't block the compilation, so don't worry).
  
==Getting the source code==
+
== Getting the source code ==
  
To get Qt Creator source code, type this. If you do not want to include the <span class="caps">QBS</span> (Qt Build Suite) plugin, you may omit —recursive:<br />
+
To get Qt Creator source code, type this. If you do not want to include the QBS (Qt Build Suite) plugin, you may omit —recursive:<br /><code><br />git clone —recursive https://git.gitorious.org/qt-creator/qt-creator.git<br /></code>
  
This should be enough to compile Qt Creator from source. If you are interested in using other branches of the Qt Creator repository, please see the Qt Creator section at [[Branches|Branch Guidelines]] ''[qt.io]''.
+
This should be enough to compile Qt Creator from source. If you are interested in using other branches of the Qt Creator repository, please see the Qt Creator section at &quot;Branch Guidelines&amp;quot;:http://wiki.qt.io/Branches.
  
==Compiling Qt Creator==
+
== Compiling Qt Creator ==
  
For building Qt Creator, an out-of-source build is recommended. For simplicity, this tutorial gives instructions for a build directory (namely ‘qt-creator-build’) that is located in parallel to the source directory (‘qt-creator’), but any other folder can be used. If you have checked out '''<span class="caps">QBS</span>''', it will be compiled together with the rest of the code, you do not need to do anything special.
+
For building Qt Creator, an out-of-source build is recommended. For simplicity, this tutorial gives instructions for a build directory (namely 'qt-creator-build') that is located in parallel to the source directory ('qt-creator'), but any other folder can be used. If you have checked out '''QBS''', it will be compiled together with the rest of the code, you do not need to do anything special.
  
Before you start with building, make sure you are using correct version of Qt. This can be done with the following command:<br />
+
Before you start with building, make sure you are using correct version of Qt. This can be done with the following command:<br /><code><br />qmake -v<br /></code>
  
If the output points to a wrong version of Qt, or returns an error, you need to show the qmake binary to your environment (it may also mean that something is wrong with your Qt installation). You need to modify your <span class="caps">PATH</span> environment variable to include the directory with the qmake executable, e.g. &lt;Qt installation directory&gt;/qtbase/bin.
+
If the output points to a wrong version of Qt, or returns an error, you need to show the qmake binary to your environment (it may also mean that something is wrong with your Qt installation). You need to modify your PATH environment variable to include the directory with the qmake executable, e.g. &lt;Qt installation directory&amp;gt;/qtbase/bin.
 +
 
 +
<code><br />mkdir qt-creator-build<br />cd qt-creator-build<br />qmake -r ../qt-creator/qtcreator.pro<br /></code>
  
 
This will prepare the Makefile.
 
This will prepare the Makefile.
  
 
'''Note:''' If you built qt5 from the git repository and you get an error like
 
'''Note:''' If you built qt5 from the git repository and you get an error like
 +
 +
<code>Project ERROR: Unknown module(s) in QT: script<code>
  
 
..then In your qt5 repository run:
 
..then In your qt5 repository run:
  
Now, you can order the compilation:<br /> On Linux, OS X:<br /> On Windows (<span class="caps">MSVC</span>):<br />
+
</code>make module-qtscript</code>
  
Compilation takes a while (only a bit less than compilation of Qt libraries themselves) so be patient. After it’s finished, you can safely start using Qt Creator (binaries are located in qt-creator-build/bin directory).
+
Now, you can order the compilation:<br />On Linux, OS X:<br /><code><br />make <s>j &lt;number-of-cpu-cores+1&amp;gt;<br /></code><br />On Windows (MSVC):<br /><code><br />nmake<br /></code>
 +
<br />Compilation takes a while (only a bit less than compilation of Qt libraries themselves)</s> so be patient. After it's finished, you can safely start using Qt Creator (binaries are located in qt-creator-build/bin directory).
  
==Installing Qt Creator (optional)==
+
== Installing Qt Creator (optional) ==
  
No further steps are required, but if you want to install it on your machine, type this:<br /> Linux:<br /> On Windows:<br />
+
No further steps are required, but if you want to install it on your machine, type this:<br />Linux:<br /><code><br />make install INSTALL_ROOT=$INSTALL_DIRECTORY<br /></code><br />On Windows:<br /><code><br />nmake install INSTALL_ROOT=$INSTALL_DIRECTORY<br /></code>
  
 
On OS X, just move the Qt Creator app bundle where you like.
 
On OS X, just move the Qt Creator app bundle where you like.
 
This may require administrative rights on your machine, depending on the destination.
 
 
===Categories:===
 
 
* [[:Category:Developing with Qt|Developing_with_Qt]]
 
** [[:Category:Developing with Qt::Qt-5|Qt 5]]
 
* [[:Category:HowTo|HowTo]]
 

Revision as of 14:18, 23 February 2015


English 简体中文

[toc align_right="yes&quot; depth="3&quot;]

Building Qt Creator from git

Dependencies

To build Qt Creator from git, you need to first prepare some dependencies:
* Qt libraries from Qt 5.3.1 (or newer) are needed. You can use one of the prebuilt packages from "the Downloads Page&quot;:http://qt.io/download, or, if you want to go with git all the way, "compile Qt 5 from git&quot;:http://wiki.qt.io/Building_Qt_5_from_Git . These Qt modules are required: qtscript, qttools and qtdeclarative.

If you have Qt installed, you probably have all the other dependencies of Qt Creator, too. There are numerous Qt Creator plugins, and they may require additional packages to be installed (but they usually don't block the compilation, so don't worry).

Getting the source code

To get Qt Creator source code, type this. If you do not want to include the QBS (Qt Build Suite) plugin, you may omit —recursive:
<br />git clone recursive https://git.gitorious.org/qt-creator/qt-creator.git<br />

This should be enough to compile Qt Creator from source. If you are interested in using other branches of the Qt Creator repository, please see the Qt Creator section at "Branch Guidelines&quot;:http://wiki.qt.io/Branches.

Compiling Qt Creator

For building Qt Creator, an out-of-source build is recommended. For simplicity, this tutorial gives instructions for a build directory (namely 'qt-creator-build') that is located in parallel to the source directory ('qt-creator'), but any other folder can be used. If you have checked out QBS, it will be compiled together with the rest of the code, you do not need to do anything special.

Before you start with building, make sure you are using correct version of Qt. This can be done with the following command:
<br />qmake -v<br />

If the output points to a wrong version of Qt, or returns an error, you need to show the qmake binary to your environment (it may also mean that something is wrong with your Qt installation). You need to modify your PATH environment variable to include the directory with the qmake executable, e.g. <Qt installation directory&gt;/qtbase/bin.

<br />mkdir qt-creator-build<br />cd qt-creator-build<br />qmake -r ../qt-creator/qtcreator.pro<br />

This will prepare the Makefile.

Note: If you built qt5 from the git repository and you get an error like

Project ERROR: Unknown module(s) in QT: script<code>

..then In your qt5 repository run:
make module-qtscript</code> Now, you can order the compilation:
On Linux, OS X:
<br />make <s>j &lt;number-of-cpu-cores+1&amp;gt;<br />

On Windows (MSVC):
<br />nmake<br />


Compilation takes a while (only a bit less than compilation of Qt libraries themselves)</s> so be patient. After it's finished, you can safely start using Qt Creator (binaries are located in qt-creator-build/bin directory).

Installing Qt Creator (optional)

No further steps are required, but if you want to install it on your machine, type this:
Linux:
<br />make install INSTALL_ROOT=$INSTALL_DIRECTORY<br />

On Windows:
<br />nmake install INSTALL_ROOT=$INSTALL_DIRECTORY<br />

On OS X, just move the Qt Creator app bundle where you like.