wiki:WebKitGTK

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

Added information about filing bugs against WebKitGTK

WebKitGTK+

The GTK+ port of WebKit is intended to provide a browser component for the portable Gtk+ UI toolkit. WebKitGTK+ is developed within the official WebKit SVN, so the codebase is unrelated to the classic Gtk+ WebCore, but WebKit GTK+ has superseded Gtk+ WebCore. The WebKit Buildbot provides continuous build and layouts tests. A semi-stable? branch exists to evaluate how to handle issues such as stability and security support.

Developers interested in using or contributing to the GTK+ port should be willing to get their hands dirty at this stage. Patches are welcome on the bug tracker and help is readily available at #webkit-gtk on irc.freenode.net and the mailing list for developers who want to learn the ropes.

Building

See the build instructions.

Getting Involved

Reporting Bugs

You can file a bug against WebKitGTK by using this template. Remember to include the version of WebKitGTK or revision number / commit hash that you are using the bug summary. It's very important to include a minimal, reproducible test case, whether it be a snippet of HTML or a bit of C code. The fine members of QtWebKit port have provided some excellent tips for good bug reports.

Distributions

The WebKit/GTK+ API follows a stable additions-only policy. The core engine is continually being stabilised and is suitable for most embedding tasks. Distributors should get in touch with the upstream maintainers to be sure they're packaging the correct version.

We adopt a versioning scheme similar to GTK+'s. This means that, having a version x.y.z, when y is odd, it's a development version. API is still not stable, and may change. When y is an even number, we are in a stable release, which gets only fixes, and small improvements, while keeping API compatibility. When API bits are deprecated for a full release cycle, we drop them.

Debian

Debian Unstable provides experimental WebKit/GTK+ packages by Mike Hommey.

Debian has organised a packaging team for WebKit:

Gentoo

Gentoo have an ebuild for WebkitGTK in testing: http://bugs.gentoo.org/show_bug.cgi?id=190347. You will have to add the testing keyword to your '/etc/portage/package.keywords' file in order to install the package.

# echo 'net-libs/webkit-gtk ~arch' >> /etc/portage/package.keywords

Please remember to change ~arch to the architecture you're using (~x86, ~amd64). The GTK+ port of WebKit is named webkit-gtk. I would invite you to look at the USE flags of the ebuild and add it to the packages.use file depending of your preferences. You can now emerge it normally:

# emerge -va webkit-gtk

You can then regularly update to the latest reviewed revision, which usually belongs to a new nightly build:

# emerge -u webkit-gtk

Lunar-Linux

Lunar provides an experimental/development module for WebKit/GTK+. It can be found in the moonbase in the experimental (zbeta) section under the name 'WebKit.'

Further links