Linux 版 Gaphor¶

Gaphor可在Linux系统中以Flatpak形式安装，部分发行版还提供了软件包。详情请查看Gaphor下载页面。

旧版发布文件可从GitHub获取。

CI构建也可供使用。

开发环境¶

开发环境可通过以下两种方式配置：

GNOME Builder —— 特别适合"即兴贡献"的开发环境。
本地开发环境.

GNOME Builder（GNOME 集成开发环境）¶

请打开 GNOME Builder 43 或更高版本，并克隆代码仓库。检查 Build Profile 是否设置为 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

请确保按照安装脚本末尾的说明，将相关命令添加至您Shell终端的 rc 配置文件中。接着执行以下命令安装最新版 Python：

pyenv install 3.x.x

其中 3.x.x 应替换为 Python 的最新稳定版本（pyenv 支持通过 Tab 键自动补全可用的版本号）。

接下来通过安装GObject Introspection和Cairo的构建依赖项来安装Gaphor的先决条件，例如，在Ubuntu系统中执行：

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

使用pipx安装Poetry :

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 进行调试¶

开始调试前，需在 VS Code 中打开 Gaphor 项目目录（包含 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· 是因为 VS Code 默认使用 XWayland（X11 模拟器）。

创建 Flatpak 软件包¶

Gaphor 在 Linux 系统上的主要打包方式是 Flatpak 软件包。 Flatpak 是一款面向 Linux 的软件部署与包管理工具，它能提供沙箱运行环境，使应用程序与系统其他部分隔离运行。

我们通过 Flathub分发官方 Flatpak 软件包，镜像构建工作则在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 发行版软件包¶

您可以在 PLD Linux的仓库中找到 Gaphor 和 Gaphas 的 RPM spec 文件示例。

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

Arch Linux 用户还可通过Arch User Repository (AUR) for Gaphor获取 Gaphor。

如您需要为 Gaphor 或 Gaphas 创建 Linux 软件包，请随时联系我们。