Gaphor avec Linux¶

Gaphor peut être installé sous forme de Flatpak sous Linux, certaines distributions fournissent des paquets. Consultez la page de téléchargement de Gaphor pour plus de détails.

Les versions antérieures sont disponibles sur GitHub.

CI builds sont également disponibles.

Environnement de développement¶

Il existe deux façons de mettre en place un environnement de développement :

GNOME Builder, idéal pour «engager des» contributions.
Un environnement local.

Constructeur GNOME¶

Ouvrez GNOME Builder 43 ou plus récent, clonez le dépôt. Vérifiez que le Build Profile (Profil de construction) est bien org.gaphor.Gaphor.json. Si c’est le cas, cliquez sur le bouton Run pour démarrer l’application.

Un environnement local¶

Pour mettre en place un environnement de développement sous Linux, vous devez disposer d’une version assez récente de la distribution Linux. Par exemple, la dernière version LTS d’Ubuntu, une version plus récente d’Arch, de Debian Testing ou de SUSE Tumbleweed, ou une version similaire. Gaphor dépend de versions plus récentes de GTK, et nous ne testons pas la compatibilité ascendante. Vous aurez également besoin de la dernière version stable de Python. Afin d’obtenir la dernière version stable sans interférer avec la version de Python de votre système, nous vous recommandons d’installer pyenv.

Installez d’abord les prérequis de pyenv, puis installez pyenv :

curl https://pyenv.run | bash

Assurez-vous de suivre les instructions à la fin du script d’installation pour installer les commandes dans le fichier rc de votre shell. Installez ensuite la dernière version de Python en exécutant :

pyenv install 3.x.x

Où 3.x.x est remplacé par la dernière version stable de Python (pyenv devrait vous permettre de sélectionner les versions disponibles à l’aide de tabulations).

Installez ensuite les prérequis de Gaphor en installant les dépendances gobject introspection et cairo build, par exemple, dans Ubuntu execute :

sudo apt-get install -y python3-dev python3-gi python3-gi-cairo \
gir1.2-gtk-4.0 libgirepository-2.0-dev libcairo2-dev libgtksourceview-5-dev \
graphviz

Pour les systèmes basés sur Redhat/RPM/Fedora :

sudo dnf install python3-devel cairo-gobject-devel gobject-introspection-devel graphviz

Installer Poetry en utilisant pipx :

pipx install poetry

Ensuite, clonez le dépôt, après quoi vous devez exécuter les commandes suivantes :

cd gaphor
# activate latest python for this project
pyenv local 3.x.x # 3.x.x is the version you installed earlier
poetry env use 3.x # ensures poetry /consistently/ uses latest major release
poetry install
poetry run pre-commit install

Maintenant, vous pouvez exécuter gaphor en tant que

poetry run gaphor

NOTE : Gaphor nécessite GTK 4. Il fonctionne mieux avec GTK >=4.8 et libadwaita >=1.2.

Débogage à l’aide de Visual Studio Code¶

Avant de commencer à déboguer, vous devez ouvrir Gaphor dans vscode (le dossier contenant pyproject.toml). Vous devez avoir installé l’extension Python.

Créez un fichier .vscode/launch.json avec le contenu suivant :

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Gaphor UI",
            "type": "python",
            "request": "launch",
            "module": "gaphor",
            "justMyCode": false,
            "env": {
                "GDK_BACKEND": "wayland"
            }
        }
    ]
}

GDK_BACKEND est ajouté car VSCode utilise par défaut XWayland (l’émulateur X11).

Créer un paquet Flatpak¶

La principale méthode de package de Gaphor pour Linux est un package Flatpak. Flatpak est un utilitaire logiciel de déploiement de logiciels et de gestion de packages pour Linux. Il offre un environnement sandbox dans lequel les utilisateurs peuvent exécuter des logiciels d’application indépendamment du reste du système.

Nous distribuons le Flatpak officiel en utilisant Flathub, et la construction de l’image est effectuée dans le dépôt Gaphor Flathub.

Installer Flatpak
Installer flatpak-builder
```
sudo apt-get install flatpak-builder
```

Installer le SDK GNOME

flatpak install flathub org.gnome.Sdk 43

Clonez le dépot Flathub et installez le SDK nécessaire :

git clone https://github.com/flathub/org.gaphor.Gaphor.git
cd org.gaphor.Gaphor
make setup

Construire Gaphor Flatpak
```
make
```
Installer le Flatpak
```
make install
```

Paquets de distribution Linux¶

Des exemples de fichiers de spécifications Gaphor et Gaphas RPM peuvent être trouvés dans PLD Linux dépôt :

https://github.com/pld-linux/python-gaphas
https://github.com/pld-linux/gaphor

Il existe également un Arch User Repository (AUR) for Gaphor disponible pour les utilisateurs d’Arch.

N’hésitez pas à nous contacter si vous avez besoin d’aide pour créer un paquet Linux pour Gaphor ou Gaphas.