INSTALL 2.78 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
Install them by running this command:
42

43 44
    sudo yum install meson vala \
        desktop-file-utils enchant2-devel folks-devel gcr-devel \
45 46
        glib2-devel gmime-devel gnome-online-accounts-devel \
        gspell-devel gtk3-devel iso-codes-devel json-glib-devel \
47 48 49
        libappstream-glib-devel libcanberra-devel libgee-devel \
        libhandy-devel libsecret-devel libunwind-devel libxml2-devel \
        libytnef-devel sqlite-devel webkitgtk4-devel
50

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

54
Install them by running this command:
55

56 57
    sudo apt-get install meson build-essential valac \
        desktop-file-utils iso-codes gettext libcanberra-dev \
58
        libappstream-glib-dev libenchant-dev libfolks-dev libgcr-3-dev libgee-0.8-dev \
59 60 61 62
        libglib2.0-dev libgmime-2.6-dev libgoa-1.0-dev libgspell-1-dev \
        libgtk-3-dev libjson-glib-dev libhandy-dev libsecret-1-dev \
        libsqlite3-dev libunwind-dev libwebkit2gtk-4.0-dev \
        libxml2-dev libytnef0-dev
63

64
And for Ubuntu Unity integration:
65

66
    sudo apt-get install libmessaging-menu-dev libunity-dev
67

68 69
Running
-------
70

71 72
If you wish to try Geary before installing it, you may execute it directly
from its build directory:
73

74
    ./build/src/geary
75

76 77
Note that certain desktop integration (such as being listed in an
application menu) requires full installation.
78

79 80
Installation
------------
81

82
After Geary has built, install it by invoking the install target:
83

84
    ninja -C build install
85

86
After installation, it can be uninstalled in the same way:
87

88
    ninja -C build uninstall
89

90 91 92
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:
93

94
    meson --prefix=/usr -C build
95

96 97 98
---
Copyright 2016 Software Freedom Conservancy Inc.  
Copyright 2018 Michael Gratton <mike@vee.net>