Gaphor sur macOS

La dernière version de Gaphor peut être téléchargée à partir de la page de téléchargement de Gaphor. Gaphor peut également être installé en tant que Homebrew cask.

Les versions antérieures sont disponibles sur GitHub.

CI builds sont également disponibles.

Environnement de développement

Mise à jour des instructions relatives à l’environnement de développement :

  1. Installer Homebrew

  2. Ouvrez un terminal et exécutez :

brew install python3 gobject-introspection gtk4 gtksourceview5 libadwaita adwaita-icon-theme graphviz

Installer Poetry en utilisant pipx :

pipx install poetry

Ensuite, clonez le dépôt, après quoi vous pouvez exécuter les commandes suivantes pour installer l’environnement de poésie :

cd gaphor
poetry install
poetry run pre-commit install

Maintenant, vous pouvez exécuter gaphor en tant que

poetry run gaphor

Si PyGObject ne compile pas et se plaint d’un fichier ffi.h manquant, vous pouvez installer la librairie libffi depuis Homebrew, définir la variable d’environnement suivante et relancer poetry install :

brew install libffi
export PKG_CONFIG_PATH=$(brew --prefix libffi)/lib/pkgconfig
poetry install

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
        }
    ]
}

Conditionnement pour macOS

Afin de créer un paquet d’installation exe pour macOS, nous utilisons PyInstaller qui analyse Gaphor pour trouver toutes les dépendances et les regrouper dans un seul dossier.

  1. Suivez les instructions relatives à la mise en place d’un environnement de développement ci-dessus

  2. Ouvrez un terminal et exécutez la commande suivante à partir du répertoire du référentiel :

poetry run python po/build-babel.py
poetry install --with packaging
poetry run poe package