Difference between revisions of "Documentation/Nightly/Developers/Build Instructions"

From Slicer Wiki
Jump to: navigation, search
(Added install image)
(Moved to readthedocs)
Tags: 2017 source edit, Replaced
 
(25 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<noinclude>{{documentation/versioncheck}}</noinclude>
+
{{documentation/banner
{{:{{FULLPAGENAME}}/Prerequisites}}
+
| text = [https://slicer.readthedocs.io/en/latest/developer_guide/build_instructions/index.html This page has been moved to read-the-docs.]
 
+
| background-color = 8FBC8F }}
<br><br><br><br>
 
 
 
{{:{{FULLPAGENAME}}/CheckoutSourceCode}}
 
 
 
<br><br><br><br>
 
 
 
{{:{{FULLPAGENAME}}/Configure}}
 
 
 
<br><br><br><br>
 
 
 
{{:{{FULLPAGENAME}}/Compile}}
 
 
 
<br><br><br><br>
 
 
 
== RUN Slicer ==
 
 
 
{|width = "100%"
 
! width="50%" style="border-bottom: 1px solid darkgrey;font-size: 75%;"| Linux or MacOSX
 
! width="50%" style="border-bottom: 1px solid darkgrey;font-size: 75%;"| Windows
 
|-
 
| valign="top" |
 
Start a terminal.
 
{{pre2|scroll|
 
$ Slicer-SuperBuild/Slicer-build/Slicer}}
 
| valign="top" |
 
Start Windows Explorer. [http://www.wikihow.com/Open-Windows-Explorer Need help?]
 
<br><br>
 
Run <code>Slicer-SuperBuild/Slicer-build/Slicer.exe</code>
 
|}
 
 
 
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
 
 
 
 
 
<br><br><br><br>
 
 
 
== PACKAGE Slicer ==
 
 
 
{|width = "100%"
 
! width="50%" style="border-bottom: 1px solid darkgrey;font-size: 75%;"| Linux or MacOSX (Makefile)
 
! width="50%" style="border-bottom: 1px solid darkgrey;font-size: 75%;"| Windows (Visual Studio)
 
|-
 
| valign="top" |
 
Start a terminal.
 
{{pre2|scroll|
 
$ cd ~/Projects/Slicer-SuperBuild
 
$ cd Slicer-build
 
 
 
$ make package}}
 
| valign="top" |
 
Start Windows Explorer. [http://www.wikihow.com/Open-Windows-Explorer Need help?]
 
<ol start="1" style="list-style-type: decimal;">
 
<li>Open <code>Slicer-SuperBuild\Slicer-build\Slicer.sln</code> in Visual Studio</li>
 
<li>Select '''Release''' build configuration.</li>
 
<li>In the Solution Explorer, right click on '''PACKAGE''' project and then select '''Build'''</li>
 
</ol>
 
 
 
|}
 
 
 
<!--
 
== DEBUG Slicer ==
 
 
 
To be able to debug Slicer application, you are expected to build it with Debug symbols in a clean directory.
 
 
 
{|width = "100%"
 
! width="50%" style="border-bottom: 1px solid darkgrey;font-size: 75%;"| Linux or MacOSX
 
! width="50%" style="border-bottom: 1px solid darkgrey;font-size: 75%;"| Windows (Visual Studio)
 
|-
 
| valign="top" |
 
Configure Slicer using <code>-DCMAKE_BUILD_TYPE:STRING=Debug</code>
 
| valign="top" |
 
Selecting <code>Debug</code> configuration in Visual Studio.
 
|}
 
 
 
{|width = "100%"
 
! width="50%" style="border-bottom: 1px solid darkgrey;font-size: 75%;"| Linux or MacOSX
 
! width="50%" style="border-bottom: 1px solid darkgrey;font-size: 75%;"| Windows (Visual Studio)
 
|-
 
| valign="top" |
 
<br>
 
{{wip}} TBD
 
<br>
 
| valign="top" |
 
<ol start="1" style="list-style-type: decimal;">
 
<li>Press "Win-R," type "cmd" and press "Enter" to open a Command Prompt session.</li>
 
<li>
 
  <p>Start Visual Studio with Slicer environment:</p>
 
  <pre>&gt; cd \path\to\Slicer-SuperBuild\Slicer-build
 
&gt; Slicer.exe --VisualStudio Slicer.sln</pre>
 
</li>
 
</ol>
 
|}
 
 
 
<br><br><br><br>
 
-->
 
 
 
== Common errors ==
 
 
 
=== CMake complains during configuration ===
 
CMake may not directly show what's wrong; try to look for log files of the form BUILD/CMakeFiles/*.log (where BUILD is your build directory) to glean further information.
 
 
 
=== A tool returned an error code from "Generating vtksysProcessFwd9xEnc.c" ===
 
  The application has failed to start because its side-by-side configuration is incorrect.
 
Please see the application event log or use the command-line sxstrace.exe tool for more detail.
 
Project : error PRJ0019: A tool returned an error code from "Generating
 
vtksysProcessFwd9xEnc.c"
 
Install [[Documentation/{{documentation/version}}/Developers/Build_Instructions/Prerequisites#Windows|SP1 of Visual Studio]]
 
 
 
=== 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/Slicer-SuperBuild-Debug/LibArchive-install/lib/libarchive.so: undefined reference to `SHA256_Update'
 
/home/benjaminlong/work/slicer/Slicer-SuperBuild-Debug/LibArchive-install/lib/libarchive.so: undefined reference to `SHA256_Final'
 
/home/benjaminlong/work/slicer/Slicer-SuperBuild-Debug/LibArchive-install/lib/libarchive.so: undefined reference to `SHA256_Init'
 
/home/benjaminlong/work/slicer/Slicer-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
 
 
 
<del>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</del>.
 
 
 
This issue has been fixed by commit [http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=4fbdce2b 4fbdce2b] included in CMake >= 2.8.8. Download CMake version recommended in the [[Documentation/{{documentation/version}}/Developers/Build_Instructions#Windows|Prequisites]]
 
 
 
=== 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]]
 
 
 
=== ld: framework not found QtWebKit ===
 
 
 
<pre>
 
[...]
 
Linking CXX shared library libPythonQt.dylib
 
ld: framework not found QtWebKit
 
clang: error: linker command failed with exit code 1 (use -v to see invocation)
 
make[8]: *** [libPythonQt.dylib] Error 1
 
[...]
 
</pre>
 
 
 
See Slicer issue [http://na-mic.org/Mantis/view.php?id=2860 #2860]
 
 
 
Workaround:
 
* See http://public.kitware.com/Bug/view.php?id=13765#c31824
 
 
 
Solution:
 
* Use a [http://www.cmake.org/files/dev/?C=M;O=D recent nightly build of CMake]. It includes patch [http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=cc676c3a cc676c3a]. Note also that the coming version of CMake 2.8.11 will work as expected.
 
 
 
=== On MacOSX 10.8, CMake hangs forever ===
 
 
 
Issue: http://www.na-mic.org/Bug/view.php?id=2957
 
 
 
Solution: Use CMake build >= 2.8.10.20130220-g53b279. See http://www.cmake.org/files/dev/cmake-2.8.10.20130220-g53b279-Darwin-universal.tar.gz
 
 
 
Details:
 
 
 
CMake folks (Thanks Brad King :)) fixed an issue that was preventing the most recent nightly from being used to successfully compile Slicer. The fix has been tested and is known to work. Tomorrow nightly build of CMake and by extension the coming release of CMake 2.8.11 will work.
 
 
 
If you are curious about the details, check the commit message:
 
 
 
http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=1df09e57 [^]
 
 
 
The associated CMake test have also been updated:
 
 
 
http://cmake.org/gitweb?p=cmake.git;a=commitdiff;h=bff3d9ce [^]
 
 
 
<br><br><br><br>
 
 
 
=== svn: E175002: Unable to connect to a repository at URL XXX ===
 
 
 
Issue: Cisco AnyConnect is installed with the "Web Security" option checked (default), which blocks Subversion checkouts even when inactive!
 
 
 
Solution:  Uninstall and reinstall Cisco AnyConnect, deselecting the "Web Security" feature during install
 
 
 
[[File:CiscoAnyConnectInstallOptions.png]]
 
 
 
==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 Slicer
 
mkdir Slicer-SuperBuild-Debug
 
cd Slicer-SuperBuild-Debug
 
cmake ../Slicer
 
make -j5
 
 
# runtime dependency:
 
sudo aptitude install python-tk
 

Latest revision as of 19:03, 6 August 2020

Home < Documentation < Nightly < Developers < Build Instructions