INSTALL 4.06 KB
Newer Older
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
 - Qt 5.6 or later
37
 - QOAuth 2.x, built with Qt 5
38 39 40
 - 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!
41 42


JanKusanagi committed
43 44 45

Dependencies for building
===============================================================================
46

47
You'll need qmake and the qt-devel (>= 5.6, including QtNetwork and QtDBUS
48
modules, if they are separate), and qoauth-devel packages.
JanKusanagi committed
49 50
Qmake might be included in the Qt development packages, or it might be a
separate package.
51

52

JanKusanagi committed
53 54
These are the names of the packages for the build dependencies
in some GNU/Linux distributions:
JanKusanagi committed
55

JanKusanagi committed
56
  - Mageia (probably in Mandriva and ROSA, too):
57
      libqt5base5-devel and libqoauth-qt5-devel.
58 59 60 61

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

62
    > Build tools: gcc-c++, make
63

64 65

  - Debian (probably in any of its derivatives, too):
JanKusanagi committed
66
      qt5-default and libqoauth-dev (>=2.0.0, or libqoauth-qt5-dev).
67

JanKusanagi committed
68
    > Build tools: build-essential, g++
69 70


JanKusanagi committed
71
  - Fedora:
JanKusanagi committed
72
      qt5-qtbase-devel, qoauth-qt5-devel.
73

74
    > Build tools: gcc-c++
JanKusanagi committed
75

76

77
  - openSUSE:
78
      libqt5-qtbase-devel and qoauth-qt5-devel.
79

80

81
  - Archlinux and Parabola (runtime deps include build-time deps):
82
      qt5-base and qoauth.
83

84
    > Build tools: gcc, make
85

86

87
  - FreeBSD (runtime deps include build-time deps):
JanKusanagi committed
88
      qt5-widgets and qoauth-qt5.
89

JanKusanagi committed
90
    > Build tools: qmake-qt5, qt5-buildtools
91 92


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



JanKusanagi committed
98 99
Build process
===============================================================================
100

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

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

108
[*]you might need to use the command 'qmake-qt5' instead
109 110 111 112

That should do it!


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



JanKusanagi committed
120 121
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
122
dependencies.
JanKusanagi committed
123

JanKusanagi committed
124

JanKusanagi committed
125

126
===============================================================================
127

128

129
Visit https://jancoding.wordpress.com/dianara for more information.
JanKusanagi committed
130

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