Flatpak¶
O Voluta pode ser distribuído como Flatpak para Linux, sem depender da distribuição ou das bibliotecas Qt instaladas no sistema.
Instalar o bundle¶
O bundle é publicado no GitHub Releases
a cada tag v*. Baixe voluta.flatpak e instale:
flatpak install --user voluta.flatpak
flatpak run io.github.dionarley.voluta
Também é possível iniciar a interface gráfica pelo menu de aplicativos do ambiente desktop.
Construir localmente¶
Pré-requisitos:
flatpakflatpak-builderappstreamdesktop-file-utils- acesso ao repositório Flathub
Adicione o Flathub e instale o runtime/SDK usados pelo manifesto:
flatpak remote-add --user --if-not-exists \
flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install --user -y flathub \
org.freedesktop.Platform//25.08 \
org.freedesktop.Sdk//25.08
Compile e gere o bundle:
flatpak-builder \
--user \
--assumeyes \
--force-clean \
--default-branch=stable \
--repo=repo \
build-dir \
flatpak/io.github.dionarley.voluta.yml
flatpak build-bundle repo voluta.flatpak io.github.dionarley.voluta stable
Instale e execute:
flatpak install --user -y --bundle voluta.flatpak
flatpak run io.github.dionarley.voluta
Testes do empacotamento¶
flatpak run io.github.dionarley.voluta --version
flatpak run --env=QT_QPA_PLATFORM=offscreen \
io.github.dionarley.voluta gui --smoke-test
O workflow Flatpak executa esses testes a cada push ou pull request que
altere o manifesto, o código-fonte, o pyproject.toml ou os assets nas branches
develop e main. Em tags v*, o bundle também é anexado ao GitHub Releases.
Estrutura do empacotamento¶
| Arquivo | Função |
|---|---|
flatpak/io.github.dionarley.voluta.yml |
manifesto do Flatpak |
flatpak/python3-requirements.json |
wheels Python fixadas com URL e SHA-256 |
flatpak/io.github.dionarley.voluta.desktop |
entrada do menu de aplicativos |
flatpak/io.github.dionarley.voluta.metainfo.xml |
metadados AppStream |
assets/voluta-icon.svg |
ícone escalável compartilhado com o README e o site |
flatpak/voluta.sh |
wrapper que executa python3 -m voluta |
O manifesto usa o runtime org.freedesktop.Platform 25.08 e instala as
dependências Python a partir de wheels manylinux. O PySide6 já inclui as
bibliotecas Qt necessárias; o runtime fornece as bibliotecas de sistema
básicas, como libGL, libxkbcommon, xcb e libX11.