[[PageOutline]]

= Building WebKitGTK+ =

== Getting the source ==

To get the WebKitGTK+ source, please follow the instructions on the [http://webkit.org/building/checkout.html WebKit page]. Many WebKit developer also use git to interact with the repository and the WebKit developer tools have strong support for git. [http://trac.webkit.org/wiki/UsingGitWithWebKit] contains tips for using git with WebKit.

== Dependencies == 

''Note: Aditional requirements may apply for running tests; see WebKitGtkLayoutTests.''

    1. '''Install the base WebKitGTK+ dependencies:'''
{{{
$ sudo apt-get install autoconf \
                       automake \
                       autotools-dev \
                       bison \
                       flex \
                       gail-3.0 \
                       gawk \
                       gperf \
                       gtk-doc-tools \
                       libenchant-dev \
                       libgail-dev \
                       libgail-3-dev \
                       libgeoclue-dev \
                       libgstreamer-plugins-base0.10-dev \
                       libgtk-3-dev \
                       libicu-dev \
                       libgl1-mesa-glx \
                       libgl1-mesa-dev \
                       libjpeg62-dev \
                       libpango1.0-dev \
                       libpng12-dev \
                       libsqlite3-dev \
                       libtool \
                       libxslt-dev \
                       libxt-dev

}}}

    2. '''Install the jhbuild module dependencies:'''
{{{
$ sudo apt-get install libgpg-error-dev icon-naming-utils
}}}

   3. '''Download and build all jhbuild modules:'''
{{{
$ Tools/Scripts/update-webkitgtk-libs
}}}

=== Building WebKitGTK+ ===
{{{
$ Tools/Scripts/build-webkit --gtk
}}}

== Notes ==

    * JHBuild configuration and module files are stored as `Tools/gtk/jhbuildrc` and `Tools/gtk/jhbuild.modules`.
    * If everything builds properly tests should typically pass on your system. Please file a bug if they do not.

=== Installation ===

To install the WebKit GTK+ library, simply change into the Release directory and issue 

{{{
$ make install 
}}}

The `configure` script also supports the different features WebKit/GTK+ provide (e.g., SVG filters and animation features, HTML5 Video element support, etc..). Simply issuing 

{{{
$ ./configure --help
}}}

on the command-line should give you a brief overview of what can be configured. Although you can build with these features enabled, it doesn't mean that the functionality is complete, let alone working properly. Feel free to submit a bug at http://bugs.webkit.org if you find something that is not working.

=== OS X ===

OS X: The code on Mac OS X should built like any Linux distribution, as long as you install the above build dependencies (in addition to an "ordinary build environment" that includes XCode Tools 2.3 or newer). [http://www.macports.org/ MacPorts] users can get the dependencies via:
{{{
$ sudo port install webkit-gtk
}}}

If you get an error about libjpeg when the build does the configuration step, you may find the following fixes it:
{{{
$ export CPPFLAGS="-I/opt/local/include"
$ export LDFLAGS="-L/opt/local/lib"
}}}