Tutorial de empaquetado

Creating a Flatpak of an application that is already packaged in Fedora involves two steps. First you need to rebuild the application RPMs along with any dependencies which are not included in the runtime. Then you need to create a container out of the application. In the Fedora context, flatpaks are just another form of container, and are handled very similar to the Docker containers used for server applications.

Just as for packages, the instructions for building flatpak RPMs and containers are stored in git on https://src.fedoraproject.org and builds are coordinated by https://koji.fedoraproject.org. The flatpak for a an application can be found on https://src.fedoraproject.org in the repository flatpaks/<application>; this git repository contains a container.yaml file, which defines how the package is turned into a Flatpak container.

Ajustes

Instalar las herramientas necesarias:

$ sudo dnf install flatpak-module-tools

Make sure that your user is in the mock group (both local RPM builds and local container builds use mock).

$ sudo usermod -a -G mock $USER

(Puede que necesite salir y volver a entrar.)

Añadir a la prueba flatpak Fedora remota:

$ flatpak remote-add fedora-testing oci+https://registry.fedoraproject.org#testing

On Fedora, the testing remote should be already installed, but in disabled state. To enable it run:

$ flatpak remote-modify --enable fedora-testing

E instale el Fedora Flatpak Runtime si no lo ha instalado ya:

$ flatpak install fedora-testing org.fedoraproject.Platform/x86_64/f42

Creating `container.yaml`

$ mkdir lagrange && cd lagrange
$ flatpak-module init --flathub=lagrange lagrange

This generates an initial version of container.yaml. The --flathub=lagrange option searches Flathub for an application whose name or application ID matches lagrange, and uses the Flathub manifest to initialize container.yaml. If multiple matches are found, they are displayed, and you’ll need to re-run flatpak-module init with a more specific search string.

Let’s look at the container.yaml file.

container.yaml

flatpak:
    id: fi.skyjake.Lagrange
    branch: stable
    runtime-name: flatpak-runtime
    runtime-version: f42
    packages:
    - lagrange
    command: lagrange
    finish-args: |-
        --socket=wayland
        --socket=fallback-x11
        --socket=pulseaudio
        --share=ipc
        --share=network
        --device=dri
        --filesystem=xdg-download
        --filesystem=home:ro

This container.yaml file can be used as is, but often modifications are necessary.

If there is no existing build of the application on Flathub, you can omit the --flathub option to flatpak-module init. In this case you’ll need to pick an application ID and edit container.yaml.

Realizando una compilación local

$ flatpak-module build-rpms-local --auto
$ flatpak-module build-container-local --install

If building the RPMs succeeds but building the container fails, and you need to change container.yaml and try again, you can repeat just the last step.

Probando

Si la instalación es correcta, ahora puede hacer:

$ flatpak run fi.skyjake.Lagrange

Para probarlo fuera.

solicita src.fedoraproject.org

Solicite un repositorio Git nuevo como sigue:

$ fedpkg request-repo --namespace=flatpaks <aplicación>

Importing your flatpak content

Una vez que el repo haya sido creado:

$ mv <application> <application>.old
$ fedpkg clone flatpaks/<application>
$ cd <application>
$ cp ../application.old/container.yaml .
$ git add container.yaml
$ git commit -m "Initial import"
$ git push origin stable

Compilando en Koji

First build the packages:

$ flatpak-module build-rpms --auto

Si eso completa correctamente, entonces puede ir a:

$ flatpak-module build-container

Probando la construcción

Para instalar la última construcción lograda desde Koji, ejecute:

$ flatpak-module install --koji <application>-flatpak

Creando una actualización

Find the NVR of your Flatpak build - if you don’t have it in your terminal scrollback go to https://koji.fedoraproject.org/ and search in "Packages" for the <application>-flatpak name.

Vaya a https://bodhi.fedoraproject.org/updates/new e introduzca el flatpak NVR bajo Candidate Builds (descarta “Packages”). Introduzca texto bajo “Actualizar notas” como “Flatpak inicial de <aplicación>”, y pulse <Enviar>.

Want to help? Learn how to contribute to Fedora Docs ›