Documentation/4.1/Developers/Build Instructions/Prerequisites/Qt - Revision history

UpdateBot: Prepend documentation/versioncheck template. See http://na-mic.org/Mantis/view.php?id=2887

2013-06-14T07:31:31Z

Prepend documentation/versioncheck template. See http://na-mic.org/Mantis/view.php?id=2887

JChris.FillionR: /* Download Qt: Source and Binaries */

2012-06-17T17:29:13Z

Download Qt: Source and Binaries

JChris.FillionR: /* Windows */

2012-06-17T17:25:18Z

Windows

JChris.FillionR: /* Windows */

2012-06-17T17:24:22Z

Windows

JChris.FillionR: /* Download links */

2012-05-15T19:58:28Z

Download links

JChris.FillionR: /* Download links */

2012-05-15T19:56:02Z

Download links

Pieper: /* Download links */

2012-05-15T19:14:49Z

Download links

Pieper: /* Download links */

2012-05-03T21:37:46Z

Download links

Finetjul: /* Download Qt: Source and Binaries */ typo

2012-04-22T18:40:05Z

Download Qt: Source and Binaries: typo

JChris.FillionR: 4.0 -> 4.1

2012-04-12T04:42:32Z

4.0 -> 4.1

New page

= Binary vs build-from-source ? =

If you build Slicer on ...

== Linux ==

