Difference between revisions of "Documentation/4.0/Developers/Build Instructions"
m |
|||
Line 89: | Line 89: | ||
Same as Linux. Use "-arch x86_64" for a 64 bit build on SnowLeopard. | Same as Linux. Use "-arch x86_64" for a 64 bit build on SnowLeopard. | ||
− | == Step1 : Checkout slicer sources using subversion == | + | == Step1: Checkout slicer sources using subversion == |
For example: | For example: | ||
<pre> | <pre> | ||
Line 96: | Line 96: | ||
</pre> | </pre> | ||
− | == Step2 : Configure slicer project using either ccmake or cmake-gui == | + | == Step2: Configure slicer project using either ccmake or cmake-gui == |
The grids displayed below summarizes the available options. | The grids displayed below summarizes the available options. |
Revision as of 20:17, 11 October 2010
Home < Documentation < 4.0 < Developers < Build InstructionsThe build system for Slicer4 is being developed during the second half of 2010. The goal is to provide a cross-platform build system that allows developers to quickly install and configure the multiple packages.
Where Slicer3's build system relied on a custom build script called getbuildtest, new features added to CMake, partly driven by slicer's requirements, allow porting of the scripts to rely more on native CMake functionality with the benefit that build script is more modular and general purpose.
Contents
Prerequisites
- Linux prerequisites (need to confirm)
- gcc
- gcc-c++
- libX11
- libX11-devel (libX11-dev on Ubuntu 7.04)
- libXt-devel (libXt-dev on Ubuntu)
- opengl/mesa (libgl1-mesa-dev on Ubuntu) (and libosmesa6-dev on Ubuntu)
- glu (libglu1-mesa-dev on Ubuntu)
- git version >= 1.6.5
- Download Git
- install git:
sudo apt-get install git
. Ifgit --version
is inferior to 1.6.5, then:sudo dpkg --install git-core_1.6.5-1~bpo50+1_amd64.deb
- Windows prerequisites
- Microsoft Visual Studio 2008
- CMake version >=2.8.2
- SVN
- git version >= 1.6.5. msysgit is recommended. Using TortoiseGit is a plus.
- Download (and if required compile) Qt - Use one of the link provided below:
Linux | Mac | Windows | ||||
---|---|---|---|---|---|---|
Tiger | Leopard, SnowLeopard | |||||
32bits | 64bits | 32bits | 64bits | 32bits | 64bits | |
Qt source link | 4.7 | 4.7 | 4.7 | |||
Qt binary link | 4.7 | 4.7 | 4.7 | 4.7 | 4.7 (vs2008) | - |
- How to build Qt ?
Configure options common to all platform:
Check our different tutorials:
- Build Qt on Windows
- Using the Qt Designer on Windows requires that the Slicer and CTK widget plugins are in the same mode than 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. So for developers, the Debug mode is recommended, this is why we detail the compilation of Qt below.
- Use a windows extracter to unzip the [#Prerequisites|Qt zip archive], don't use cygwin unzip it.
- launch the msvc2008 command prompt (MSVC08->Tools->Visual Studio 2008 CommandPrompt) (or: launch cmd.exe and run
vcvars32.bat
) - build with
configure.exe -platform win32-msvc2008 -debug
- When asked, choose open source license type (o), then accept the license (y)
- Note: the option
-prefix
doesn't work on Windows.
- Note: According to [1] Qt does not support msvc2008 on windows xp. However, running
configure.exe
with no-platform
argument seems to work. If you run configure with the-platform
argument first by mistake, and ifconfigure -clean
doesn't work, then you may need to start from a fresh extraction from the .zip archive before runningconfigure.exe
again with no-platform
, unless you can runnmake
with the config clean target.
- run
nmake
.
- Note: building with webkit support requires that src/3rdparty/webkit/WebCore/tmp/moc/{debug,release}_shared/mocinclude.tmp be removed. else you will get linker errors like
QNetworkReplyHandler.obj : error LNK2001: unresolved external symbol "public: virtual struct QMetaObject const * __thiscall WebCore::FormDataIODevice::metaObject(void)const (?metaObject@FormDataIODevice@WebCore@@UBEPBUQMetaObject@@XZ)
- Note: If you encounter the following error
api\qscriptextensionplugin.h(43): Error: Undefined interface,
, delete the files \src\script\tmp\moc\debug_shared\mocinclude.tmp and \src\script\tmp\moc\release_shared\mocinclude.tmp and restart nmake. For more info, please see QTBug 6470].
- Build Qt on Linux
- Downloading the binaries of Qt works fine with Linux, you do not have to compile Qt manually.
- Note: You need to install the libQtWebkit-devel package too
The following descriptions are given for people who want to
compile Qt anyway.
mkdir Qt
mkdir Qt-build
cd Qt
wget http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.6.2.tar.gz
tar xvfz qt-everywhere-opensource-src-4.6.2.tar.gz
cd qt-everywhere-opensource-src-4.6.2
echo yes | ./configure -prefix ../../Qt-build -debug-and-release -opensource -no-qt3support
make -j 16
make install
- Note: On a 64 bit system, you may have to add
-arch x86_64
to the Qt configure command line (?)
- Build Qt on Mac
Same as Linux. Use "-arch x86_64" for a 64 bit build on SnowLeopard.
Step1: Checkout slicer sources using subversion
For example:
cd MyProjects
svn co http://svn.slicer.org/Slicer4/trunk Slicer4
Step2: Configure slicer project using either ccmake or cmake-gui
The grids displayed below summarizes the available options.
Recommended: Using ccmake to compile QT only version with PythonQT support:
mkdir Slicer4-SuperBuild
cd Slicer4-SuperBuild
ccmake -DQT_QMAKE_EXECUTABLE:FILEPATH=/home/myself/qt-4.6.2/qt/bin/qmake -DSlicer_USE_KWWIDGETS:BOOL=OFF -DSlicer_USE_PYTHON:BOOL=OFF -DSlicer_USE_QT:BOOL=ON -DSlicer_USE_PYTHONQT:BOOL=ON -DSlicer_USE_PYTHONQT_WITH_TCL:BOOL=ON ../Slicer4/SuperBuild
On linux and mac: for developers, set the CMAKE_BUILD_TYPE to Debug.
More flexible option: Using ccmake (Additional configuration has to be set by using the flags shown in the table below):
mkdir Slicer4-SuperBuild
cd Slicer4-SuperBuild
ccmake -DQT_QMAKE_EXECUTABLE:FILEPATH=/home/myself/qt-4.6.2/qt/bin/qmake ../Slicer4/SuperBuild
More flexible option with GUI: Using cmake-gui (Additional configuration has to be set by using the flags shown in the grid below)
Where is the source code: C:/MyProjects/Slicer4/SuperBuild
Where to build the binaries: C:/MyProjects/Slicer4-SuperBuild
Set of options and supported platforms:
Description
Options
Platform
Slicer_USE_KWWIDGETS
Slicer_USE_PYTHON
Slicer_USE_QT
Slicer_USE_PYTHONQT
Linux
Mac
windows
Kww-Python DEFAULT
ON
ON
OFF
OFF
Y
Y
Y
Kww-NoPython
ON
OFF
OFF
OFF
Y
Y
Y
KwwAndQt-Python
ON
ON
ON
OFF
Y
N
Y
Qt-NoPythonQt
OFF
OFF
ON
OFF
Y
Y
Y
Qt-PythonQt
OFF
OFF
ON
ON
Y
Y
Y
What is the difference between Python and PythonQt build ?
The Python option is an older slicer3 flag used to turn on the KWWidgets-based Python option and should not be used with Qt. PythonQt refers to the PythonQt Project which is being integrated with Slicer4. Leave both options OFF for best results (PythonQt is still being debugged)
Step3: Configure, Generate the solution files and Build
Two projects are generated by ccmake/cmake-gui: the top-level bin directory Slicer4-Superbuild and the subdirectory Slicer4-Superbuild/Slicer-build.
The first project in Slicer4-Superbuild manages all the external dependencies of Slicer (VTK, ITK, Python, ...). To build Slicer the first time, run make (or build the solution file in Visual Studio) in Slicer4-Superbuild, which will update and build the external libraries and if successful will then build the subproject Slicer-build.
The second project in Slicer4-Superbuild/Slicer-build 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 Slicer4-Superuild/Slicer-build is necessary (the external libaries are considered built and up to date).
Warning, a lot of space disk is necessary to compile Slicer (>10GB on Windows)
- Linux:
After configuration, start the build process in the Slicer4-SuperBuild directory:
make -j<NUMBEROFCORES>
- Mac:
Same as on linux. On Mac OS X Snow Leopard and PythonQT enabled, there might be a complain about python-build/lib/libpython2.6.dylib not found. Please follow this workaround and then re-start the build process:
cd python-build
cmake -P ../python_configure_step.cmake
cmake -P ../python_install_step.cmake
- Windows:
Open Slicer4-SuperBuild\Slicer.sln (or Slicer-4.0\Slicer4-SuperBuild\Slicer-build\Slicer.sln) in Visual Studio and build the ALL_BUILD project.
Platform Notes
- On windows and mac python gets rebuilt every time you type make.
- You currently need to manually set the DYLD_LIBRARY_PATH (mac) and related paths to run the executable Slicer4-SuperBuild/Slicer-build/bin/SlicerQT
export DYLD_LIBRARY_PATH=<path/to>/Slicer4-SuperBuild/CTK-build/CTK-build/bin:<path/to>/Slicer4-SuperBuild/CTK-build/CMakeExternals/Install/lib