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

Lasso: Replaced content with "{{documentation/banner | text = [https://slicer.readthedocs.io/en/latest/developer_guide/build_instructions/index.html This page has been moved to read-the-docs.] | bac..."

2025-11-22T03:02:11Z

Replaced content with "{{documentation/banner | text = [https://slicer.readthedocs.io/en/latest/developer_guide/build_instructions/index.html This page has been moved to read-the-docs.] | bac..."

Show changes

Pieper: /* Mac */

2017-08-04T23:40:03Z

Mac

Max.smolens: /* Mac */

2016-06-23T19:51:04Z

Mac

Lasso: /* Windows */

2016-06-19T15:55:57Z

Windows

Lasso: /* Download links */

2016-06-19T15:50:54Z

Download links

Lasso: /* Download links */

2016-06-19T15:50:11Z

Download links

Lasso: /* Windows */

2016-06-19T15:46:08Z

Windows

Lasso: /* Windows */

2016-06-19T15:44:20Z

Windows

Max.smolens: Fix Qt bug report link

2016-05-26T14:46:27Z

Fix Qt bug report link

Aylward: /* Qt 4.8.6 / VS2012 */

2016-01-17T19:05:44Z

Qt 4.8.6 / VS2012

← Older revision		Revision as of 23:40, 4 August 2017
Line 13:		Line 13:

	* To use QtCreator and the Slicer designer plugins, a possible option is to build QtCreator against the installed Qt libraries. See [http://slicer-devel.65872.n3.nabble.com/Using-Qt-Creator-with-Slicer4-On-Mac-OS-X-Multiple-Qt-libs-loaded-tp4026660p4026690.html discussion on the mailing list].		* To use QtCreator and the Slicer designer plugins, a possible option is to build QtCreator against the installed Qt libraries. See [http://slicer-devel.65872.n3.nabble.com/Using-Qt-Creator-with-Slicer4-On-Mac-OS-X-Multiple-Qt-libs-loaded-tp4026660p4026690.html discussion on the mailing list].
		+
		+	=== Mac with Homebrew ===
		+
		+	As an alternative to the binary, you can install QT 4.8.7 with homebrew on mac 10.12:
		+	<pre>
		+	brew tap cartr/qt4
		+	brew tap-pin cartr/qt4
		+	brew install qt@4
		+	brew install qt-webkit@2.3
		+	</pre>

	== Windows ==		== Windows ==

@@ Line 97: / Line 97: @@
 === Mac ===
-* Problem building Qt on MacOSX 10.9. See https://bugreports.qt.io/browse/QTBUG-32237
+* Problem building Qt on MacOSX 10.9. See https://bugreports.qt.io/browse/QTBUG-32237. Patch: https://gist.github.com/ejtttje/7163a9ced64f12ae9444.
 <!--
 * '''Qt 4.6''': hard to compile - TBD: Be more specific

@@ Line 180: / Line 180: @@
 == 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.
+=== Manual build instructions for older (not officially supported) configurations ===
-=== Qt 4.7.4 / VS2008 ===
+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), and follow the instructions below.
 * Rename the folder into for example <code>qt-4.7.4-64-vs2008-rel</code>.
