wiki:BuildingGtk

Version 47 (modified by mrobinson@webkit.org, 9 years ago) (diff)

Made required build steps more prominant

Building WebKitGTK+

Dependencies

WebKitGTK+ currently depends on unreleased versions of GLib and libsoup. We have set up a repository with these packages for Debian / Ubuntu systems. You must add this repository to your apt sources list:

If you are using an x86_64 installation run:

sudo apt-add-repository 'deb http://people.debian.org/~kov/webkit/amd64 ./'

If you are using an normal 32-bit x86 installation use this:

sudo apt-add-repository 'deb http://people.debian.org/~kov/webkit/i386 ./'

Following is a list of Debian packages necessary for building WebKitGTK+. Although the names of the packages are probably different in non-Debian-based distributions, it should be fairly easy to find the alternative names. This list should be kept up to date.

  • autoconf
  • automake
  • autotools-dev
  • bison (>= 2.4.1)
  • flex
  • gperf
  • glib-networking
  • gtk-doc-tools
  • libenchant-dev
  • libgail-dev (>= 1.8)
  • libgeoclue-dev
  • libglib2.0-dev (>= 2.25)
  • libgstreamer-plugins-base0.10-dev
  • libgtk2.0-dev (>= 2.10)
  • libicu-dev
  • libjpeg62-dev
  • libpango1.0-dev (>= 1.16)
  • libpng12-dev
  • libsoup2.4-dev (>= 2.33.1.20101209)
  • libsqlite3-dev
  • libtool
  • libxslt-dev
  • libxt-dev

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). MacPorts users can get the dependencies via:

$ sudo port install webkit-gtk

Getting the source

To get the WebKitGTK+ source, please follow the instructions on the 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.

Launching the build

Once you have successfully checked the source out of the repository, simply run:

$ WebKitTools/Scripts/build-webkit --gtk

This will build WebKit in the directory WebKitBuild/Release. Once the build finishes, you can run a simple demo browser by executing:

$ WebKitTools/Scripts/run-launcher --gtk

To build a debug build of WebKitGTK+ (which will contain debugging symbols useful for generating stack traces), you can pass the --debug argument to build-webkit. This will build WebKit in WebKitBuild/Debug and all other scripts should take the --debug argument as well.

$ WebKitTools/Scripts/build-webkit --gtk --debug
$ WebKitTools/Scripts/run-launcher --gtk --debug

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.