Build the Project

To contribute to a project, it is first necessary to set up a development environment with the latest version. This will allow you to make changes, test them, and create patches. This tutorial describes how to do this using Flatpak and an IDE called Builder. This is the recommended method for new contributors, and is the easiest way to get started.

If you would prefer to use the command line or a different IDE, an experimental developer command line tool is available. It is also possible to use JHBuild, GNOME's build tool for system components and apps that doesn't support Flatpak.

Get Flatpak

Flatpak is a technology for installing and distributing applications. This tutorial requires Flatpak version 0.9.2, which is available in most distributions. Installing it is usually just a matter of installing the flatpak package.

Note for Ubuntu users: Install a package called 'tracker', it will be necesary for most of the apps.

Note: Once you install or update Flatpak, restart your system for it to work properly. Even if it seems to work, restart your system.

See the Flatpak website for details on how to install it on a wide range of distributions.


Meet Builder

Builder allows you to download and build GNOME applications. It uses Flatpak to compile and run your project in a sandbox. To get started, download Builder using the button below:

Once Builder has been downloaded you can install it. If you have GNOME Software 3.22.7 or newer, you can just double click on the Builder flatpakref file. Otherwise, run the following in the terminal:

flatpak install ~/Downloads/gnome-builder.flatpakref -y

Once it has been installed, Builder can be launched in the same way that you launch other applications. It's now time to build your project!

Download and Build a Project

Builder allows you to easily download and build the project that you want to work on. To do this, just follow these instructions:




Note: You will need to close all instances of the app before running it from Builder.

That's it! Now that you have the project built and can run it, we can start looking into fixing bugs.

Newcomers/BuildProject (last edited 2017-07-20 12:49:39 by CarlosSoriano)