2012-05-03 19:09:34 -07:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Building & Installing Geary
|
|
|
|
|
===========================
|
2012-05-03 19:09:34 -07:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Building
|
|
|
|
|
--------
|
2012-05-03 19:09:34 -07:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
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:
|
2012-05-03 19:09:34 -07:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
meson build
|
|
|
|
|
ninja -C build
|
2012-05-03 19:09:34 -07:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
A convenience Makefile for development only is also provided. To use
|
|
|
|
|
it, simply invoke make from the top-level directory.
|
2012-05-03 19:09:34 -07:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Dependencies
|
|
|
|
|
------------
|
2012-05-03 19:09:34 -07:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Building Geary requires the following major libraries and tools:
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
* GTK+ 3
|
|
|
|
|
* WebKitGTK+ 2
|
|
|
|
|
* SQLite 3
|
|
|
|
|
* Vala
|
2017-02-01 14:49:16 +11:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
See the `meson.build` file in the top-level directory for the complete
|
|
|
|
|
list of required dependencies and minimum versions.
|
2016-06-14 12:37:10 -04:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Geary also requires SQLite to be built with the compiler flag
|
2018-05-28 01:32:25 +10:00
|
|
|
`-DSQLITE_ENABLE_FTS3`.
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
All required libraries and tools are available from major Linux
|
|
|
|
|
distribution's package repositories:
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Installing dependencies on Fedora
|
|
|
|
|
---------------------------------
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2019-04-05 23:32:21 +11:00
|
|
|
Install them by running this command:
|
2017-10-23 12:17:21 +11:00
|
|
|
|
2019-04-05 23:32:21 +11:00
|
|
|
sudo yum install meson vala \
|
|
|
|
|
desktop-file-utils enchant2-devel folks-devel gcr-devel \
|
2019-05-24 13:50:35 +02:00
|
|
|
glib2-devel gmime-devel gnome-online-accounts-devel \
|
|
|
|
|
gspell-devel gtk3-devel iso-codes-devel json-glib-devel \
|
2019-06-03 10:31:52 +00:00
|
|
|
libappstream-glib-devel libcanberra-devel libgee-devel \
|
|
|
|
|
libhandy-devel libsecret-devel libunwind-devel libxml2-devel \
|
|
|
|
|
libytnef-devel sqlite-devel webkitgtk4-devel
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Installing dependencies on Ubuntu/Debian
|
|
|
|
|
----------------------------------------
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Install them by running this command:
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2019-04-05 23:32:21 +11:00
|
|
|
sudo apt-get install meson build-essential valac \
|
|
|
|
|
desktop-file-utils iso-codes gettext libcanberra-dev \
|
2019-06-03 10:31:52 +00:00
|
|
|
libappstream-glib-dev libenchant-dev libfolks-dev libgcr-3-dev libgee-0.8-dev \
|
2019-05-24 13:50:35 +02:00
|
|
|
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
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
And for Ubuntu Unity integration:
|
2017-02-01 14:49:16 +11:00
|
|
|
|
2019-04-05 23:32:21 +11:00
|
|
|
sudo apt-get install libmessaging-menu-dev libunity-dev
|
2017-02-01 14:49:16 +11:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Running
|
|
|
|
|
-------
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
If you wish to try Geary before installing it, you may execute it directly
|
|
|
|
|
from its build directory:
|
2017-02-02 20:47:22 +11:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
./build/src/geary
|
2017-02-02 20:47:22 +11:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Note that certain desktop integration (such as being listed in an
|
|
|
|
|
application menu) requires full installation.
|
2012-05-03 19:09:34 -07:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
Installation
|
|
|
|
|
------------
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
After Geary has built, install it by invoking the install target:
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
ninja -C build install
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
After installation, it can be uninstalled in the same way:
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
ninja -C build uninstall
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
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:
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
meson --prefix=/usr -C build
|
2014-01-07 10:38:11 -08:00
|
|
|
|
2018-02-11 10:25:27 +11:00
|
|
|
---
|
|
|
|
|
Copyright 2016 Software Freedom Conservancy Inc.
|
|
|
|
|
Copyright 2018 Michael Gratton <mike@vee.net>
|
