Building & Installing Geary 0.4

These instructions are for building Geary 0.4.x. See the INSTALL file if you're building from git.

Building

Fetch and extract the latest tarball from https://download.gnome.org/sources/geary/0.4/

To build, from the extracted folder run:

$ ./configure
$ make

Building Geary requires Vala 0.20.1 or higher with a full GIR repository, intltool, cmake, and desktop-file-validate.

The developer packages (headers) for the following libraries are also required when building any version of Geary:

  • canberra
  • gee-0.8
  • gio-2.0
  • glib-2.0
  • gmime-2.6
  • gtk+-3.0
  • libsecret-1
  • libxml-2.0
  • notify
  • sqlite3
  • unique-3.0
  • webkitgtk-3.0
  • messaging-menu (optional; enables support for Ubuntu Unity messaging menu)

  • unity (optional; enables support for Ubuntu Unity launcher)

Most of these are standard libraries available from major distros' repositories.

Geary requires WebKitGTK-3 1.10 or higher. However, it will not build with WebKitGTK-3 versions 2.1.1 to 2.1.90.0. See this ticket for more details.

Fedora

On Fedora 18, you can install build dependencies for Geary as follows:

$ sudo yum install vala gobject-introspection-devel intltool cmake \
    desktop-file-utils libcanberra-devel libgee-devel glib2-devel gmime-devel \
    gtk3-devel libnotify-devel sqlite-devel unique3-devel webkitgtk3-devel \
    libsecret-devel libxml2-devel

Ubuntu

In Ubuntu versions prior to 13.10, you can install Vala 0.20 from the Vala PPA, which you can add to your system as follows:

$ sudo add-apt-repository ppa:vala-team/ppa
$ sudo apt-get update
$ sudo apt-get upgrade

Ubuntu 13.10 already ships with the correct version of Vala.

In either case, you can obtain the dependencies for Geary with this command:

$ sudo apt-get install valac-0.20 libgirepository1.0-dev intltool cmake \
    desktop-file-utils libcanberra-dev libgee-0.8-dev libglib2.0-dev \
    libgmime-2.6-dev libgtk-3-dev libsecret-1-dev libxml2-dev libnotify-dev \
    libsqlite3-dev libunique-3.0-dev libwebkitgtk-3.0-dev libmessaging-menu-dev \
    libunity-dev

Note that Ubuntu 12.04 does not have all the dependencies to build Geary from git; here are some hints on getting everything installed.

You should check that you are using the right version of valac with the command valac --version:

Vala 0.20.1

The version number must be at least 0.20.1. If it reports an earlier version, run

$ sudo update-alternatives --config valac

and select 0.20 there.

Running

Once compiled, Geary can be run straight from the build directory:

$ ./geary

It will prompt for a username and a password. Geary will then fetch all the account folders and load the most recent messages from the Inbox.

Installation

After building, Geary can be installed with:

$ sudo make install

and removed with:

$ sudo make uninstall

Apps/Geary/BuildingInstalling (last edited 2014-01-07 21:44:08 by CharlesLindsay)