Make sure you have git installed, and then clone the GTK git repository using the following command in the directory you wish to have the GTK repository:
git clone https://github.com/GNOME/gtk.git
This will create a gtk directory in your current directory. Enter this directory once git has finished downloading all the files.
You can see which versions are available to checkout by typing:
git branch -a
This will list all available branches. Pick the branch with the version of GTK that you want. For example, if I wanted to checkout GTK3.12, it would usually look like this:
git checkout gtk-3-12
Alternatively, if you need micro version support (i.e. you want to check out GTK3.12.2 instead of GTK3.12.4), then use git checkout like so:
git checkout 3.12.2
Note that after you switch branches, you need to do a git clean to remove any changes between branches. Run this command:
git clean -xdf #d=directory, f=force, x=clean ignored files
When in the parent gtk directory, run the following commands in order, after each one stops executing:
./autogen.sh ./configure make
For more detailed configuration/compilation options, see Leo's guide here.
Once make has finished running, you will have a .libs directory in the /gtk/gtk/ directory. This is useful for running SWT snippets or Eclipse apps using a specific version of GTK. It is wise to copy the entire gtk parent directory to another directory, so you do not have to compile that GTK version again. For example, I keep my various compiled versions in a folder named:
Dealing with make build failures
Building GTK can be a tricky. You may run into the following issues:
Build failure due to missing packages
The build can fail if you are missing certain packages.
For example make may fail with:
gcc: error: /usr/lib/rpm/redhat/redhat-hardened-cc1: No such file or directory
In such cases you can do the following to resolve the build issues:
- Google the error message/file. Ex google "redhat-hardened-cc1: No such file or directory. You often bump into threads that tell you which packages to install.
- Use dnf to find out which package contains the necessary file:
sudo dnf provides '*/redhat-hardened-cc1'
Incorrect versions of libraries
You may run into error messages during configuration about some of your libraries being too old. To resolve this issue, the easiest way is to upgrade your Fedora (or other linux distro) to the newest or beta versions (rawhide).
Use compiled GTK libraries with SWT snippets
To find out how to run SWT snippets with the compiled GTK, see this section in the SWT GTK development guide.