INSTALL 3.07 KB
Newer Older
1

2 3
Building & Installing Geary
===========================
4

5 6
Building
--------
7

8 9 10 11
Geary uses the Meson <http://mesonbuild.com> and Ninja
<https://ninja-build.org> build systems. To build Geary, run the
following commands from the top-level directory of the source code
repository:
12

13 14
    meson build
    ninja -C build
15

16 17
A convenience Makefile for development only is also provided. To use
it, simply invoke make from the top-level directory.
18

19 20
Dependencies
------------
21

22
Building Geary requires the following major libraries and tools:
23

24 25 26 27
 * GTK+ 3
 * WebKitGTK+ 2
 * SQLite 3
 * Vala
28

29 30
See the `meson.build` file in the top-level directory for the complete
list of required dependencies and minimum versions.
31

32
Geary also requires SQLite to be built with the compiler flag
33
`-DSQLITE_ENABLE_FTS3`.
34

35 36
All required libraries and tools are available from major Linux
distribution's package repositories:
37

38 39
Installing dependencies on Fedora
---------------------------------
40

41 42
Fedora 25 and later ships with the correct versions of the required
libraries. Install them by running this command:
43

44 45
    sudo yum install vala gobject-introspection-devel meson \
        desktop-file-utils iso-codes-devel libcanberra-devel libgee-devel \
46 47
        glib2-devel gmime-devel gtk3-devel libnotify-devel sqlite-devel \
        webkitgtk4-devel libsecret-devel libxml2-devel vala-tools \
48
        gcr-devel enchant2-devel libunwind-devel json-glib-devel \
49
        gnome-online-accounts-devel itstool
50

51 52
Installing dependencies on Ubuntu/Debian
----------------------------------------
53

54 55
Ubuntu 17.10 (Artful) and later ships with the correct versions of the
required libraries.
56

57 58
Ubuntu 16.04 LTS (Xenial) does not meet the minimum requirements,
users of that are encourage to use Geary 0.12 LTS instead.
59

60 61
Debian 9 (Stretch) and later ships with the correct versions of the
required libraries.
62

63
Install them by running this command:
64

65
    sudo apt-get install valac libgirepository1.0-dev \
66
        meson desktop-file-utils iso-codes libcanberra-dev \
67 68 69
        libgee-0.8-dev libglib2.0-dev libgmime-2.6-dev libgtk-3-dev \
        libsecret-1-dev libxml2-dev libnotify-dev libsqlite3-dev \
        libwebkit2gtk-4.0-dev libgcr-3-dev libenchant-dev \
70
        libunwind-dev libgoa-1.0-dev libjson-glib-dev itstool gettext
71

72
And for Ubuntu Unity integration:
73

74
    sudo apt-get install libunity-dev libmessaging-menu-dev
75

76 77
Running
-------
78

79 80
If you wish to try Geary before installing it, you may execute it directly
from its build directory:
81

82
    ./build/src/geary
83

84 85
Note that certain desktop integration (such as being listed in an
application menu) requires full installation.
86

87 88
Installation
------------
89

90
After Geary has built, install it by invoking the install target:
91

92
    ninja -C build install
93

94
After installation, it can be uninstalled in the same way:
95

96
    ninja -C build uninstall
97

98 99 100
By default, Geary will install under /usr/local. To install to a
different directory, set pass the --prefix to meson when performing
the initial configuration step:
101

102
    meson --prefix=/usr -C build
103

104 105 106
---
Copyright 2016 Software Freedom Conservancy Inc.  
Copyright 2018 Michael Gratton <mike@vee.net>