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 libgirepository1.0-dev libcairo2-dev libgtksourceview-5-dev

Instale Poetry usando pipx:

pipx install poetry

Clonar el repositorio.

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 config virtualenvs.in-project true
poetry install
poetry run gaphor

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

Debugging using Visual Studio Code#

Before you start debugging you’ll need to open Gaphor is 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#

El principal método de empaquetado de Gaphor para Linux es con un paquete Flatpak. Flatpak es una utilidad de software para el despliegue de software y la gestión de paquetes para Linux. Ofrece un entorno de aislamiento en el que los usuarios pueden ejecutar software de aplicación aislado del resto del sistema.

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.