|
Tags: 2017 source edit, Replaced |
(218 intermediate revisions by 21 users not shown) |
Line 1: |
Line 1: |
− | __TOC__
| + | {{documentation/banner |
− | | + | | text = [https://slicer.readthedocs.io/en/latest/developer_guide/build_instructions/index.html This page has been moved to read-the-docs.] |
− | == PREREQUISITES ==
| + | | background-color = 8FBC8F }} |
− | <br>
| |
− | | |
− | Please check that the following tools are installed on your machine.
| |
− | | |
− | <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>
| |
− | | |
− | {{mbox
| |
− | | type = protection
| |
− | | text = CMake is '''required'''. | |
− | | image= [[{{tool|logo|cmake}}|x40px]]
| |
− | }}
| |
− | <br>
| |
− | | |
− | {{mbox
| |
− | | type = protection
| |
− | | text = Git is '''required'''.
| |
− | | image= [[{{tool|logo|git}}|x40px]]
| |
− | }}
| |
− | <br>
| |
− | | |
− | {{mbox
| |
− | | type = protection
| |
− | | text = SVN is '''required'''.
| |
− | | image= [[{{tool|logo|svn}}|x40px]]
| |
− | }}
| |
− | | |
− | <br>
| |
− | | |
− | Consider reading platform specific requirements listed below.
| |
− | | |
− | === Linux ===
| |
− | * [{{tool|download|cmake}} CMake] >= 2.8.9
| |
− | * [{{tool|download|git}} Git] >= 1.6.5
| |
− | * Qt 4.7.4 or 4.8.4. See details [[Documentation/{{documentation/version}}/Developers/Build_Instructions/Prerequisites/Qt#Linux|here]]
| |
− | | |
− | ==== Ubuntu / Debian ====
| |
− | *Ubuntu, Debian squeeze, Debian testing (wheezy) users, just type the following line in a terminal
| |
− | sudo apt-get install subversion git-core
| |
− | sudo apt-get install make gcc g++ libX11-dev libXt-dev libgl1-mesa-dev libosmesa6-dev libglu1-mesa-dev libfontconfig-dev libxrender-dev
| |
− | | |
− | mkdir ~/Support & cd Support # This is where we will download and install required software
| |
− | | |
− | wget http://www.cmake.org/files/v2.8/cmake-2.8.10.2-Linux-i386.tar.gz
| |
− | tar -xzvf cmake-2.8.10.2-Linux-i386.tar.gz
| |
− | <!--
| |
− | * Debian squeeze has cmake 2.8.2 and Qt 4.6.3. You will need to install newer versions of these packages.
| |
− | * Ubuntu 10.04 has cmake 2.8.0
| |
− | -->
| |
− | | |
− | ==== CentOS ====
| |
− | *CentOS user type:
| |
− | yum install make gcc-c++ libX11-devel libXt-devel libXext-devel libGLU-devel mesa-libOSMesa-devel mesa-libGL-devel mesa-libGLU-devel ncurses
| |
− | | |
− | <!--
| |
− | Todo: This will have to be added in FAQ: Troubleshoot section
| |
− | ''glx-utils'' provides ''glxgears'' that can be used to test rendering
| |
− | -->
| |
− | | |
− | === MacOSX ===
| |
− | * Mac Os X >= 10.5 (Leopard)
| |
− | * [{{tool|download|cmake}} CMake] >= 2.8.9
| |
− | ** For Mac Os X >= 10.8 ([http://en.wikipedia.org/wiki/OS_X_Mountain_Lion Mountain Lion]) and/or recent XCode >= 4.5.X - [{{tool|download|cmake}} CMake] >= 2.8.11 is required. Waiting for the official release, get exactly version 20130121-g92bd8 [http://www.cmake.org/files/dev/cmake-2.8.10.20130121-g92bd8-Darwin-universal.tar.gz here] (or version >= 2.8.10.20130220 [http://www.cmake.org/files/dev/?C=M;O=D here]). For explanation, see [[Documentation/{{documentation/version}}/Developers/Build_Instructions#ld:_framework_not_found_QtWebKit|here]] and [[Documentation/{{documentation/version}}/Developers/Build_Instructions#On_MacOSX_10.8.2C_CMake_hangs_forever|here]]
| |
− |
| |
− | $ curl -O http://www.cmake.org/files/dev/cmake-2.8.10.20130121-g92bd8-Darwin-universal.tar.gz
| |
− | $ tar -xzvf cmake-2.8.10.20130121-g92bd8-Darwin-universal.tar.gz --strip-components=1
| |
− | $ mv CMake\ 2.8-10.app/ CMake\ 2.8-10.20130121-g92bd8.app
| |
− | | |
− | $ CMake\ 2.8-10.20130121-g92bd8.app/Contents/bin/cmake --version
| |
− | cmake version 2.8.10.20130121-g92bd8
| |
− | | |
− | * [{{tool|download|git}} Git] >= 1.6.5
| |
− | <!--
| |
− | *[[{{tool|logo|cmake}}|x16px]] [{{tool|download|cmake}} CMake] >= 2.8.9
| |
− | *[[{{tool|logo|git}}|x16px]] [{{tool|download|git}} Git] >= 1.6.5
| |
− | -->
| |
− | * XCode (for the SDK libs)
| |
− | * Qt 4.7.4 or 4.8.4. See details [[Documentation/{{documentation/version}}/Developers/Build_Instructions/Prerequisites/Qt#Mac|here]]
| |
− | <!--
| |
− | ** Newer Xcode versions (e.g. 4.3.2) use clang as the default compiler and '''clang is not compatible with ITK version 3'''. You should use ITK version 4 with recent versions of Xcode.
| |
− | ** Xcode with gcc should ork with either version of ITK.
| |
− | ** OS X Mountain Lion: In Xcode 4.5 you now need to install command line tools (no longer included by default). Install within Xcode under the Xcode->Preferences->Downloads tab (otherwise git svn will give errors). Then you will need to install XQuartz (http://xquartz.macosforge.org) to get X11 (no longer a default in OS X).
| |
− | -->
| |
− | | |
− | === Windows ===
| |
− | * [{{tool|download|cmake}} CMake] >= 2.8.9
| |
− | * [{{tool|download|git}} Git] >= 1.6.5
| |
− | * Qt 4.7.4 or 4.8.4. See details [[Documentation/{{documentation/version}}/Developers/Build_Instructions/Prerequisites/Qt#Windows|here]]
| |
− | <!--
| |
− | *[[{{tool|logo|cmake}}|x16px]] [{{tool|download|cmake}} CMake] >= 2.8.9
| |
− | *[[{{tool|logo|git}}|x16px]] [{{tool|download|git}} Git] >= 1.6.5.
| |
− | --> | |
− | * [https://code.google.com/p/msysgit/downloads/list?can=3 ''Git-X.X.X-preview2013XXXX.exe''] recommended.
| |
− | <!--
| |
− | ** 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.
| |
− | * [http://www.sliksvn.com/en/download SlikSvn] <!-- or [http://www.cygwin.com cygwin's svn client]-->
| |
− | * IDE
| |
− | ** '''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). {{note}} NOTE THAT EXPERIMENTAL MEANS THIS DOESN'T YET WORK :)
| |
− | *** 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 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.
| |
− | <!-- 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).
| |
− | * NSIS (optional): Needed if packaging Slicer - Click [http://nsis.sourceforge.net/Download here] to download.
| |