Documentation/4.1/Developers/Build Instructions - Revision history

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

2013-06-14T07:27:46Z

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

Inorton: /* Platform Notes */

2012-07-05T17:20:12Z

Platform Notes

Finetjul: /* Common errors */

2012-06-21T05:43:31Z

Common errors

JChris.FillionR at 04:05, 12 June 2012

2012-06-12T04:05:21Z

JChris.FillionR at 02:12, 5 June 2012

2012-06-05T02:12:47Z

JChris.FillionR at 02:12, 5 June 2012

2012-06-05T02:12:22Z

JChris.FillionR at 02:09, 5 June 2012

2012-06-05T02:09:45Z

Pieper: /* Unix-like */

2012-05-11T15:21:57Z

Unix-like

Pieper: /* Using svn */

2012-05-11T15:21:19Z

Using svn

JChris.FillionR: 4.0 -> 4.1

2012-04-12T05:23:27Z

4.0 -> 4.1

New page

{{mbox
| text = The goal of the [[{{tool|logo|cmake}}|x16px]] [{{tool|homepage|cmake}} CMake] '''Super-Build''' is to provide a cross-platform build system that allows developers to quickly install and configure the multiple packages. Where [[Slicer3:Build_Instructions|Slicer3's build system]] relied on a [[Slicer3:getbuildtest|custom build script called getbuildtest]], new features added to [{{tool|homepage|cmake}} CMake], partly driven by slicer's requirements, allow porting of the scripts to rely more on native [{{tool|homepage|cmake}} CMake] functionality with the benefit that build script is more modular and general purpose.
}}
 

== PREREQUISITES ==
 
<center>To avoid [[#Common_errors|'''Common errors''']], we '''STRONGLY''' recommend to read the [[Documentation/{{documentation/version}}/Developers/Build Instructions/Prerequisites|Prerequisites]] section.</center>

 

== CHECKOUT slicer source files ==

Two options: <code>svn</code> or <code>git-svn</code>

To make '''review''' and '''integration''' of your welcome contributions, we recommends the use of <code>git-svn</code>

 
{{ambox
| type = warning
| text = While it is not enforced, we strongly recommend you to '''AVOID''' the use of '''SPACES''' for both the <code>source directory</code> and the <code>build directory</code>. We mean it.
}}
 

Note that even if you use <code>svn</code> to check out Slicer source code, you will need to have <code>git</code> installed to checkout and build other libraries. '''YES''', you need to install the things listed in the [[Documentation/{{documentation/version}}/Developers/Build Instructions/Prerequisites|prerequisites]] !.

=== Using <code>git-svn</code> ===

git clone git://github.com/Slicer/Slicer.git
cd Slicer
git svn init http://svn.slicer.org/Slicer4/trunk
git update-ref refs/remotes/git-svn refs/remotes/origin/master
git checkout master
git svn rebase

Consider reading the following page: [[Slicer:git-svn|Slicer guide to <code>git-svn</code>]]

=== Using <code>svn</code> ===

cd MyProjects
svn co [http://svn.slicer.org/Slicer4/trunk http://svn.slicer.org/Slicer4/trunk] Slicer4

 

== CONFIGURE and generate Slicer solution files ==
You can configure and generate Slicer solution files using either <code>ccmake</code> or <code>cmake-gui</code>.
=== Per-platform instructions===
==== Windows ====
*'''Recommended''': <code>cmake-gui</code>
** Configure using default options.
* '''Remarks''':
#If you downloaded the Qt binary then <code>qmake</code> will be detected and all paths will be set automatically.
#If you built your own Qt (e.g. in Debug mode for use with the designer) set the <code>QT_QMAKE_EXECUTABLE</code> in <code>cmake-gui</code>.<code>QT_QMAKE_EXECUTABLE</code> should be set to the path of the qmake.exe file, which is inside the bin directory (for example, <code>/path/to/qt-everywhere-opensource-build-4.7.4/bin/qmake.exe</code>).
#Windows doesn't support path longer than 260 characters, please make sure that the total path name of your <code>Slicer-build</code> directory is no longer than 50 characters ( for example <code>c:\work\Slicer\Slicer-Superbuild</code> (32 characters) is fine)

==== Unix-like ====
*'''Recommended''': <code>ccmake</code>
** Configure using the following commands. By default '''CMAKE_BUILD_TYPE''' is set to '''Debug'''.
<pre>
mkdir Slicer4-SuperBuild-Debug
cd Slicer4-SuperBuild-Debug
ccmake -DQT_QMAKE_EXECUTABLE:FILEPATH=/path/to/QtSDK-1.2/Desktop/Qt/474/gcc/bin/qmake ../Slicer4
</pre>
* '''Remarks''':
# Using top-level directory name like <code>Slicer-Superbuild-Release</code> or <code>Slicer-Superbuild-Debug</code> is recommended.

=== General information ===

Two projects are generated by either <code>cmake</code>, <code>ccmake</code> or <code>cmake-gui</code>.

One of them is in the top-level bin directory <code>Slicer4-Superbuild</code> and the other one is in the subdirectory <code>Slicer-build</code>:

<pre>Slicer4-Superbuild/Slicer-build</pre>

# The first project in <code>Slicer4-Superbuild</code> manages all the external dependencies of Slicer (VTK, ITK, Python, ...). To build Slicer for the first time, run make (or build the solution file in Visual Studio) in <code>Slicer4-Superbuild</code>, which will update and build the external libraries and if successful will then build the subproject Slicer-build. 
# The second project in <code>Slicer4-Superbuild/Slicer-build</code> is the "traditional" build directory of Slicer. After local changes in Slicer (or after an svn update on the source directory of Slicer), only running make (or building the solution file in Visual Studio) in <code>Slicer4-Superbuild/Slicer-build</code> is necessary (the external libraries are considered built and up to date). 
#'''Warning''': An important amount of disk space is required to compile Slicer in Debug (>10GB on Windows)

=== Workaround firewall blocking git protocol ===
* Some firewall will be blocking the git protocol, a possible workaround is to configure Slicer disabling the option <code>Slicer_USE_GIT_PROTOCOL</code>. Then http protocol will be used instead. Consider also reading https://github.com/commontk/CTK/issues/33

=== Notes for advanced users ===
* By default, if CMake finds Java on your machine, it automatically builds Java CLIs. If you don't want any Java in your Slicer (or if you don't want to install Java on your Mac Os X), you can pass <code>-DCMAKE_DISABLE_FIND_PACKAGE_Java:BOOL=TRUE</code> when configuring Slicer.
* Same applies for OpenSSL: <code>CMAKE_DISABLE_FIND_PACKAGE_OpenSSL:BOOL=TRUE</code> can be passed when building Slicer for packaging.

 

== BUILD Slicer4 ==
After configuration, start the build process in the <code>Slicer4-SuperBuild</code> directory

=== Per-platform instructions===
==== Windows ====
* Open <code>Slicer4-SuperBuild\Slicer.sln</code> in Visual Studio
* Select your build configuration. Usually '''Release''' of '''Debug'''
* Build the <code>ALL_BUILD</code> project.

* If you make local changes to Slicer4, open the solution file located in the directory <code>Slicer4-SuperBuild/Slicer-build</code> instead. You should then be able to either build all projects or just a specific one.

==== Unix-like ====

cd ~/Projects/Slicer4-SuperBuild
make -j<NUMBEROFCORES>

 

== RUN Slicer ==
=== Per-platform instructions===
==== Windows ====

Run <code>Slicer4-SuperBuild/Slicer-build/Slicer.exe</code>

==== Unix-like ====

Run <code>Slicer4-SuperBuild/Slicer-build/Slicer</code>

 

== DEBUG Slicer ==
=== Per-platform instructions===
==== Windows ====
* Make sure you build Slicer using the '''Debug''' configuration.
* Open a windows terminal <code>cmd.exe</code>
* Execute the following command:
cd \path\to\Slicer4-SuperBuild\Slicer-build
Slicer.exe --VisualStudio Slicer.sln

==== Unix-like ====
NA

 

== Common errors ==
=== error: ‘class QList<QString>’ has no member named ‘reserve’ ===
/nfs/Users/blowekamp/QtSDK/Desktop/Qt/474/gcc/include/QtCore/qdatastream.h: In function ‘QDataStream& operator>>(QDataStream&, QList<T>&) [with T = QString]’:
/nfs/Users/blowekamp/QtSDK/Desktop/Qt/474/gcc/include/QtCore/qstringlist.h:247: instantiated from here
/nfs/Users/blowekamp/QtSDK/Desktop/Qt/474/gcc/include/QtCore/qdatastream.h:246: error: ‘class QList<QString>’ has no member named ‘reserve’
You have multiple Qt versions installed on your machine. Try removing the Qt version installed on the system.

=== libarchive.so: undefined reference to `SHA256_Update' ===

Linking CXX executable ../../../../../bin/MRMLLogicCxxTests
/home/benjaminlong/work/slicer/Slicer4-Superbuild-Debug/LibArchive-install/lib/libarchive.so: undefined reference to `SHA256_Update'
/home/benjaminlong/work/slicer/Slicer4-Superbuild-Debug/LibArchive-install/lib/libarchive.so: undefined reference to `SHA256_Final'
/home/benjaminlong/work/slicer/Slicer4-Superbuild-Debug/LibArchive-install/lib/libarchive.so: undefined reference to `SHA256_Init'
/home/benjaminlong/work/slicer/Slicer4-Superbuild-Debug/LibArchive-install/lib/libarchive.so: undefined reference to `MD5_Init'

Solution:
cd Slicer-superbuild
rm -rf LibArchive-*
make -j4

Details:
* http://na-mic.org/Mantis/view.php?id=1616
* http://viewvc.slicer.org/viewvc.cgi/Slicer4?view=revision&revision=18923
* http://viewvc.slicer.org/viewvc.cgi/Slicer4?view=revision&revision=18969

=== A tool returned an error code from "Performing configure step for ..." ===

CMake has some problems building complex projects on Windows7. See more details in: http://cmake.org/Bug/view.php?id=12957

A fix has been already identified and soon will be available in an official CMake release (probably 2.8.8). Until then this unofficial version can be used (based on CMake-2.8.7): https://qshare.queensu.ca/Users01/lasso/public/cmake-2.8.7.12957-win32-x86.exe

=== A tool returned an error code from "Performing download step (git clone) for ..." ===

CMake has problems cloning git repositories on Windows7. See more details in http://cmake.org/Bug/view.php?id=12564

If you think the described problem is the same as you have, please add your specific error message to the bug report (the more people report the problem the sooner it will be fixed).

=== No rule to make target `/usr/lib/x86_64-linux-gnu/libGL.so' ===
See http://techtidings.blogspot.com/2012/01/problem-with-libglso-on-64-bit-ubuntu.html

=== X11 Window errors at start time ===
<pre>
X Error: BadWindow (invalid Window parameter) 3
Extension: 137 (Uknown extension)
Minor opcode: 4 (Unknown request)
Resource id: 0x4200199
X Error: BadWindow (invalid Window parameter) 3
Extension: 137 (Uknown extension)
Minor opcode: 4 (Unknown request)
Resource id: 0x42001a6
X Error: BadWindow (invalid Window parameter) 3
Extension: 137 (Uknown extension)
Minor opcode: 4 (Unknown request)
Resource id: 0x42001b3
</pre>

Solution:
* Reinstall Nvidia drivers (that also rewrite the xorg.conf file).

=== error C2061: syntax error : identifier 'ssize_t' ===
<pre>
4>1>Compiling...
4>1>version.c
4>1>c:\chene\winbin64\slicer4\cmcurl\urldata.h(585) : error C2061: syntax error : identifier 'ssize_t'
4>1>c:\chene\winbin64\slicer4\cmcurl\urldata.h(593) : error C2365: 'fread' : redefinition; previous definition was 'function'
4>1> C:\Program Files (x86)\Microsoft Visual Studio 9.0\VC\include\stdio.h(248) : see declaration of 'fread'
4>1>c:\chene\winbin64\slicer4\cmcurl\urldata.h(610) : error C2059: syntax error : '}'
</pre>

Solution:
* See [[#A_tool_returned_an_error_code_from_.22Performing_configure_step_for_....22]]

 

==Platform Notes==

* Linux Ubuntu: if you have odd rendering artifacts, try disabling visual effects (System/Appearance/Visual Effects)
* Windows: If build was OK, but it Slicer doesn't start (gives the error: [bin/Release/SlicerQT-real.exe] exit abnormally - Report the problem.) then one possible root cause is that you have a copy of Python26.dll in your windows system directory (e.g., c:\Windows\System32\python26.dll). The solution is to rename or remove the python dll in the system directory. See more details here: http://www.na-mic.org/Bug/view.php?id=1180

==Quick Build on Debian==
sudo aptitude update
sudo aptitude install subversion git gcc g++ make cmake-curses-gui libqt4-dev
svn co http://svn.slicer.org/Slicer4/trunk Slicer4
mkdir Slicer4-SuperBuild-Debug
cd Slicer4-SuperBuild-Debug
cmake ../Slicer4
make -j5

# runtime dependency:
sudo aptitude install python-tk

← Older revision		Revision as of 07:27, 14 June 2013
Line 1:		Line 1:
		+	<noinclude>{{documentation/versioncheck}}</noinclude>
	== PREREQUISITES ==		== PREREQUISITES ==
	<br>		<br>

@@ Line 5: / Line 5: @@
 <br><br><br><br>
-{{{{FULLPAGENAME}}/CheckoutSourceCode}}
+{{:{{FULLPAGENAME}}/CheckoutSourceCode}}
 <br><br><br><br>
-{{{{FULLPAGENAME}}/Configure}}
+{{:{{FULLPAGENAME}}/Configure}}
 <br><br><br><br>
-{{{{FULLPAGENAME}}/Compile}}
+{{:{{FULLPAGENAME}}/Compile}}
 <br><br><br><br>

← Older revision		Revision as of 02:12, 5 June 2012
Line 1:		Line 1:
−	~~<br>~~
−	~~{{mbox~~
−	\| text = The goal of the [[{{tool\|logo\|cmake}}\|x16px]] [{{tool\|homepage\|cmake}} CMake] '''Super-Build''' is to provide a cross-platform build system that allows developers to quickly install and configure the multiple packages.<br><br>Where [[Slicer3:Build_Instructions\|Slicer3's build system]] relied on a [[Slicer3:getbuildtest\|custom build script called getbuildtest]], new features added to [{{tool\|homepage\|cmake}} CMake], partly driven by slicer's requirements, allow porting of the scripts to rely more on native [{{tool\|homepage\|cmake}} CMake] functionality with the benefit that build script is more modular and general purpose.
−	}}
−	~~<br>~~
−
	== PREREQUISITES ==		== PREREQUISITES ==
	<br>		<br>

@@ Line 15: / Line 15: @@
 <br><br><br><br>
-== CONFIGURE and generate Slicer solution files ==
+{{{{FULLPAGENAME}}/Configure}}
 <br><br><br><br>
-== BUILD Slicer4 ==
+{{{{FULLPAGENAME}}/Compile}}
 <br><br><br><br>

@@ Line 11: / Line 11: @@
 <br><br><br><br>
-== CHECKOUT slicer source files ==
+{{{{FULLPAGENAME}}/CheckoutSourceCode}}
 <br><br><br><br>

@@ Line 128: / Line 128: @@
 * Linux Ubuntu: if you have odd rendering artifacts, try disabling visual effects (System/Appearance/Visual Effects)
 * Windows: If build was OK, but it Slicer doesn't start (gives the error: [bin/Release/SlicerQT-real.exe] exit abnormally - Report the problem.) then one possible root cause is that you have a copy of Python26.dll in your windows system directory (e.g., c:\Windows\System32\python26.dll). The solution is to rename or remove the python dll in the system directory. See more details here: http://www.na-mic.org/Bug/view.php?id=1180
 ==Quick Build on Debian==

@@ Line 44: / Line 44: @@
 == Common errors ==
 === error: ‘class QList<QString>’ has no member named ‘reserve’ ===
   /nfs/Users/blowekamp/QtSDK/Desktop/Qt/474/gcc/include/QtCore/qdatastream.h: In function ‘QDataStream& operator>>(QDataStream&, QList<T>&) [with T = QString]’:

@@ Line 64: / Line 64: @@
 mkdir Slicer4-SuperBuild-Debug
 cd Slicer4-SuperBuild-Debug
-ccmake -DQT_QMAKE_EXECUTABLE:FILEPATH=/path/to/QtSDK-1.2/Desktop/Qt/474/gcc/bin/qmake ../Slicer4
+ccmake -DQT_QMAKE_EXECUTABLE:FILEPATH=/path/to/QtSDK-1.2/Desktop/Qt/474/gcc/bin/qmake ../Slicer
 </pre>
 * '''Remarks''':

@@ Line 41: / Line 41: @@
   cd MyProjects
-  svn co [http://svn.slicer.org/Slicer4/trunk http://svn.slicer.org/Slicer4/trunk] Slicer4
+  svn co [http://svn.slicer.org/Slicer4/trunk http://svn.slicer.org/Slicer4/trunk] Slicer
 <br><br><br><br>