* Using [[#Download_links|binary]] works great for both '''Debug''' and '''Release''' build of Slicer. See [[#Download_links]] and [[#Installation_instruction]]

== Mac ==

* Using [[#Download_links|binary]] works great for both '''Debug''' and '''Release''' build of Slicer. See [[#Download_links]] and [[#Installation_instruction]]

== Windows ==

=== Debug (32 and 64-bit) or Release (64-bit) ===

* You have to build Qt from source. See [[#Download_links]] and [[#Installation_instruction]]

* '''Details''': Using the Qt Designer on Windows requires that the Slicer plugins are [http://doc.trolltech.com/4.6/deployment-plugins.html#debugging-plugins|compiled in the same mode as Qt]. If Qt was compiled in Release mode (default), Slicer would have to be compiled in Release mode as well. However if Qt is compiled in Debug mode only, Slicer has to be compiled in Debug too. When Qt is in "Release and Debug" mode only the Release version of Designer.exe is generated, Slicer would have to be compiled in Release. So for developers, the Debug mode is recommended, this is why we detail the compilation of Qt below.

=== Release (32-bit) ===

* Using [[#Download_links|binary]] works great for 32-bit Release build of Slicer. See [[#Download_links]] and [[#Installation_instruction]]

 

= Download Qt: Source and Binaries =

 
{{ambox
| type = warning
| text = While it is not enforced, we strongly advise you to '''USE''' the recommended version of Qt. We mean it. 
}}
 
That said, if you feel like experimenting, nothing prevent you from building against a difference version.

== Download links ==

The following table list the link allowing to download either the '''recommended''' source code or binary of Qt.

{| border="1" style="margin-left: 20px;"
|- bgcolor="#FFFFCC"
!rowspan="3"|
!colspan="2" rowspan="2"|Linux
!colspan="2"|Mac
!colspan="4"|Windows
|- bgcolor="#FFFFCC"
!colspan="1"|<del>Tiger</del>
!colspan="1"|Leopard, SnowLeopard
!colspan="2"|VS2008
!colspan="2"|VS2010
|- bgcolor="#FFFFCC"
!|32bits
!|64bits
!|<del>32bits</del>
!|64bits
!|32bits
!|64bits
!|32bits
!|64bits
|-
! bgcolor="#FFFFCC" | [http://get.qt.nokia.com/qt/source/ Qt source link]
|align="center" colspan="2"| [http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.4.tar.gz 4.7.4]
|style="background-color:#C0C0C0;" align="center" colspan="1"| <del>[http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.4.tar.gz 4.7.4]</del>
|align="center" colspan="1"| [http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.4.tar.gz 4.7.4]
|align="center" colspan="2"| [http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.4.zip 4.7.4]
|align="center" colspan="2"| [http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.4.zip 4.7.4]
|-
! bgcolor="#FFFFCC" | [http://get.qt.nokia.com/qt/source/ Qt binary link]
|align="center" colspan="1"| [http://sw.nokia.com/id/8ea74da4-fec1-4277-8b26-c58cc82e204b/Qt_SDK_Lin32_offline SDK-1.2]
|align="center" colspan="1"| [http://sw.nokia.com/id/14b2039c-0e1f-4774-a4f2-9aa60b6d5313/Qt_SDK_Lin64_offline SDK-1.2]
|style="background-color:#C0C0C0;" align="center" colspan="1"| <del>[http://get.qt.nokia.com/qt/source/qt-mac-carbon-opensource-4.7.0.dmg carbon_4.7.0]</del>
|align="center" colspan="1"| [ftp://ftp.qt.nokia.com/qt/source/qt-mac-opensource-4.7.4-debug-libs.dmg cocoa_4.7.4]
|align="center" colspan="1"| [http://get.qt.nokia.com/qt/source/qt-win-opensource-4.7.4-vs2008.exe 4.7.4]
|align="center" colspan="1"| -
|align="center" colspan="1"| [http://get.qt.nokia.com/qt/source/qt-win-opensource-4.7.4-vs2008.exe 4.7.4]
|align="center" colspan="1"| -
|}

== Installation instruction ==

=== Linux ===

See [[Documentation/{{documentation/version}}/Developers/Build_Instructions/Prerequisites/Qt/Instal_QtSDK1.2_Offline_Linux_64|Qt installation guide (4.7.4, Linux, 64-bit, Offline)]]

=== Mac ===

TBD

=== Windows ===

TBD

== Qt version specific issues ==

=== All ===

* '''Qt 4.6.x''' on windows (and possibly in linux/mac): No image base64 support in QLabel/QTooltips (work around exists though)
* '''Qt 4.8''' does not work with PythonQt in slicer4 - suggested version is 4.7.4

=== Linux ===

* NA

=== Mac ===

* '''Qt 4.6''': hard to compile - TBD: Be more specific
* '''Qt 4.7''': click outside of popup (http://na-mic.org/Mantis/view.php?id=1241) - Is it fixed in Qt 4.8 ?
* '''Qt 4.7.3''': http://na-mic.org/Mantis/view.php?id=1388 - Fixed in Qt 4.7.4

=== Windows ===

* NA

== How to change the minimum required version ? ==

* It's indeed possible to use a different version, just be aware that moving forward in time, things may not work as expected. Even worse Slicer may simply fail to compile.

* By configuring Slicer using <code>-DSlicer_REQUIRED_QT_VERSION:STRING=4.7.0</code>, you will be able to change the minimum required version.

* See [https://github.com/Slicer/Slicer/commit/898bb14e 898bb14e], [http://viewvc.slicer.org/viewvc.cgi/Slicer4?view=revision&revision=19698 r19698], [http://massmail.spl.harvard.edu/public-archives/slicer-devel/2012/008130.html Mailing list]

 

= Build instructions =
 
{{mbox
| text = Please, make sure that your IDE/compiler is '''properly installed''' and that all associated '''ServicePack''' are also installed. See [[Documentation/{{documentation/version}}/Developers/Build_Instructions/Prerequisites|Prerequisites]].
}}
 

== Linux ==


* Consider installing the following optional packages (<code>libxt-dev libxrender-dev libxrandr-dev libxinerama-dev libxcursor-dev libfontconfig-dev libglib2.0-dev</code>)

<pre>
mkdir qt-everywhere-opensource-build-4.7.4
tar xvfz qt-everywhere-opensource-src-4.7.4.tar.gz
cd qt-everywhere-opensource-src-4.7.4
./configure -prefix ../qt-everywhere-opensource-build-4.7.4 -debug-and-release -opensource -confirm-license -no-qt3support -webkit -nomake examples -nomake demos
make -j8
make install
</pre>

Note: Adapt <code>-j8</code> with the number of core on your machine, a dual core should probably not do more than <code>-j3</code>, an 8 core machine can resonably go as much as <code>-j12</code>.

== Mac ==

Similar to Linux configuration. Note that <code>-arch x86_64</code> has been added.

For earlier versions of Xcode and Mac OS X
<pre>
mkdir qt-everywhere-opensource-build-4.7.4
tar xvfz qt-everywhere-opensource-src-4.7.4.tar.gz
cd qt-everywhere-opensource-src-4.7.4
./configure -prefix ../qt-everywhere-opensource-build-4.7.4 -debug-and-release -opensource -confirm-license -no-qt3support -webkit -arch x86_64 -nomake examples -nomake demos -sdk /Developer/SDKs/MacOSX10.5.sdk/
make -j8
make install
</pre>

On the latest Xcode versions (4.3) and Lion (10.7) the Developer directories have moved. The command is now:

<pre>
./configure -prefix ../qt-everywhere-opensource-build-4.7.4 -debug-and-release -opensource -confirm-license -no-qt3support -arch x86_64 -nomake examples -nomake demos -webkit -sdk /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.7.sdk
</pre>

* Consider reading: http://doc.qt.nokia.com/4.7/developing-on-mac.html)

* Note:
** If building against SDK 10.6 or 10.7, you will probably get link errors similar to what's described in [https://trac.macports.org/ticket/30346] and [http://qt-project.org/forums/viewthread/15933]. The solution is probably to disable the <code>corewlan</code> module but didn't figure out to do that properly.

== Windows ==

# Use a windows extracter to unzip the [[Documentation/{{documentation/version}}/Developers/Build_Instructions/Prerequisites/Qt#Download_links|Qt archive]], don't use cygwin unzip it.
# launch the msvc2008 command prompt (MSVC08->Tools->Visual Studio 2008 CommandPrompt) (or: launch cmd.exe and run <code>vcvars32.bat</code>) Note: Start x64 prompt from Start menu (don't start from inside visual studio or it will be an x86 32 bit shell). Menu item is "Visual Studio 2008 x64 Win64 Command Prompt"
# build with <code>configure.exe -platform win32-msvc2008 -debug -nomake examples -nomake demos</code>
#* When asked, choose open source license type (o), then accept the license (y)
#* Note: the option <code>-prefix</code> doesn't work on Windows.
#* Note: According to [http://qt.nokia.com/doc/4.7/supported-platforms.html] Qt does not support msvc2008 on windows xp. However, running <code>configure.exe</code> with no <code>-platform</code> argument seems to work. If you run configure with the <code>-platform</code> argument first by mistake, and if <code>configure -clean</code> doesn't work, then you may need to start from a fresh extraction from the .zip archive before running <code>configure.exe</code> again with no <code>-platform</code>, unless you can run <code>nmake</code> with the config clean target.
#* Note: for Microsoft Visual Studio 2010 users, Qt 4.6.3 is hard to configure with MSVC2010, use Qt 4.7.x instead. Build with <code>set QMAKESPEC=win32-msvc2010</code> and <code>configure -platform win32-msvc2010 -debug</code>
# run <code>nmake</code>
#* Note: building with webkit support requires that src/3rdparty/webkit/WebCore/tmp/moc/{debug,release}_shared/mocinclude.tmp be removed. else you will get linker errors like <code>QNetworkReplyHandler.obj : error LNK2001: unresolved external symbol "public: virtual struct QMetaObject const * __thiscall WebCore::FormDataIODevice::metaObject(void)const (?metaObject@FormDataIODevice@WebCore@@UBEPBUQMetaObject@@XZ)</code>
#* Note: If you encounter the following error <code>api\qscriptextensionplugin.h(43): Error: Undefined interface,</code>, delete the files \src\script\tmp\moc\debug_shared\mocinclude.tmp and \src\script\tmp\moc\release_shared\mocinclude.tmp and restart nmake. For more info, please see [http://bugreports.qt.nokia.com/browse/QTBUG-6470 QTBug 6470]].

← Older revision		Revision as of 07:31, 14 June 2013
Line 1:		Line 1:
		+	<noinclude>{{documentation/versioncheck}}</noinclude>
	= Binary vs build-from-source ? =		= Binary vs build-from-source ? =

← Older revision		Revision as of 17:29, 17 June 2012
Line 27:		Line 27:

	= Download Qt: Source and Binaries =		= Download Qt: Source and Binaries =
−
−	~~<br>~~
−	~~{{ambox~~
−	~~\| type = warning~~
−	~~\| text = While it is not enforced, we strongly advise you to '''USE''' the recommended version of Qt. We mean it.<br>~~
−	}}
−	~~<br>~~
−	~~<font size="-1">That said, if you feel like experimenting, nothing prevent you from building against a different version.</font>~~
−

	== Download links ==		== Download links ==

@@ Line 34: / Line 34: @@
 }}
 <br>
-<font size="-1">That said, if you feel like experimenting, nothing prevent you from building against a difference version.</font>
+<font size="-1">That said, if you feel like experimenting, nothing prevent you from building against a different version.</font>

@@ Line 183: / Line 183: @@
 # Use a windows extracter to unzip the [[Documentation/{{documentation/version}}/Developers/Build_Instructions/Prerequisites/Qt#Download_links|Qt archive]], don't use cygwin unzip it.
 # launch the msvc2008 command prompt (MSVC08->Tools->Visual Studio 2008 CommandPrompt) (or: launch cmd.exe and run <code>vcvars32.bat</code>) Note: Start x64 prompt from Start menu (don't start from inside visual studio or it will be an x86 32 bit shell).  Menu item is "Visual Studio 2008 x64 Win64 Command Prompt"
-# build with <code>configure.exe -platform win32-msvc2008 -debug -webkit -nomake examples -nomake demos</code>
+# build with <code>configure.exe -platform win32-msvc2008 -opensource -confirm-license -debug -webkit -nomake examples -nomake demos</code>
 #* When asked, choose open source license type (o), then accept the license (y)
 #* Note: the option <code>-prefix</code> doesn't work on Windows.

@@ Line 73: / Line 73: @@
 |align="center" colspan="1"| [http://sw.nokia.com/id/14b2039c-0e1f-4774-a4f2-9aa60b6d5313/Qt_SDK_Lin64_offline SDK-1.2]
 |style="background-color:#C0C0C0;" align="center" colspan="1"| <del>[http://get.qt.nokia.com/qt/source/qt-mac-carbon-opensource-4.7.0.dmg carbon_4.7.0]</del>
-|align="center" colspan="1"| [ftp://ftp.qt.nokia.com/qt/source/qt-mac-opensource-4.7.4.dmg 4.7.4 SDK] [ftp://ftp.qt.nokia.com/qt/source/qt-mac-opensource-4.7.4-debug-libs.dmg 4.7.4 SDK (optional: include debug libs)]
+|align="center" colspan="1"| [ftp://ftp.qt.nokia.com/qt/source/qt-mac-opensource-4.7.4.dmg 4.7.4 SDK] <br> [ftp://ftp.qt.nokia.com/qt/source/qt-mac-opensource-4.7.4-debug-libs.dmg 4.7.4 SDK (optional: with debug libs)]
 |align="center" colspan="1"| [http://get.qt.nokia.com/qt/source/qt-win-opensource-4.7.4-vs2008.exe 4.7.4]

@@ Line 73: / Line 73: @@
 |align="center" colspan="1"| [http://sw.nokia.com/id/14b2039c-0e1f-4774-a4f2-9aa60b6d5313/Qt_SDK_Lin64_offline SDK-1.2]
 |style="background-color:#C0C0C0;" align="center" colspan="1"| <del>[http://get.qt.nokia.com/qt/source/qt-mac-carbon-opensource-4.7.0.dmg carbon_4.7.0]</del>
-|align="center" colspan="1"| [ftp://ftp.qt.nokia.com/qt/source/qt-mac-opensource-4.7.4-debug-libs.dmg cocoa_4.7.4]
+|align="center" colspan="1"| [ftp://ftp.qt.nokia.com/qt/source/qt-mac-opensource-4.7.4-debug-libs.dmg cocoa_4.7.4 debug libs] [ftp://ftp.qt.nokia.com/qt/source/qt-mac-opensource-4.7.4.dmg 4.7.4 SDK]
 |align="center" colspan="1"| [http://get.qt.nokia.com/qt/source/qt-win-opensource-4.7.4-vs2008.exe 4.7.4]
 |align="center" colspan="1"| -
@@ Line 79: / Line 80: @@
 |align="center" colspan="1"| -
 |}
 == Installation instruction ==