forked from eiskaltdcpp/eiskaltdcpp
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathINSTALL
343 lines (321 loc) · 12.5 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
*******************************************************************************
Runtime Depends
*******************************************************************************
--------
:common:
--------
bzip2
zlib
iconv (libc on GNU/Linux)
----------------
:libeiskaltdcpp:
----------------
gettext
libssl (>= 0.9.8)
liblua5.1 (optional, see cmake keys)
libpcrecpp0 (optional, see cmake keys)
miniupnpc (optional, see cmake keys)
libidn (optional, see cmake keys)
libattr (optional)
libboost-system (required only if Boost >= 1.50 is used)
----------------
:eiskaltdcpp-qt:
----------------
libqtcore4, libqtgui4, libqt4-network, libqt4-xml (>= 4.6.0)
libqt4-script (>= 4.6.0) (optional, see cmake keys)
libqt4-dbus (>= 4.6.0) (optional, see cmake keys)
or
libqt5core5a, libqt5gui5, libqt5widgets5, libqt5network5, libqt5xml5 (>= 5.0.2)
libqt5script5 (>= 5.0.2) (optional, see cmake keys)
libqt5dbus5 (>= 5.0.2) (optional, see cmake keys)
.
libaspell (optional, see cmake keys)
-----------------
:eiskaltdcpp-gtk:
-----------------
gettext
libpango
libgtk2 (>= 2.24)
libglib2 (>= 2.24)
libnotify (>= 0.4.1) (optional, see cmake keys)
libgnome2 (optional, see cmake keys)
libcanberra-gtk3-0 (optional, see cmake keys)
--------------------
:eiskaltdcpp-daemon:
--------------------
libxmlrpc-c++4 (>= 1.19.0) (optional, see cmake keys)
-----------------
:eiskaltdcpp-cli:
-----------------
perl (>= 5.10)
perl modules:
Getopt::Long (libgetopt-long-descriptive-perl)
Data::Dump (libdata-dump-perl)
Term::ShellUI (libterm-shellui-perl)
RPC::XML (librpc-xml-perl) (optional, see cmake keys)
JSON::RPC (libjson-rpc-perl) (optional, see cmake keys)
*******************************************************************************
Optional Depends
*******************************************************************************
----------------
:eiskaltdcpp-qt:
----------------
sh (bash, dash, etc...)
see examples/ and eiskaltdcpp-qt/qtscripts/
php5-cli (or other version, check the compatibility by yourself)
see eiskaltdcpp-qt/examples/ and eiskaltdcpp-qt/qtscripts/
libqtscript4-core, libqtscript4-gui, libqtscript4-network, libqtscript4-xml
see eiskaltdcpp-qt/qtscripts/
-----------------
:eiskaltdcpp-gtk:
-----------------
...
*******************************************************************************
Build Depends
*******************************************************************************
--------
:common:
--------
gcc (>= 5.3) or clang (>= 3.8)
cmake (>= 2.6.3) or cmake (>= 2.8.11) [for build with Qt5]
pkg-config
bzip2
zlib
----------------
:libeiskaltdcpp:
----------------
gettext
libboost-dev (>= 1.39.0) (headers only if Boost < 1.50) (optional, see cmake keys)
liblua5.1-dev (optional, see cmake keys)
libpcre3-dev (optional, see cmake keys)
miniupnpc (optional, see cmake keys)
libidn (optional, see cmake keys)
libattr-dev (optional)
----------------
:eiskaltdcpp-qt:
----------------
Qt4 (>= 4.6.0) or Qt5 (>= 5.0.2)
libaspell-dev (optional, see cmake keys)
-----------------
:eiskaltdcpp-gtk:
-----------------
libgtk2.0-dev (optional, see cmake keys)
libgtk-3-dev (optional, see cmake keys)
libnotify-dev (optional, see cmake keys)
libgnome2-dev (optional, see cmake keys)
libcanberra-gtk3-dev (optional, see cmake keys)
--------------------
:eiskaltdcpp-daemon:
--------------------
libxmlrpc-c++4-dev (>=1.19.0) (optional, see cmake keys)
*******************************************************************************
Installation in Linux and other UNIX-like systems
*******************************************************************************
mkdir -p builddir && cd builddir
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr ../
make -j2
sudo make install
---------
# Note: you can get the most recent sources of program from git repository:
git clone https://github.com/eiskaltdcpp/eiskaltdcpp.git
*******************************************************************************
Keys for cmake
*******************************************************************************
----------------
:libeiskaltdcpp:
----------------
-DLUA_SCRIPT=ON/OFF (default: ON)
Support of Lua scripts
-DPERL_REGEX=ON/OFF (default: ON)
Use pcre library for regexps in perl style (now it is used only in ADL Search)
-DUSE_IDNA=ON/OFF (default: ON)
Use libidn for rfc3490 (resolving Internationalized Domain Names)
-DWITH_DHT=ON/OFF (default: ON)
DHT support (http://www.adcportal.com/wiki/StrongDC++_DHT)
-DLINK=STATIC/SHARED (default: SHARED)
Build static or shared library.
This option is available only on Unix-like systems.
For MS Windows, macOS and Haiku systems it is forcibly set to STATIC.
-DLOCAL_BOOST=ON/OFF (default: OFF)
Use local boost headers.
This script downloads archive with only necessary boost headers from:
https://sourceforge.net/projects/eiskaltdcpp/files/Other/boost.tar.gz
(This archive have much less size than official boost archive.)
If boost.tar.gz already available in source tree repeated download will
not happen.
----------------
:eiskaltdcpp-qt:
----------------
-DUSE_QT=ON/OFF (default: OFF)
Build EiskaltDC++ with Qt interface using Qt 4.x libraries
-DUSE_QT5=ON/OFF (default: ON)
Build EiskaltDC++ with Qt interface using Qt 5.x libraries
-DUSE_ASPELL=ON/OFF (default: ON)
Use or not use aspell
-DUSE_PROGRESS_BARS=ON/OFF (default: ON)
Use progress bars or widgets with plain text for indication of progress.
This option is especially important for macOS where progress bars do not
allow to show text on them so a lot of information is hidden from user.
-DLOCAL_ASPELL_DATA=ON/OFF (default: OFF)
Use local aspell data files
Script downloads archive with aspell data files:
https://sourceforge.net/projects/eiskaltdcpp/files/Other/aspell.tar.gz
If aspell.tar.gz already available in source tree repeated download will
not happen.
-DFREE_SPACE_BAR_C=ON/OFF (default: ON)
Show free space indicator in status panel
-DDBUS_NOTIFY=ON/OFF (default: ON)
Use or not use QtDBus module
-DUSE_JS=ON/OFF (default: OFF)
Enable/disable QtScript basic support
-DUSE_QT_QML=ON/OFF (default: OFF)
Enable/disable Qt Declarative UI support. Work only with Qt >= 4.7.0
-DUSE_QT_SQLITE=ON/OFF (default: ON)
Build with SQLite support. (This is experimental option)
-----------------
:eiskaltdcpp-gtk:
-----------------
-DUSE_GTK=ON/OFF (default: OFF)
Build EiskaltDC++ with Gtk interface using GTK+ 2.x library
(This UI is based on FreeDC++ and LinuxDC++.)
-DUSE_GTK3=ON/OFF (default: OFF)
Build EiskaltDC++ with GTK+ interface using GTK+ 3.x library
-DUSE_LIBGNOME2=ON/OFF (default: OFF)
Enable/disable sound notifications support over libgnome2 in EiskaltDC++ Gtk
-DUSE_LIBCANBERRA=ON/OFF (default: OFF)
Enable/disable sound notifications support over libcanberra in EiskaltDC++ Gtk
-DUSE_LIBNOTIFY=ON/OFF (default: ON)
Enable/disable popup notifications support in EiskaltDC++ Gtk
-DFREE_SPACE_BAR_C=ON/OFF (default: ON)
Show free space indicator in status panel
--------------------
:eiskaltdcpp-daemon:
--------------------
-DNO_UI_DAEMON=ON/OFF (default: OFF)
Build daemon (without any UI)
-DXMLRPC_DAEMON=ON/OFF (default: OFF)
Make this daemon as xmlrpc server.
-DJSONRPC_DAEMON=ON/OFF (default: ON)
Make this daemon as json server.
-DLOCAL_JSONCPP=ON/OFF (default: ON)
Use embedded copy of jsoncpp library or system library. Have in mind, if
this library do not have our patch, it will causes segmentation faults in
eiskaltdcpp-daemon.
-----------------
:eiskaltdcpp-cli:
----------------
-DUSE_CLI_XMLRPC=ON/OFF (default: OFF)
Use command line interface to control daemon via XMLRPC
-DUSE_CLI_JSONRPC=ON/OFF (default: OFF)
Use command line interface to control daemon via JSONRPC
--------
:common:
--------
-DWITH_EMOTICONS=ON/OFF (default: ON)
If ON install emoticons/
-DWITH_EXAMPLES=ON/OFF (default: ON)
If ON install examples/
-DWITH_LUASCRIPTS=ON/OFF (default: ON)
If ON install luascripts/
-DUSE_MINIUPNP=ON/OFF (default: ON)
use or not use miniupnpc lib
-DWITH_SOUNDS=ON/OFF (default: ON)
If ON install sounds/
-Dlinguas:STRING="needed translations, separator is whitespace" (default: *)
Examples:
-Dlinguas="en ru" - install ru and en translations
-Dlingaus="*" - install all translations
-Dlinguas="" - don't install any translation
-DFORCE_XDG=ON/OFF (default: ON)
Use or not use $XDG_CONFIG_HOME and $XDG_CONFIG_DOWNLOADS variables.
See http://standards.freedesktop.org/basedir-spec/latest/ar01s03.html
-DCMAKE_INSTALL_PREFIX=<common prefix> (default: /usr/local)
common prefix.
In case of using of `make install DESTDIR=<path>` all will bre installed to:
<path>/<common prefix>
-DLIBDIR=<lib prefix> (default: lib)
Installation path for libraries (subdirectory).
Libraries will be installed to: <common prefix>/<lib prefix>
Examples:
-DLIBDIR=lib64 - install lib to <common prefix>/lib64
-DLIB_INSTALL_DIR=<lib prefix> (default: lib)
see -DLIBDIR
-DINSTALL_RUNTIME_PATH=ON/OFF (default: OFF)
Set RPATH in library. About possible troubles see:
https://fedoraproject.org/wiki/RPath_Packaging_Draft
https://wiki.debian.org/RpathIssue
-DWITH_DEV_FILES=ON/OFF (default: OFF)
If ON install development files (headers for libeiskaltdcpp)
see also -DEISKALTDCPP_INCLUDE_DIR
-DEISKALTDCPP_INCLUDE_DIR=<dir> (default: <common prefix>/include/eiskaltdcpp)
install development files (headers for libeiskaltdcpp) to <dir>
-DDESKTOP_ENTRY_PATH=<common prefix> (default: /usr/local/share/applications/)
path to directory with system *.desktop files
-DPIXMAPS_ENTRY_PATH=<common prefix> (default: /usr/local/share/pixmaps/)
path to directory with pixmaps of applications for system *.desktop files
-DDO_NOT_USE_MUTEX=ON/OFF (default: OFF)
Do not use mutex. Until Haiku and WINE do not support mutexes, this option
is necessary for them. Currently this option is forcibly set to "ON" in
builds for MS Windows, macOS and Haiku.
-DHAIKU_PKG=ON/OFF (default: OFF)
Make Haiku package
-DCMAKE_BUILD_TYPE={Release, RelWithDebInfo, Debug, MinRelSize}
build type (please use RelWithDebInfo for debug mode, not Debug)
And other standart cmake keys...
---------
# Example of the full build:
mkdir -p builddir && cd builddir
cmake -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DUSE_QT=ON \
-DUSE_GTK=ON \
-DUSE_JS=ON \
-DUSE_ASPELL=ON \
-DUSE_QT_QML=ON \
-DUSE_QT_SQLITE=ON \
-DLUA_SCRIPT=ON \
-DWITH_LUASCRIPTS=ON \
-DWITH_SOUNDS=ON \
-DNO_UI_DAEMON=ON \
-DJSONRPC_DAEMON=ON \
-DUSE_CLI_JSONRPC=ON \
-DUSE_MINIUPNP=ON \
..
make
sudo make install
*******************************************************************************
Uninstall program
*******************************************************************************
sudo make uninstall
*******************************************************************************
FreeBSD specific notes
*******************************************************************************
# If you use GCC, specific configuration options are not required. But if you
# use clang, try something like this:
mkdir -p builddir && cd builddir
cmake -DCMAKE_C_COMPILER=/usr/bin/clang -DCMAKE_CXX_COMPILER=/usr/bin/clang++ -DCMAKE_CXX_FLAGS='-I/opt/local/include -stdlib=libc++' -DNO_UI_DAEMON=ON -DXMLRPC_DAEMON=ON -DJSONRPC_DAEMON=ON -DUSE_QT=ON ..
make
sudo make install
*******************************************************************************
macOS specific notes
*******************************************************************************
Examples of build scripts:
macosx/build-universal-binary.sh (outdated)
macosx/build-for-personal-use.sh (outdated)
macosx/build-using-homebrew.sh (recommended)
*******************************************************************************
MS Windows specific notes
*******************************************************************************
Instructions are available in the file: windows/READ_ME.txt
*******************************************************************************
Haiku specific notes
*******************************************************************************
To configure program use command like this:
cmake .. \
-DCMAKE_INSTALL_PREFIX=/boot/apps/Eiskaltdcpp \
-DSHARE_DIR=/boot/apps/Eiskaltdcpp \
-DLOCAL_BOOST=ON \
-DFORCE_XDG=OFF \
-DHAIKU_PKG=ON
Full build rules for Haiku you may see in recipe from official package:
https://github.com/haikuports/haikuports/tree/master/net-p2p/eiskaltdcpp