Gaphor на Linux¶

Gaphor можна встановити як Flatpak на Linux, деякі дистрибутиви надають пакети. Перегляньте подробиці на сторінці завантаження Gaphor.

Старіші випуски доступні на GitHub.

Також доступні сборки CI.

Середовище розробки¶

Є два способи налаштувати середовище розробки:

GNOME Builder, ідеально підходить для внесків «проїздом».
Місцеве середовище.

GNOME Збірник¶

Відкрийте GNOME Builder 43 або новішої версії, клонуйте сховище. Перевірте, чи встановлено Профіль збірки на org.gaphor.Gaphor.json. Якщо так, натисніть кнопку Run, щоб запустити програму.

Місцеве середовище¶

Щоб налаштувати середовище розробки з Linux, вам спочатку потрібна досить нова версія дистрибутива Linux. Наприклад, остання версія Ubuntu LTS або новіша, Arch, Debian Testing, SUSE Tumbleweed або подібні. Gaphor залежить від нових версій GTK, і ми не тестуємо на зворотну сумісність. Вам також знадобиться остання стабільна версія Python. Щоб отримати останню стабільну версію без втручання у вашу системну версію Python, ми рекомендуємо вам встановити pyenv.

Спочатку встановіть pyenv передумови, а потім встановіть pyenv:

curl https://pyenv.run | bash

Переконайтеся, що ви дотримуєтесь інструкцій у кінці сценарію встановлення, щоб установити команди у файлі rc вашої оболонки. Далі встановіть останню версію Python, виконавши:

pyenv install 3.x.x

Де 3.x.x замінено останньою стабільною версією Python (pyenv має дозволити вам заповнювати доступні версії за допомогою вкладок).

Далі встановіть передумови Gaphor, встановивши залежності gobject introspection і cairo build, наприклад, у 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

Для систем на основі Redhat/RPM/Fedora:

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

Встановіть Poetry за допомогою pipx:

pipx install poetry

Далі клонуємо сховище, після чого потрібно виконати наступні послідовні команди:

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

Тепер ви можете запустити gaphor як

poetry run gaphor

ПРИМІТКА: Gaphor вимагає GTK 4. Він найкраще працює з GTK >=4.8 і libadwaita >=1.2.

Налагодження за допомогою Visual Studio Code¶

Перш ніж розпочати налагодження, вам потрібно відкрити Gaphor у vscode (тека, що містить pyproject.toml). Вам потрібно буде встановити розширення Python.

Створіть файл .vscode/launch.json з таким вмістом:

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

GDK_BACKEND додано, оскільки VSCode за замовчуванням використовує XWayland (емулятор X11).

Створіть пакет Flatpak¶

Основним способом пакування Gaphor для Linux є пакунок Flatpak. [Flatpak] (https://flatpak.org) - це програмна утиліта для розгортання програмного забезпечення та керування пакунками для Linux. Вона пропонує середовище пісочниці, в якому користувачі можуть запускати прикладне програмне забезпечення ізольовано від решти системи.

Ми розповсюджуємо офіційний Flatpak за допомогою Flathub, а створення образу виконується в репозиторії Gaphor Flathub.

Встановіть Flatpak
Встановити flatpak-builder
```
sudo apt-get install flatpak-builder
```

Встановіть GNOME SDK

flatpak install flathub org.gnome.Sdk 43

Клонуйте репозиторій Flathub і встановіть необхідний SDK:
```
git clone https://github.com/flathub/org.gaphor.Gaphor.git
cd org.gaphor.Gaphor
make setup
```
Збірка Gaphor Flatpak
```
make
```
Встановіть Flatpak
```
make install
```

Дистрибутивні пакети Linux¶

Приклади файлів специфікацій Gaphor і Gaphas RPM можна знайти в PLD Linux репозиторій:

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

Існує також репозиторій користувачів Arch (AUR) для Gaphor, доступний для користувачів Arch.

Будь ласка, не соромтеся звертатися до нас, якщо вам потрібна допомога у створенні пакета Linux для Gaphor або Gaphas.