<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- installation.qdoc -->
<title>Qt 4.8: Installing Qt for Windows</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li>Installing Qt for Windows</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<link rel="prev" href="installation.html" />
<p class="naviNextPrevious headerNavi">
<a class="prevPage" href="installation.html">Installation</a>
</p><p/>
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#step-1-install-the-license-file-commercial-editions-only">Step 1: Install the License File (commercial editions only)</a></li>
<li class="level1"><a href="#step-2-unpack-the-archive">Step 2: Unpack the Archive</a></li>
<li class="level1"><a href="#step-3-set-the-environment-variables">Step 3: Set the Environment variables</a></li>
<li class="level1"><a href="#step-4-build-the-qt-library">Step 4: Build the Qt Library</a></li>
<li class="level1"><a href="#qt-demos-and-examples">Qt Demos and Examples</a></li>
</ul>
</div>
<h1 class="title">Installing Qt for Windows</h1>
<span class="subtitle"></span>
<!-- $$$install-win.html-description -->
<div class="descr"> <a name="details"></a>
<p>Qt for Windows has some requirements that are given in more detail in the <a href="requirements-win.html">Qt for Windows Requirements</a> document.</p>
<p>If you have obtained a binary package for this platform, consult the installation instructions provided instead of the ones in this document.</p>
<p>Open Source Versions of Qt is not officially supported for use with any version of Visual Studio. Integration with Visual Studio is available as part of the Qt Commercial Edition.</p>
<a name="step-1-install-the-license-file-commercial-editions-only"></a>
<h2>Step 1: Install the License File (commercial editions only)</h2>
<p>If you have the commercial edition of Qt, copy the license file from your account on dist.trolltech.com into your home directory (this may be known as the <tt>userprofile</tt> environment variable) and rename it to <tt>.qt-license</tt>. This renaming process must be done using a <i>command prompt</i> on Windows, <b>not</b> with Windows Explorer. For example on Windows 2000, <tt>%USERPROFILE%</tt> should be something like <tt>C:\Documents and Settings\username</tt></p>
<p>For the open source version you do not need a license file.</p>
<a name="step-2-unpack-the-archive"></a>
<h2>Step 2: Unpack the Archive</h2>
<p>Uncompress the files into the directory you want Qt installed; e.g. <tt>C:\Qt\4.8.7</tt>.</p>
<p><b>Note:</b> The install path must not contain any spaces or Windows specific file system characters.</p>
<a name="step-3-set-the-environment-variables"></a>
<h2>Step 3: Set the Environment variables</h2>
<p>In order to build and use Qt, the <tt>PATH</tt> environment variable needs to be extended:</p>
<pre class="cpp"> PATH - to locate qmake, moc and other Qt tools</pre>
<p>This is done by adding <tt>c:\Qt\4.8.7\bin</tt> to the <tt>PATH</tt> variable.</p>
<p>For newer versions of Windows, <tt>PATH</tt> can be extended through the <b>Control Panel|System|Advanced|Environment variables</b> menu.</p>
<p>You may also need to ensure that the locations of your compiler and other build tools are listed in the <tt>PATH</tt> variable. This will depend on your choice of software development environment.</p>
<p><b>Note:</b> If you don't use the configured shells, which is available in the application menu, in the <a href="opensourceedition.html">Open Source Versions of Qt</a>, <tt>configure</tt> requires that <tt>sh.exe</tt> is not in the path or that it is run from <tt>msys</tt>. This also goes for mingw32-make.</p>
<a name="step-4-build-the-qt-library"></a>
<h2>Step 4: Build the Qt Library</h2>
<p>To configure the Qt library for your machine, type the following command in a <b>Visual Studio</b> command prompt:</p>
<pre class="cpp"> C:
cd /D C:\Qt\4.8.7
configure</pre>
<p>Type <tt>configure -help</tt> to get a list of all available options. The <a href="configure-options.html">Configuration Options for Qt</a> page gives a brief overview of these.</p>
<p>If you have multiple compilers installed, and want to build the Qt library using a specific compiler, you must specify a <tt>qmake</tt> specification. This is done by pasing <tt>-platform <spec></tt> to configure; for example:</p>
<pre class="cpp"> configure -platform win32-msvc</pre>
<p>In some cases you need to set up the compilation environment before running configure in order to use the right compiler. For instance, you need to do this if you have Visual Studio 2005 installed and want to compile Qt using the x64 compiler because the 32-bit and 64-bit compiler both use the same <tt>qmake</tt> specification file. This is usually done by selecting <b>Microsoft Visual Studio 2005|Visual Studio Tools|<Command Prompt></b> from the <b>Start</b> menu.</p>
<p>The actual commands needed to build Qt depends on your development system. For Microsoft Visual Studio to create the library and compile all the demos, examples, tools and tutorials type:</p>
<pre class="cpp"> nmake</pre>
<p><b>Note:</b> If you later need to reconfigure and rebuild Qt from the same location, ensure that all traces of the previous configuration are removed by entering the build directory and typing <tt>nmake distclean</tt> before running <tt>configure</tt> again.</p>
<p><b>That's all. Qt is now installed.</b></p>
<a name="qt-demos-and-examples"></a>
<h2>Qt Demos and Examples</h2>
<p>If you are new to Qt, we suggest that you take a look at the demos and examples to see Qt in action. Run the Qt Examples and Demos either by typing <tt>qtdemo</tt> on the command line or through the desktop's Start menu.</p>
<p>You might also want to try the following links:</p>
<ul>
<li><a href="how-to-learn-qt.html">How to Learn Qt</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="http://www.qt.io/developers/">Developer Network</a></li>
<li><a href="deployment.html">Deploying Qt Applications</a></li>
</ul>
<p>We hope you will enjoy using Qt. Good luck!</p>
</div>
<!-- @@@install-win.html -->
<p class="naviNextPrevious footerNavi">
<a class="prevPage" href="installation.html">Installation</a>
</p>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
