Gaphor en Linux¶

Gaphor can be installed as Flatpak on Linux, some distributions provide packages. Check out the Gaphor download page for details.

Las versiones anteriores están disponibles en GitHub.

También están disponibles construcciones CI.

Entorno de desarrollo¶

Hay dos formas de configurar un entorno de desarrollo:

GNOME Builder, ideal para contribuciones «drive by».
Un entorno local.

GNOME Builder¶

Abra GNOME Builder 43 o más reciente, clone el repositorio. Compruebe si la Configuración activa está configurada como org.gaphor.Gaphor.json. Si es así, pulse el botón Ejecutar para iniciar la aplicación.

Un entorno local¶

Para configurar un entorno de desarrollo con Linux, primero necesita una versión de distribución de Linux bastante nueva. Por ejemplo, la última Ubuntu LTS o más reciente, Arch, Debian Testing, SUSE Tumbleweed, o similar. Gaphor depende de versiones más recientes de GTK, y no comprobamos la compatibilidad con versiones anteriores. También necesitará la última versión estable de Python. Para obtener la última versión estable sin interferir con la versión de Python de todo el sistema, le recomendamos que instale pyenv.

Instale primero pyenv prerrequisitos y, a continuación, instale pyenv:

curl https://pyenv.run | bash

Asegúrese de seguir las instrucciones al final del script de instalación para instalar los comandos en el archivo rc de su shell. A continuación instale la última versión de Python ejecutando:

pyenv install 3.x.x

Donde 3.x.x se sustituye por la última versión estable de Python (pyenv debería permitirte completar por tabuladores las versiones disponibles).

A continuación, instale los requisitos previos de Gaphor instalando las dependencias de gobject introspection y cairo build, por ejemplo, en 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

For Redhat/RPM/Fedora based systems:

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

Instale Poetry usando pipx:

pipx install poetry

Next, clone the repository, after which you need to execute the following consecutive commands:

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

Now, you can run gaphor as

poetry run gaphor

NOTA: Gaphor requiere GTK 4. Funciona mejor con GTK >=4.8 y libadwaita >=1.2.

Depuración con Visual Studio Code¶

Before you start debugging you’ll need to open Gaphor in vscode (the folder containing pyproject.toml). You’ll need to have the Python extension installed.

Create a file .vscode/launch.json with the following content:

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

GDK_BACKEND is added since VSCode by default uses XWayland (the X11 emulator).

Crear un paquete Flatpak¶

The main method that Gaphor is packaged for Linux is with a Flatpak package. Flatpak is a software utility for software deployment and package management for Linux. It offers a sandbox environment in which users can run application software in isolation from the rest of the system.

Distribuimos el Flatpak oficial usando Flathub, y la construcción de la imagen se realiza en el repositorio Gaphor Flathub.

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

Instalar el SDK de GNOME

flatpak install flathub org.gnome.Sdk 43

Clone el repositorio de Flathub e instale el SDK necesario:

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

Construir Gaphor Flatpak
```
make
```
Instalar el Flatpak
```
make install
```

Paquetes de distribución Linux¶

Se pueden encontrar ejemplos de archivos de especificaciones RPM de Gaphor y Gaphas en PLD Linux repositorio:

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

También hay un Arch User Repository (AUR) para Gaphor disponible para los usuarios de Arch.

No dude en ponerse en contacto con nosotros si necesita ayuda para crear un paquete Linux para Gaphor o Gaphas.