Mercurial > retraceit
comparison INSTALL @ 65:508a71328d1f
Update install / icon documentation
author | Andre Heinecke <andre.heinecke@intevation.de> |
---|---|
date | Thu, 21 May 2015 14:30:56 +0200 |
parents | 3acafcfc52a1 |
children | 689c82e7d07e |
comparison
equal
deleted
inserted
replaced
64:1129d49b9baf | 65:508a71328d1f |
---|---|
5 For Debian based GNU / Linux | 5 For Debian based GNU / Linux |
6 ============================ | 6 ============================ |
7 Tested development platform: Ubuntu 14.4 amd64. | 7 Tested development platform: Ubuntu 14.4 amd64. |
8 | 8 |
9 Build dependencies are: | 9 Build dependencies are: |
10 | |
10 build-essential cmake libqt5core5a qttools5-dev-tools qt5-default \ | 11 build-essential cmake libqt5core5a qttools5-dev-tools qt5-default \ |
11 qtbase-dev qtbase5-dev-tools qttools5-dev inkscape | 12 qtbase-dev qtbase5-dev-tools qttools5-dev inkscape mercurial |
12 | |
13 | 13 |
14 This document expects the following setup for build and installation. | 14 This document expects the following setup for build and installation. |
15 It is recommended to set a custom installation prefix to avoid root | 15 It is recommended to set a custom installation prefix to avoid root |
16 privileges. | 16 privileges. |
17 | 17 |
18 export CUSTOM_PREFIX=<Prefix of your choice (default /usr)> | 18 export CUSTOM_PREFIX=<Prefix of your choice (default /usr)> |
19 mkdir -p $CUSTOM_PREFIX/bin | 19 mkdir -p $CUSTOM_PREFIX/bin |
20 export PATH=$CUSTOM_PREFIX/bin:$PATH | 20 export PATH=$CUSTOM_PREFIX/bin:$PATH |
21 | 21 |
22 Configure the according Root CA if necessary: | |
23 | |
24 echo "[web]" >> ~/.hgrc | |
25 echo "cacerts=~/wald-ca.pem" >> ~/.hgrc | |
26 curl https://ssl.intevation.de/Intevation-Root-CA-2010.crt > ~/wald-ca.pem | |
27 | |
28 Checkout retraceit sources: | |
29 | |
30 hg clone https://wald.intevation.org/hg/retraceit/ | |
31 | |
22 Building the Software: | 32 Building the Software: |
23 cd <PATH_TO_REPO> | 33 |
34 cd retraceit | |
24 mkdir build-native | 35 mkdir build-native |
25 cd build-native | 36 cd build-native |
26 cmake .. -DCMAKE_PREFIX_PATH=$CUSTOM_PREFIX | 37 cmake .. -DCMAKE_PREFIX_PATH=$CUSTOM_PREFIX |
27 | 38 |
28 For Microsoft Windows | 39 For Microsoft Windows |
32 | 43 |
33 Tested development platform is Ubuntu 14.4 | 44 Tested development platform is Ubuntu 14.4 |
34 | 45 |
35 Dependencies on the Host system: | 46 Dependencies on the Host system: |
36 | 47 |
37 apt-get install git autoconf automake bash bison bzip2 \ | 48 git autoconf automake bash bison bzip2 \ |
38 cmake flex gettext git g++ intltool \ | 49 cmake flex gettext git g++ intltool \ |
39 libffi-dev libtool libltdl-dev libssl-dev \ | 50 libffi-dev libtool libltdl-dev libssl-dev \ |
40 libxml-parser-perl make openssl patch perl \ | 51 libxml-parser-perl make openssl patch perl \ |
41 pkg-config scons sed unzip curl xz-utils autopoint \ | 52 pkg-config scons sed unzip curl xz-utils autopoint \ |
42 gperf | 53 gperf |
55 echo "set(CMAKE_STRIP $MXEPATH/usr/bin/i686-w64-mingw32.static-strip)" >> \ | 66 echo "set(CMAKE_STRIP $MXEPATH/usr/bin/i686-w64-mingw32.static-strip)" >> \ |
56 "$MXEPATH/usr/i686-w64-mingw32.static/share/cmake/mxe-conf.cmake" | 67 "$MXEPATH/usr/i686-w64-mingw32.static/share/cmake/mxe-conf.cmake" |
57 | 68 |
58 Compile the software: | 69 Compile the software: |
59 | 70 |
60 cd repo | 71 cd retraceit |
61 mkdir build-windows | 72 mkdir build-windows |
62 cd build-windows | 73 cd build-windows |
63 MXETARGET=$MXEPATH/usr/i686-w64-mingw32.static/ | 74 MXETARGET=$MXEPATH/usr/i686-w64-mingw32.static/ |
64 cmake .. \ | 75 cmake .. \ |
65 -DCMAKE_PREFIX_PATH="$MXETARGET/qt5;$MXETARGET;" \ | 76 -DCMAKE_PREFIX_PATH="$MXETARGET/qt5;$MXETARGET;" \ |
66 -DCMAKE_TOOLCHAIN_FILE="$MXETARGET/share/cmake/mxe-conf.cmake" \ | 77 -DCMAKE_TOOLCHAIN_FILE="$MXETARGET/share/cmake/mxe-conf.cmake" \ |
67 -DCMAKE_VERBOSE_MAKEFILE=True | 78 -DCMAKE_VERBOSE_MAKEFILE=True |
79 make | |
80 | |
81 The binary is created under: | |
82 | |
83 build-windows/src/retraceit.exe | |
84 | |
85 This binary can be compressed with UPX or directly used. Without further | |
86 dependencies. | |
68 | 87 |
69 For MacOSX | 88 For MacOSX |
70 ========== | 89 ========== |
71 Install the usual development tools / xcode. | 90 Install the usual development tools / xcode. |
72 | 91 |
73 Define some paths for the build environment: | 92 Define some paths for the build environment: |
74 export CUSTOM_PREFIX=~/retraceit | |
75 | 93 |
76 export PATH=$CUSTOM_PREFIX/bin:$PATH | 94 export CUSTOM_PREFIX=~/retraceit |
77 export DYLD_LIBRARY_PATH=$CUSTOM_PREFIX/lib:$DYLD_LIBRARY_PATH | |
78 export PKG_CONFIG_PATH=$CUSTOM_PREFIX/lib/pkgconfig:$PKG_CONFIG_PATH | |
79 | 95 |
96 export PATH=$CUSTOM_PREFIX/bin:$PATH | |
97 export DYLD_LIBRARY_PATH=$CUSTOM_PREFIX/lib:$DYLD_LIBRARY_PATH | |
98 export PKG_CONFIG_PATH=$CUSTOM_PREFIX/lib/pkgconfig:$PKG_CONFIG_PATH | |
80 | 99 |
81 Download qt: | 100 Download qt: |
82 | 101 |
83 curl -O http://qt-mirror.dannhauer.de/official_releases/qt/5.3/5.3.2/single/qt-everywhere-opensource-src-5.3.2.tar.xz | 102 curl -O http://qt-mirror.dannhauer.de/official_releases/qt/5.3/5.3.2/single/qt-everywhere-opensource-src-5.3.2.tar.xz |
84 shasum qt-everywhere-opensource-src-5.3.2.tar.xz | 103 shasum qt-everywhere-opensource-src-5.3.2.tar.xz |
100 | 119 |
101 make -j `sysctl hw.ncpu | cut -f 2 -d " "` | 120 make -j `sysctl hw.ncpu | cut -f 2 -d " "` |
102 make install | 121 make install |
103 | 122 |
104 Download mercurial: | 123 Download mercurial: |
124 | |
105 wget https://mercurial.selenic.com/mac/binaries/Mercurial-3.4-py2.7-macosx10.10.zip | 125 wget https://mercurial.selenic.com/mac/binaries/Mercurial-3.4-py2.7-macosx10.10.zip |
106 shasum Mercurial-3.4-py2.7-macosx10.10.zip | 126 shasum Mercurial-3.4-py2.7-macosx10.10.zip |
107 | 127 |
108 Should match: 1380790ae7f7d8060e937d386be3103c173e450d | 128 Should match: 1380790ae7f7d8060e937d386be3103c173e450d |
109 | 129 |
110 unzip Mercurial-3.4-py2.7-macosx10.10.zip | 130 unzip Mercurial-3.4-py2.7-macosx10.10.zip |
111 | 131 |
112 Install the .mpkg | 132 Install the .mpkg |
113 | 133 |
114 Configure to be usable with wald certificate | 134 Configure to be usable with wald certificate: |
135 | |
115 echo "[web]" >> ~/.hgrc | 136 echo "[web]" >> ~/.hgrc |
116 echo "cacerts=~/wald-ca.pem" >> ~/.hgrc | 137 echo "cacerts=~/wald-ca.pem" >> ~/.hgrc |
117 curl https://ssl.intevation.de/Intevation-Root-CA-2010.crt > ~/wald-ca.pem | 138 curl https://ssl.intevation.de/Intevation-Root-CA-2010.crt > ~/wald-ca.pem |
118 | 139 |
119 Download cmake: | 140 Download cmake: |
139 make install | 160 make install |
140 | 161 |
141 The make install will create a retraceit.app in your $CUSTOM_PREFIX directory. | 162 The make install will create a retraceit.app in your $CUSTOM_PREFIX directory. |
142 This is the deployable application bundle | 163 This is the deployable application bundle |
143 | 164 |
144 You can now create a distirbution variant | 165 You can now create a .dmg image for distribution: |
166 | |
145 mv $CUSTOM_PREFIX/retraceit.app $CUSTOM_PREFIX/RetraceIT.app | 167 mv $CUSTOM_PREFIX/retraceit.app $CUSTOM_PREFIX/RetraceIT.app |
146 hdiutil create -ov -format UDZO -volname RetraceIT -srcfolder RetraceIT.app \ | 168 hdiutil create -ov -format UDZO -volname RetraceIT -srcfolder RetraceIT.app \ |
147 -o RetraceIT.dmg -imagekey zlib-level=9 | 169 -o RetraceIT.dmg -imagekey zlib-level=9 |
148 | 170 |
149 */ | 171 */ |