Update and simplify INSTALL with current version reqs.

This commit is contained in:
Michael James Gratton 2016-06-14 12:37:10 -04:00
parent 56d0055f96
commit badbf94b0f

74
INSTALL
View file

@ -16,9 +16,20 @@
* Dependencies * Dependencies
Building Geary requires Vala 0.22.1 or higher with a full GObject Building Geary requires at least GTK+ version 3.14, WebKitGTK+ 2.4
introspection repository, intltool, cmake, desktop-file-validate, and and Vala 0.26, with a full GObject introspection repository,
xml2po. Vala's vapigen must be installed as well. intltool, cmake, desktop-file-validate, and xml2po. Vala's
vapigen must be installed as well.
See the file `src/CMakeLists.txt` for the complete list of minimum
version requirements.
Geary also requires SQLite to be built with the compiler flag
`-DSQLITE_ENABLE_FTS3`. Further, SQLite 3.11.x specifically must
also be built with `-DSQLITE_ENABLE_FTS3_TOKENIZER`. Most
distribution's packages meet these requirements, however Fedora 24
users and others may be required to rebuild SQLite 3.11 with the
second flag, or install SQLite 3.12 and recompile Geary.
The developer packages and headers for the following libraries are also The developer packages and headers for the following libraries are also
required when building Geary: required when building Geary:
@ -42,69 +53,36 @@
Most of these are standard libraries available from major distros' package Most of these are standard libraries available from major distros' package
repositories. 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
<https://bugzilla.gnome.org/show_bug.cgi?id=713168> for details.
Geary requires SQLite to be built with the compiler flag
`-DSQLITE_ENABLE_FTS3`. Further, SQLite version 3.11.x specifically
must also be built with `-DSQLITE_ENABLE_FTS3_TOKENIZER`. Most
distribution's packages meet these requirements, however Fedora
24 users and others may be required to rebuild SQLite 3.11 with
the second flag.
* Installing dependencies on Fedora * Installing dependencies on Fedora
Fedora 20 ships with the correct version of Vala. Install it by running Fedora 21 and later ships with the correct versions of the
this command: required libraries. Install them by running this command:
$ sudo yum install vala $ sudo yum install vala gobject-introspection-devel intltool cmake \
In Fedora versions prior to 20, you must install Vala from source.
Download and install the tarball from
<https://wiki.gnome.org/Projects/Vala/Release>.
You can install the rest of the build dependencies for Geary in any version
of Fedora by running this command:
$ sudo yum install gobject-introspection-devel intltool cmake \
desktop-file-utils gnome-doc-utils libcanberra-devel libgee-devel \ desktop-file-utils gnome-doc-utils libcanberra-devel libgee-devel \
glib2-devel gmime-devel gtk3-devel libnotify-devel sqlite-devel \ glib2-devel gmime-devel gtk3-devel libnotify-devel sqlite-devel \
unique3-devel webkitgtk3-devel libsecret-devel libxml2-devel \ unique3-devel webkitgtk3-devel libsecret-devel libxml2-devel \
vala-tools gcr-devel vala-tools gcr-devel
* Installing dependencies on Ubuntu * Installing dependencies on Ubuntu/Debian
Ubuntu 14.04 ships the correct version of Vala. In Ubuntu versions prior Ubuntu 15.10 (Wily) and Debian 8.5 (Jessie) and later ships with
to 14.04, you must add the Vala PPA first by running these commands: the correct versions of the required libraries. Install them by
running this command:
$ sudo add-apt-repository ppa:vala-team/ppa $ sudo apt-get install valac libgirepository1.0-dev intltool \
$ sudo apt-get update
You can install the build dependencies for Geary in Ubuntu by running this
command:
$ sudo apt-get install valac-0.20 libgirepository1.0-dev intltool \
cmake desktop-file-utils gnome-doc-utils libcanberra-dev \ cmake desktop-file-utils gnome-doc-utils libcanberra-dev \
libgee-0.8-dev libglib2.0-dev libgmime-2.6-dev libgtk-3-dev \ libgee-0.8-dev libglib2.0-dev libgmime-2.6-dev libgtk-3-dev \
libsecret-1-dev libxml2-dev libnotify-dev libsqlite3-dev \ libsecret-1-dev libxml2-dev libnotify-dev libsqlite3-dev \
libunique-3.0-dev libwebkitgtk-3.0-dev libmessaging-menu-dev \ libunique-3.0-dev libwebkitgtk-3.0-dev libmessaging-menu-dev \
libunity-dev libgcr-3-dev libunity-dev libgcr-3-dev
You should check that you are using the right version of valac by running: Ubuntu 14.04 (Trusty LTS) and 12.04 (Precise LTS) do not have all
the dependencies to build Geary. See
$ valac --version <https://wiki.gnome.org/Apps/Geary/BuildingOnUbuntu12.04> for
Vala 0.22.1 details and instructions.
If it reports anything less than 0.22.1, select the correct version when
running:
$ sudo update-alternatives --config valac
Note that Ubuntu 12.04 does not have all the dependencies to build Geary.
See <https://wiki.gnome.org/Apps/Geary/BuildingOnUbuntu12.04> for details
and instructions.
* Running * Running