Blame view

INSTALL 4.72 KB
1

JanKusanagi committed
2
 Dianara - A Pump.io client
JanKusanagi committed
3
 Copyright 2012-2017  JanKusanagi JRR <jancoding@gmx.com>
4

JanKusanagi committed
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
===============================================================================

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the
   Free Software Foundation, Inc.,
   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA.

   Or visit http://www.gnu.org/licenses/

===============================================================================
25

JanKusanagi committed
26

27 28
These are some basic instructions on how to build Dianara from source, in case
you don't have precompiled packages available for your operating system.
29
See https://jancoding.wordpress.com/dianara for info on package availability.
30 31


JanKusanagi committed
32

JanKusanagi committed
33 34
General runtime dependencies (check carefully!)
===============================================================================
35

36 37 38
 - Qt 4.8.x, or 5.x
 - QJSON 0.7.x or 0.8.x (Only when building with Qt 4)
 - QOAuth 1.0.x, built with the same version of Qt used to build Dianara
39
   (might be called 2.x when built for Qt 5)
40
 - Libmagic
41 42 43
 - OpenSSL plugin for QCA (qca2-plugin-openssl, libqca2-plugin-ossl, or similar)
   In some cases, the QCA package includes the plugins directly.
    *** Dianara will _crash_ if you don't have this!
44 45


JanKusanagi committed
46 47 48

Dependencies for building
===============================================================================
49

50
You'll need qmake and the qt-devel (>= 4.8, including QtNetwork and QtDBUS
51 52
modules, if they are separate), and qjson-devel (only for Qt 4), qoauth-devel
and libmagic-devel packages.
JanKusanagi committed
53 54
Qmake might be included in the Qt development packages, or it might be a
separate package.
55

56

JanKusanagi committed
57 58
These are the names of the packages for the build dependencies
in some GNU/Linux distributions:
JanKusanagi committed
59

JanKusanagi committed
60
  - Mageia (probably in Mandriva and ROSA, too):
61 62 63 64 65 66
      Qt 4: libqt4-devel, libqjson-devel, libqoauth-devel and libmagic-devel.
      Qt 5: libqt5base5-devel, libqoauth-qt5-devel and libmagic-devel.

      ** Note: In x86_64 arch, "lib" packages start with "lib64", such as
               lib64qt5base5-devel.

67
    > Build tools: gcc-c++
68

69 70

  - Debian (probably in any of its derivatives, too):
71 72
      Qt 4: libqt4-dev, libqjson-dev, libqoauth-dev (<2.0.0) and libmagic-dev.
      Qt 5: qt5-default, libqoauth-dev (>=2.0.0) and libmagic-dev.
73

JanKusanagi committed
74
    > Build tools: build-essential, g++
75 76


JanKusanagi committed
77
  - Fedora:
78 79 80
      Qt 4: qt-devel, qjson-devel, qoauth-devel, and file-devel.
      Qt 5: qt5-qtbase-devel, [...]

81
    > Build tools: gcc-c++
JanKusanagi committed
82

83

84
  - openSUSE:
85 86 87
      Qt 4: libqt4-devel, libqjson-devel, qoauth-devel and file-devel (has libmagic).
      Qt 5: libqt5-qtbase-devel, [...]

88

JanKusanagi committed
89
  - Archlinux (runtime dependencies include build-time dependencies):
90
      Qt 5: qt5-base, qoauth, file (this one includes libmagic).
91

92

93

94 95
You might also need to install qt4-qmake, or qt5-qmake, if your distribution
does not include it with the Qt development package.
96 97 98



JanKusanagi committed
99 100
Build process
===============================================================================
101

JanKusanagi committed
102
From Dianara's main directory, where Dianara.pro is located, execute:
103

JanKusanagi committed
104 105
        mkdir build               # Create a clean directory for the build
        cd build                  # Go into it
106
        qmake ..                  # Ask Qmake to generate a Makefile[*]
JanKusanagi committed
107
        make                      # Run Make to compile the project
108

109
[*]you might need to use the command 'qmake-qt5' or 'qmake-qt4' instead!
110 111 112 113

That should do it!


JanKusanagi committed
114 115
There is an installation target if you wish to use 'make install', but you can
just run the resulting "dianara" binary without installation.
116 117
The language files will be embedded into the binary upon compilation,
so there's no need to keep them afterwards.
118 119 120



JanKusanagi committed
121 122
Dianara is built on and for GNU/linux, but it will probably work under other
systems, as long as they are supported by Qt, and have ports of the necessary
123
dependencies. Building under FreeBSD has been known to work.
JanKusanagi committed
124

JanKusanagi committed
125

126 127 128 129
If your desktop environment is Plasma 5, but older than 5.5.0, (or maybe other
modern environments), and you build with Qt 4, you will need the SNI Qt plugin
in order for the system tray icon to appear.

130

JanKusanagi committed
131

132
===============================================================================
133

134

135
Visit https://jancoding.wordpress.com/dianara for more information.
JanKusanagi committed
136

JanKusanagi committed
137
Get the latest development source from https://gitlab.com/dianara/dianara-dev