Mercurial > hg > orthanc
annotate INSTALL @ 19:e85455ff6039
standalon
author | Sebastien Jodogne <s.jodogne@gmail.com> |
---|---|
date | Tue, 24 Jul 2012 10:17:12 +0200 |
parents | 7908a4c25a18 |
children | 0a04c70747d9 |
rev | line source |
---|---|
2 | 1 Palantir - A Lightweight, RESTful DICOM Server |
2 ============================================== | |
3 | |
4 | |
5 Dependencies | |
6 ------------ | |
7 | |
7 | 8 1) CMake: Palantir uses CMake (http://www.cmake.org/) to automate its |
9 building process. | |
10 | |
11 2) Python: Some code is autogenerated through Python | |
12 (http://www.python.org/). | |
2 | 13 |
7 | 14 3) Mercurial: To use the cutting edge code, a Mercurial client must be |
15 installed (http://mercurial.selenic.com/). We recommand TortoiseHg. | |
16 | |
17 W) 7-Zip: For the native build under Windows, the 7-Zip tool is used | |
18 to uncompress the third-party packages (http://www.7-zip.org/). | |
19 | |
20 You thus have to download and install CMake, Python, Mercurial and | |
21 possibly 7-Zip first. The path to their executable must be in the | |
22 "PATH" environment variable. | |
2 | 23 |
24 The other third party dependencies are automatically downloaded by the | |
25 CMake scripts. The downloaded packages are stored in the | |
26 "ThirdPartyDownloads" directory. | |
27 | |
28 | |
29 Building Palantir at a glance | |
30 ----------------------------- | |
31 | |
32 To build Palantir, you must: | |
33 | |
34 1) Download the source code (either using Mercurial, or through the | |
35 released versions). For the examples below, we assume the source | |
36 directory is "~/Palantir". | |
37 | |
38 2) Create a build directory. For the examples below, we assume the | |
39 build directory is "~/PalantirBuild". | |
40 | |
41 | |
42 | |
43 Native Linux Compilation | |
44 ------------------------ | |
45 | |
46 To build binaries with debug information: | |
47 | |
48 # cd ~/PalantirBuild | |
49 # cmake -DCMAKE_BUILD_TYPE=DEBUG ~/Palantir | |
50 # make | |
51 # make doc | |
52 | |
53 | |
54 To build a release version: | |
55 | |
56 # cd ~/PalantirBuild | |
57 # cmake -DCMAKE_BUILD_TYPE=RELEASE ~/Palantir | |
58 # make | |
59 # make doc | |
60 | |
61 | |
62 Under Linux, you have the possibility to dynamically link Palantir | |
63 against the shared libraries of your system, provided their version is | |
64 recent enough. This greatly speeds up the compilation: | |
65 | |
66 # cd ~/PalantirBuild | |
67 # cmake -DSTATIC_BUILD=OFF -DCMAKE_BUILD_TYPE=DEBUG ~/Palantir | |
68 # make | |
69 | |
70 | |
71 | |
72 Cross-Compilation for Windows under Linux | |
73 ----------------------------------------- | |
74 | |
75 To cross-compile Windows binaries under Linux using MinGW, please use | |
76 the following command: | |
77 | |
78 # cd ~/PalantirBuild | |
79 # cmake -DCMAKE_TOOLCHAIN_FILE=~/Palantir/Resources/MinGWToolchain.cmake -DCMAKE_BUILD_TYPE=DEBUG ~/Palantir | |
80 # make | |
81 | |
82 | |
83 | |
7 | 84 Native Windows build with MinGW (VERY SLOW) |
13
7908a4c25a18
preparation for release
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
7
diff
changeset
|
85 ------------------------------------------- |
2 | 86 |
7 | 87 # cd [...]\PalantirBuild |
88 # cmake -G "MinGW Makefiles" -DCMAKE_BUILD_TYPE=DEBUG [...]\Palantir | |
2 | 89 # mingw32-make |
7 | 90 |
91 | |
92 | |
93 Native Windows build with Microsoft Visual Studio 2005 | |
94 ------------------------------------------------------ | |
95 | |
96 # cd [...]\PalantirBuild | |
97 # cmake -G "Visual Studio 8 2005" [...]\Palantir | |
98 | |
99 Then open the "[...]/PalantirBuild/Palantir.sln" with Visual Studio. | |
100 | |
101 NOTES: | |
102 * More recent versions of Visual Studio should also work. | |
13
7908a4c25a18
preparation for release
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
7
diff
changeset
|
103 * You might have to install the Platform SDK (version 6 or above): |
7 | 104 http://en.wikipedia.org/wiki/Microsoft_Windows_SDK. |
13
7908a4c25a18
preparation for release
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
7
diff
changeset
|
105 Read the CMake FAQ: http://goo.gl/By90B |