summaryrefslogtreecommitdiffstats
path: root/INSTALL
blob: 82526c933e0e4f3be7c9347c336a4c8167762731 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

    Building & Installing Geary
    ---------------------------

  * Building

    To build Geary, run the following commands:

        $ ./configure
        $ make

    By default, Geary will install under /usr/local.  The configure script can
    customize the prefix directory.  Run ./configure --help for instructions
    and other installation options.


  * Dependencies

    Building Geary requires Vala 0.22.1 or higher with a full GObject
    introspection repository, intltool, cmake, desktop-file-validate, and
    xml2po.  Vala's vapigen must be installed as well.

    The developer packages and headers for the following libraries are also
    required when building Geary:

      * canberra
      * gee-0.8
      * gio-2.0
      * glib-2.0
      * gmime-2.6
      * gtk+-3.0
      * libsecret-1
      * libxml-2.0
      * notify
      * sqlite3
      * 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' package
    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.


  * Installing dependencies on Fedora

    Fedora 20 ships with the correct version of Vala.  Install it by running
    this command:

        $ sudo yum install vala

    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 \
            glib2-devel gmime-devel gtk3-devel libnotify-devel sqlite-devel \
            unique3-devel webkitgtk3-devel libsecret-devel libxml2-devel \
            vala-tools


  * Installing dependencies on Ubuntu

    Ubuntu 14.04 ships the correct version of Vala.  In Ubuntu versions prior
    to 14.04, you must add the Vala PPA first by running these commands:

        $ sudo add-apt-repository ppa:vala-team/ppa
        $ 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 \
            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

    You should check that you are using the right version of valac by running:

        $ valac --version
        Vala 0.22.1

    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

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

        $ ./geary

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


  * Installing

    After Geary has built, run the following command to install it:

        $ sudo make install

    To uninstall, run:

        $ sudo make uninstall


    Copyright 2012-2014 Yorba Foundation