@@ Line 210: / Line 213: @@
 ** Note: If you encounter the following error <code>api\qscriptextensionplugin.h(43): Error: Undefined interface,</code>, delete the files <i>\src\script\tmp\moc\debug_shared\mocinclude.tmp</i> and <i>\src\script\tmp\moc\release_shared\mocinclude.tmp</i> and restart nmake. For more info, please see [http://bugreports.qt.nokia.com/browse/QTBUG-6470 QTBug 6470]].
-=== Qt 4.8.5 / VS2010 ===
+==== Qt 4.8.5 / VS2010 ====
 * Rename the folder into for example <code>qt-4.8.5-64-vs2010-rel</code>.
@@ Line 244: / Line 247: @@
 ** Note: If you encounter the following error <code>api\qscriptextensionplugin.h(43): Error: Undefined interface,</code>, delete the files <i>\src\script\tmp\moc\debug_shared\mocinclude.tmp</i> and <i>\src\script\tmp\moc\release_shared\mocinclude.tmp</i> and restart jom. For more info, please see [http://bugreports.qt.nokia.com/browse/QTBUG-6470 QTBug 6470]].
-=== Qt 4.8.6 / VS2012 ===
+==== Qt 4.8.6 / VS2012 ====
 * Make sure your Visual Studio 2012 is patched with the latest patch (e.g. [http://www.microsoft.com/en-us/download/confirmation.aspx?id=39305 patch 4]).

@@ Line 34: / Line 34: @@
 !colspan="1" rowspan="2"|Linux
 !colspan="2"|Mac
-!colspan="2"|Windows
+!colspan="3"|Windows
 |- bgcolor="#FFFFCC"
 !colspan="1"|SnowLeopard
@@ Line 42: / Line 42: @@
 !colspan="1"|VS2013
 |- bgcolor="#FFFFCC"
 !|64bits
 !|64bits

@@ Line 40: / Line 40: @@
 !colspan="1"|VS2008
 !colspan="1"|VS2010
 |- bgcolor="#FFFFCC"
 !|64bits
@@ Line 53: / Line 54: @@
 |align="center" colspan="1"| [http://download.qt-project.org/official_releases/qt/4.8/4.8.6/qt-everywhere-opensource-src-4.8.6.zip 4.8.6]
 |align="center" colspan="1"| [http://download.qt-project.org/official_releases/qt/4.8/4.8.6/qt-everywhere-opensource-src-4.8.6.zip 4.8.6]
 |-
 ! bgcolor="#FFFFCC" | Qt binary link

@@ Line 16: / Line 16: @@
 == Windows  ==
 * Normally you should plan to build Qt from source to have complete control over the process. See [https://github.com/jcfr/qt-easy-build one-liner build command] or more detailed [[#Build_instructions]].
-** [[#Download_links|binary]] You may find that the '''unsigned''' binary downloads from this site are usable for older Visual Studio versions (but not for the currently official Visual Studio 2013 version): http://sourceforge.net/projects/qtx64/files/qt-x64/4.8.5/msvc2008/. If you use .7z varaints extract them in the default location C:\Qt\ otherwise that installation will not be properly configured for use with CMake.
+** You may find that the binary downloads are usable for older Visual Studio versions (but not for the currently official Visual Studio 2013 version): [[#Download_links|binary]]. If you use .7z varaints extract them in the default location C:\Qt\ otherwise that installation will not be properly configured for use with CMake.
 * Debug/release mode builds: The recommendation for developers is to build Slicer and Qt at least in Debug mode. To be able to test real-world performance, developers should also build Qt and Slicer in release mode (in a separate build tree), because some algorithms are 10x or more faster in release mode.
 ** Rationale: 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 to be able to use the Qt Designer.

@@ Line 260: / Line 260: @@
 * Replace the webkit <i>src\3rdparty\webkit\Source\JavaScriptCore\wtf\hashset.h</i> file with this [https://bitbucket.org/Vertexwahn/bluego/src/56dbe84212222ec6954d8d327a5e443106bcc447/deploy/BlueGo0.0.4/qt4.8.3vs2012patch/HashSet.h?at=default file]
 * For VS2013, replace the MathExtras.h file [http://code.qt.io/cgit/qt/qt.git/commit/src/3rdparty/webkit/Source/JavaScriptCore/wtf/MathExtras.h?id=b05d05fd9ce2aeedfaf805a7ed9007a93c902bc9]
-* For VS2015, apply the patch https://fami.codefreak.ru/mirrors/qt/unofficial_builds/qt4.8.7-msvc2015/02-fix_build_with_msvc2015-45e8f4ee.diff
+* For VS2015, use the 4.8.7 source [http://download.qt.io/official_releases/qt/4.8/4.8.7/] and apply the patch [https://fami.codefreak.ru/mirrors/qt/unofficial_builds/qt4.8.7-msvc2015/02-fix_build_with_msvc2015-45e8f4ee.diff]
 * Launch the msvc2012 command prompt <!-- (MSVC12->Tools->Visual Studio 2012 CommandPrompt) (or: launch cmd.exe and run <code>vcvars32.bat</code>) -->
 ** 32-bit build: Start menu -> MSVC12->Visual Studio Tools -> "VS2012 x86 Command Prompt"