macOS 版 Gaphor

最新版本的Gaphor可从Gaphor下载页面下载。Gaphor也可作为 Homebrew cask安装。

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

CI构建 也可供使用。

开发环境

要在 macOS 上搭建开发环境：

1. 安装 Homebrew

2. 打开终端并执行：

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

使用pipx安装Poetry :

pipx install poetry

接下来，克隆代码仓库，之后可依次执行以下命令来安装Poetry环境：

cd gaphor
poetry install
poetry run pre-commit install

现在，您可以运行 Gaphor，方法是：

poetry run gaphor

如果 PyGObject 编译失败并提示缺少ffi.h 文件，您可能需要通过 Homebrew 安装 libffi，然后设置以下环境变量并重新运行 poetry install 命令：

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

使用 Visual Studio Code 进行调试

在开始调试之前，你需要在VSCode中打开Gaphor（包含pyproject.toml的文件夹）。你需要安装Python扩展。

创建 .vscode/launch.json 文件，内容如下：

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

macOS 平台打包指南

为创建适用于 macOS 的 exe 安装包，我们采用 PyInstaller 工具。该工具会分析 Gaphor 的所有依赖项，并将其打包至单个文件夹中。

1. 请按照上述开发环境配置说明进行操作

2. 打开终端，并在代码仓库目录中执行以下命令：

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