epiphany-logo.png

GNOME Web

A simple, clean, beautiful view of the web


Development Resources

Epiphany Technology Preview

Epiphany Technology Preview is the recommended way for developers to run Epiphany. It is, of course, our equivalent to Safari Technology Preview. Unlike Safari TP, where both Safari and WebKit are updated once every other week, for us Epiphany is updated nightly, while WebKit is updated on a less-regular (usually monthly) basis.

Development Tips

There are must-read tips for newcomers in the HACKING file at the toplevel of the source tree.

Getting Involved

This is a step-by-step guide for getting involved with the Epiphany development. If you are new to GNOME development and need some guidance, make sure to also visit the Newcomers page.

Step 1: Join #epiphany channel on irc.gnome.org

This is where people talk about Epiphany and where you can ask questions when you need to find out how to do something or want to decide what to work on next. The etiquette of IRC is such that you don't need to say "hi" when you join and you can lurk in the channel for a while until you have a specific question or want to share your view in a discussion. So just joining a channel is pretty non-committal.

Step 2: Building Epiphany

The recommended way of building and testing Epiphany is to use BuildStream. Follow our BuildStream introduction to learn how to build a GNOME application. For example, once you have BuildStream and have cloned gnome-build-meta, change into the gnome-build-meta source directory and run:

$ bst build --track-all core/epiphany.bst

Keep in mind that there are many dependencies and some of them are quite large (like WebKit), so the entire process can take a while.

To make changes to Epiphany, you'll want to open a workspace:

$ bst workspace open core/epiphany.bst ~/Projects/epiphany

To open a shell for running Epiphany or performing incremental builds:

$ bst shell --build core/epiphany.bst

Step 3: Bugzilla

If you'd like to report a bug or a feature request, use the GNOME Bugzilla tracker.

Fixing bugs in WebKit can be difficult, so newcomers are encouraged to start by working on bugs with the GTK+ user interface around the web view instead. We have a list of easy newcomer bugs to get started on. If you run into trouble or need help getting started, ask for help on #epiphany or epiphany-list.

Step 4: Contact

In addition to IRC, there are other ways to keep up with the project, such as the mailing list, Bugzilla updates, and commit updates. You can browse or subscribe to them as you decide on your level of involvement in the project. Beyond the Epiphany project, Planet GNOME is an aggregator of blogs of people involved with GNOME in general and is a good place to find out what people are working on and what other projects are out there.

Apps/Web/Development (last edited 2018-04-06 00:03:43 by MichaelCatanzaro)