Підручник по пакуванню

Створення Flatpak програми, яка вже упакована у Fedora, включає два кроки. Спочатку потрібно повторно зібрати RPM програми разом із усіма залежностями, які не включено до середовища виконання. Потім потрібно створити контейнер з цієї програми. У контексті Fedora, flatpaks - це лише інша форма контейнера, яка оброблюється подібно до Docker-контейнерів, які використовуються для серверних програм.

Так само як і для пакунків, інструкції щодо збирання RPM flatpak та контейнерів зберігаються в git за посиланням https://src.fedoraproject.org , а збирання координуються https://koji.fedoraproject.org. Flatpak для програми може бути знайдений за посиланням https://src.fedoraproject.org в репозиторії flatpaks/<application>; це сховище git містить файл container.yaml, які визначають, як пакунок перетворюється в контейнер Flatpak.

Налаштування

Встановлення необхідних інструментів:

$ 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

(Можливо, вам доведеться вийти з облікового запису і увійти до нього знову.)

Додайте віддалене сховище тестових пакунків flatpak Fedora:

$ 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

Та встановити Fedora Flatpak Runtime, якщо вона ще не встановлена:

$ 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

Цим файлом container.yaml можна скористатися без змін, але часто виникає потреба у внесенні до нього змін.

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.

Робимо локальну збірку

$ 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.

Тестування

Якщо встановлення вдалося, тепер ви можете зробити:

$ flatpak run fi.skyjake.Lagrange

Щоб спробувати.

src.fedoraproject.org запит

Будь-ласка запросіть нове сховище Git наступним чином:

$ fedpkg request-repo --namespace=flatpaks <програма>

Importing your flatpak content

Після того, як сховище було створене:

$ 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

Збирання у Koji

First build the packages:

$ flatpak-module build-rpms --auto

Якщо це завершиться успішно, тоді ви можете зробити:

$ flatpak-module build-container

Тестування збірки

Щоб встановити останню вдалу збірку від Koji, запустіть:

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

Створення оновлення

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.

Перейдіть на сторінку https://bodhi.fedoraproject.org/updates/new та введіть flatpak NVR під Candidate Builds (ігноруйте "Пакети"). Введіть текст у розділі "Оновити нотатки" наприклад “Initial Flatpak of <application>” та натисніть <Submit>.

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