Difference between revisions of "Documentation/4.0/Developers/Build Instructions/Prerequisites"

From Slicer Wiki
Jump to: navigation, search
(Prepend documentation/versioncheck template. See http://na-mic.org/Mantis/view.php?id=2887)
 
(17 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
<noinclude>{{documentation/versioncheck}}</noinclude>
 
__TOC__
 
__TOC__
  
Line 5: Line 6:
  
 
= Required tools and libraries =  
 
= Required tools and libraries =  
 +
<br>
 +
{{mbox
 +
| type = protection
 +
| text = Qt libraries are '''required'''. Consider reading [[Documentation/{{documentation/version}}/Developers/Build_Instructions/Prerequisites/Qt|Qt requirements]].
 +
| image= [[{{tool|logo|qt}}|x40px]]
 +
}}
 +
<br>
  
 
== Linux  ==
 
== Linux  ==
Line 17: Line 25:
 
* <del>libX11-devel (libX11-dev  on Ubuntu 7.04)</del>
 
* <del>libX11-devel (libX11-dev  on Ubuntu 7.04)</del>
  
=== Debian Squeeze ===
+
=== Debian squeeze ===
 +
sudo apt-get install gcc libX11-dev libXt-dev libgl1-mesa-dev libosmesa6-dev libglu1-mesa-dev git <del>cmake</del> <del>cmake-curses-gui</del> <del>libqt4-dev</del> subversion make g++
 +
* Debian squeeze has cmake 2.8.2 and Qt 4.6.3.  You will need to install newer versions of these packages.
 +
 
 +
=== Debian testing (wheezy) ===
 
  sudo apt-get install gcc libX11-dev libXt-dev libgl1-mesa-dev libosmesa6-dev libglu1-mesa-dev git cmake cmake-curses-gui libqt4-dev subversion make g++
 
  sudo apt-get install gcc libX11-dev libXt-dev libgl1-mesa-dev libosmesa6-dev libglu1-mesa-dev git cmake cmake-curses-gui libqt4-dev subversion make g++
  
Line 39: Line 51:
 
*[[{{tool|logo|git}}|x16px]] [{{tool|download|git}} Git] >= 1.6.5
 
*[[{{tool|logo|git}}|x16px]] [{{tool|download|git}} Git] >= 1.6.5
 
* XCode (for the SDK libs)
 
* XCode (for the SDK libs)
 +
* XQuartz >= 2.7.2 for Mountain Lion
  
 
== Windows ==
 
== Windows ==
*[[{{tool|logo|cmake}}|x16px]]  [{{tool|download|cmake}}  CMake] >= 2.8.4
+
*[[{{tool|logo|cmake}}|x16px]]  [{{tool|download|cmake}}  CMake] >= 2.8.8
** '''Windows7''': Custom build of [https://qshare.queensu.ca/Users01/lasso/public/cmake-2.8.7.12957-win32-x86.exe CMake 2.8.7] by Andras Lasso. Waiting CMake 2.8.8 is released, this solves issue [http://cmake.org/Bug/view.php?id=12957 #12957]. Consider also reading [[Documentation/{{documentation/version}}/Developers/Build_Instructions#A_tool_returned_an_error_code_from_.22Performing_configure_step_for_....22|this page]] for further details.
 
 
*[[{{tool|logo|git}}|x16px]]  [{{tool|download|git}}  Git] >= 1.6.5.  
 
*[[{{tool|logo|git}}|x16px]]  [{{tool|download|git}}  Git] >= 1.6.5.  
** [https://code.google.com/p/msysgit/downloads/list?can=3 ''msysGit-fullinstall''] recommended.  
+
** [https://code.google.com/p/msysgit/downloads/list?can=3 ''Git-1.7.9-preview20120201.exe''] recommended.  
 
** Use of [http://code.google.com/p/tortoisegit/ TortoiseGit] is optional.
 
** Use of [http://code.google.com/p/tortoisegit/ TortoiseGit] is optional.
 
** {{note}}For convenience, you could update the PATH variable so that ''git'' can be automatically discovered when configuring Slicer. If not, you will have to specify the GIT_EXECUTABLE at configure time.
 
** {{note}}For convenience, you could update the PATH variable so that ''git'' can be automatically discovered when configuring Slicer. If not, you will have to specify the GIT_EXECUTABLE at configure time.
Line 50: Line 62:
 
* IDE
 
* IDE
 
** '''Tested/Recommended''': [https://www.microsoft.com/visualstudio/en-us/products/2008-editions Microsoft Visual Studio 9 2008] (Any edition).
 
** '''Tested/Recommended''': [https://www.microsoft.com/visualstudio/en-us/products/2008-editions Microsoft Visual Studio 9 2008] (Any edition).
 +
*** Make sure to install:
 +
**** SP1. Click [http://www.microsoft.com/download/en/details.aspx?id=10986 here] to download SP1 and click [http://massmail.spl.harvard.edu/public-archives/slicer-devel/2012/008206.html here] to understand the motivation.
 
** '''Experimental''': The plan is to support [https://www.microsoft.com/visualstudio/en-us/products/2010-editions Microsoft Visual Studio 2010] (Any edition).
 
** '''Experimental''': The plan is to support [https://www.microsoft.com/visualstudio/en-us/products/2010-editions Microsoft Visual Studio 2010] (Any edition).
 
*** Make sure to install:
 
*** Make sure to install:
 
**** SP1. Click [http://www.microsoft.com/download/en/details.aspx?id=23691 here] to download SP1 and click [http://developer.qt.nokia.com/faq/answer/why_do_all_qt_4.7_applications_crash_when_using_windows_7_x64_w_vs_2010 here] to understand the motivation.
 
**** SP1. Click [http://www.microsoft.com/download/en/details.aspx?id=23691 here] to download SP1 and click [http://developer.qt.nokia.com/faq/answer/why_do_all_qt_4.7_applications_crash_when_using_windows_7_x64_w_vs_2010 here] to understand the motivation.
 
**** SP1 Compiler update. Click [https://www.microsoft.com/download/en/details.aspx?id=4422 here] to download and [http://slicer-devel.65872.n3.nabble.com/Windows-7-64Bits-Slicer-4-Build-with-VC-2010-problem-tt3730524.html#a3731661 here] to understand the motivation.
 
**** SP1 Compiler update. Click [https://www.microsoft.com/download/en/details.aspx?id=4422 here] to download and [http://slicer-devel.65872.n3.nabble.com/Windows-7-64Bits-Slicer-4-Build-with-VC-2010-problem-tt3730524.html#a3731661 here] to understand the motivation.
*** Optional: "Microsoft Visual C++ 2010 SP1 Redistributable Package". Click [http://www.microsoft.com/download/en/details.aspx?id=13523 here for x64] download, or [http://www.microsoft.com/download/en/details.aspx?id=13523 here for x86] download.  [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=29 x86 (32bit) for VS 2008]
+
<!-- JC: This links shouldn't be here: 1) Since this the developer section, it's assumed Visual Studio is installed. 2) The Dll are distributed within Slicer package -->
 +
<!-- *** Optional: "Microsoft Visual C++ 2010 SP1 Redistributable Package". Click [http://www.microsoft.com/download/en/details.aspx?id=13523 here for x64] download, or [http://www.microsoft.com/download/en/details.aspx?id=13523 here for x86] download.  [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=29 x86 (32bit) for VS 2008] -->
 
** '''Un-tested''': Cygwin suite (building with cygwin gcc not supported, but the cygwin shell environment can be used to run git, svn, etc).
 
** '''Un-tested''': Cygwin suite (building with cygwin gcc not supported, but the cygwin shell environment can be used to run git, svn, etc).
 
= Qt library requirements =
 
 
* Use one of the links provided in the table below to download the source code or binary of Qt. If required, you can download the source code and compile Qt using the instructions in [[Documentation/{{documentation/version}}/Developers/Build_Instructions/Prerequisites/Build_Instructions_for_QT|Slicer4: Build Instructions for 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"|Tiger
 
!colspan="1"|Leopard, SnowLeopard
 
!colspan="2"|VS2008
 
!colspan="2"|VS2010
 
|- bgcolor="#FFFFCC"
 
!|32bits
 
!|64bits
 
!|32bits
 
!|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]
 
|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="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://get.qt.nokia.com/qtsdk/Qt_SDK_Lin32_offline_v1_1_4_en.run SDK-1.1.4]
 
|align="center" colspan="1"| [http://get.qt.nokia.com/qtsdk/Qt_SDK_Lin64_offline_v1_1_4_en.run SDK-1.1.4]
 
|align="center" colspan="1"| [http://get.qt.nokia.com/qt/source/qt-mac-carbon-opensource-4.7.0.dmg carbon_4.7.0]
 
|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"| -
 
|}
 
 
===Qt version specific issues ===
 
Qt 4.6 on mac: hard to compile (tbd: be more specific)
 
 
Qt 4.6.x on windows (and possibly in linux/mac): No image base64 support in QLabel/QTooltips (work around exists though)
 
 
Qt 4.7 on mac: click outside of popup (http://na-mic.org/Mantis/view.php?id=1241) Fixed in Qt 4.8 ?
 
 
Qt 4.7.3 in mac: http://na-mic.org/Mantis/view.php?id=1388 (fixed in Qt 4.7.4)
 
 
Qt 4.8 does not work with PythonQt in slicer4 - suggested version is 4.7.4
 
 
=== 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]
 

Latest revision as of 07:36, 14 June 2013

Home < Documentation < 4.0 < Developers < Build Instructions < Prerequisites


For the latest Slicer documentation, visit the read-the-docs.



Please check that the following tools are installed on your machine.

Required tools and libraries



Linux

Ubuntu

  • Ubuntu users, just type the following line in a terminal
sudo apt-get install subversion gcc g++ libX11-dev libXt-dev libgl1-mesa-dev libosmesa6-dev libglu1-mesa-dev git cmake cmake-curses-gui
  • libXt-devel (libXt-dev)
  • opengl/mesa (libgl1-mesa-dev and libosmesa6-dev)
  • glu (libglu1-mesa-dev)
  • libX11-devel (libX11-dev on Ubuntu 7.04)

Debian squeeze

sudo apt-get install gcc libX11-dev libXt-dev libgl1-mesa-dev libosmesa6-dev libglu1-mesa-dev git cmake cmake-curses-gui libqt4-dev subversion make g++
  • Debian squeeze has cmake 2.8.2 and Qt 4.6.3. You will need to install newer versions of these packages.

Debian testing (wheezy)

sudo apt-get install gcc libX11-dev libXt-dev libgl1-mesa-dev libosmesa6-dev libglu1-mesa-dev git cmake cmake-curses-gui libqt4-dev subversion make g++

CentOS

  • CentOS user type:
yum install gcc-c++ libX11-devel libXt-devel make libXext-devel

Generic (need to confirm)

  • Logo CMake-PNG.png CMake >= 2.8.4
  • Git-logo.png Git >= 1.6.5
  • An easy way to get all of the packages needed to build Slicer is to install all of the packages needed to build paraview (another vtk-based program)
    • sudo apt-get install aptitude
    • sudo aptitude build-dep paraview
  • gcc
  • gcc-c++
  • libX11

Mac

  • Mac Os X >= 10.5 (Leopard)
  • Logo CMake-PNG.png CMake >= 2.8.6
  • Git-logo.png Git >= 1.6.5
  • XCode (for the SDK libs)
  • XQuartz >= 2.7.2 for Mountain Lion

Windows

  • Logo CMake-PNG.png CMake >= 2.8.8
  • Git-logo.png Git >= 1.6.5.
    • Git-1.7.9-preview20120201.exe recommended.
    • Use of TortoiseGit is optional.
    • Note For convenience, you could update the PATH variable so that git can be automatically discovered when configuring Slicer. If not, you will have to specify the GIT_EXECUTABLE at configure time.
  • SVN (e.g. SlikSvn or cygwin's svn client)
  • IDE
    • Tested/Recommended: Microsoft Visual Studio 9 2008 (Any edition).
      • Make sure to install:
        • SP1. Click here to download SP1 and click here to understand the motivation.
    • Experimental: The plan is to support Microsoft Visual Studio 2010 (Any edition).
      • Make sure to install:
        • SP1. Click here to download SP1 and click here to understand the motivation.
        • SP1 Compiler update. Click here to download and here to understand the motivation.
    • Un-tested: Cygwin suite (building with cygwin gcc not supported, but the cygwin shell environment can be used to run git, svn, etc).