dnrops
/
gimp
mirror of https://github.com/GNOME/gimp.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
gimp/build/linux/flatpak
History
Bruno Lopes e96494d5a3 build/linux: Re-enable ccache in Flatpak builds 
The move to Clang in 85ed2847 didn't take into account caching,
Now, this is fixed or, better saying, reintroduced(?): e545116b

Also, flatpak-builder output was confined to the .log file to make
possible checking the end of the CI output, which was being cut.
 		2024-05-02 08:58:29 -03:00
..
README.md gitlab-ci, build: Unify Debian jobs and add AppImage artifact 2024-04-18 20:54:49 -03:00
meson.build gitlab-ci, build: Unify Debian jobs and add AppImage artifact 2024-04-18 20:54:49 -03:00
org.gimp.GIMP-nightly.json.in build/linux: Re-enable ccache in Flatpak builds 2024-05-02 08:58:29 -03:00
remove-future-appdata-release.xslt gitlab-ci, build: Unify Debian jobs and add AppImage artifact 2024-04-18 20:54:49 -03:00

README.md

GIMP Flatpak HowTo

Stable and Development releases

The Flathub repository hosts our stable and development point releases: https://github.com/flathub/org.gimp.GIMP

We recommend to look at the README.md file in respectively the master or beta branches of this repository to know more about release procedures.

Nightly builds

Flathub does not host nightly builds, therefore we publish them on GNOME's Nightly repository. Our "nightlies" are actually "weeklies" through a Gitlab job schedule named "Flatpak nightly".

This job will build whatever is on GIMP's repository master branch (this branch should be kept buildable and usable at all time, not only for scheduled jobs, but also for all contributors to be able to improve GIMP at all time).

The nightly manifest file is: build/linux/flatpak/org.gimp.GIMP-nightly.json.in

This file should remain as close as possible to the development manifest (org.gimp.GIMP.json file on the beta branch of the Flathub repository) which itself should remain as close as possible to the stable manifest (org.gimp.GIMP.json file on the master branch of the Flathub repository), since the nightly manifest is meant to become beta eventually, which itself is meant to become stable eventually.

Base rule to update the nightly build manifest:

  • Regularly org.gimp.GIMP-nightly.json should be diffed and synced with development and stable org.gimp.GIMP.json, in particular for all the dependencies (which are mostly the same across all 3 builds).
  • A merge request with the label 5. Flatpak package will contain the flatpak job, hence allowing theoretically to build a standalone flatpak (without being published to the nightly repository) for MR code. In practice, jobs have an 1-hour timeout and our flatpak takes longer than 1 hour to build (there is an exception in our repository, but only for the master branch), so we often need to publish to master after mostly a visual review.

Maintaining the manifests

  • GIMP uses Flatpak's GNOME runtime, which contains a base of libraries, some of which are dependencies of GIMP. While both the stable and development versions should use the latest stable runtime version, the nightly manifest uses the master version, which is more of a rolling release.

  • Other GIMP dependencies which are not available in the GNOME runtime should be built along as modules within GIMP's flatpak. Check format in org.gimp.GIMP-nightly.json and add modules if necessary. For more options, check flatpak builder's manifest format.

  • On the other hand, if we increased the runtime version in particular (or when the master runtime evolves), some modules may no longer be necessary and can be removed from our manifest.

    A flatpak is a layered set of modules. Our GIMP build in particular is built over the GNOME runtime, itself built over the Freedesktop runtime, itself based on a yocto-built image. Other than by trial and error, you can find the installed dependencies by running:

flatpak run --devel --command=bash org.gnome.Sdk//master

Or if you already have a build:

flatpak run --devel --command=bash org.gimp.GIMP//master

Inside the flatpak sandbox, GIMP's manifest can be read with:

 less /app/manifest.json

GNOME and Freedesktop's module lists (generated manifest as the SDK is built from BuildStream):

less /usr/manifest.json

  • Some sources have set a x-checker-data property which makes it possible to check for updates using flatpak-external-data-checker. To run the tool either install it locally, via flatpak or via OCI image.

    The OCI image is not straightforward at first but is the least intrusive if you already have docker or podman installed:

cd <path-to-gimp-repo>/flatpak/build
podman run --rm --privileged -v "$(pwd):/run/host:rw" ghcr.io/flathub/flatpak-external-data-checker:latest /run/host/org.gimp.GIMP-nightly.json

Our prefered backend for the checker is Anitya, a database maintained by the Fedora project. To set up a new dependency check by Anitya:

  1. verify it is available in the database: https://release-monitoring.org/
  2. then copy the project ID which is the number in the project URI within the database.
  3. Finally add a "x-checker-data" field within the "source" dictionary in the manifest with type "anitya", the "project-id" and a "url-template".
  4. We usually want to depend on stable releases only, i.e. set "stable-only to true. On exceptional cases, for very valid reasons only, we might bypass this limitation, adding a comment explaining why we use an unstable release.

  • For the development releases and nightly builds, we added the desktop-file-name-prefix property. For a stable release, the property line can be removed from the manifest.

  • For a stable release, set top "branch":"stable", and inside the "gimp", "babl" and "gegl" modules, set "tag" to the git tag (ex: GIMP_2_10_34) and "commit" to the git commit hash for this tag.

  • For a development release, set top "branch":"beta", and inside the "gimp", "babl" and "gegl" modules, set "tag" to the git tag (ex: GIMP_2_99_14) and "commit" to the git commit hash for this tag.

  • For a nightly build, set top "branch":"master", and inside the "gimp", "babl" and "gegl" modules, set "branch" to "master", and remove any "commit" line.