Gaphor on Linux¶
To setup a development environment with Linux, you first need the latest stable version of Python. In order to get the latest stable version, we recommend that you install pyenv. Install the pyenv prerequisites first, and then install pyenv:
$ curl https://pyenv.run | bash
Make sure you follow the instruction at the end of the installation script to install the commands in your shell’s rc file. Finally install the latest version of Python by executing:
$ pyenv install 3.x.x
Where 3.x.x is replaced by the latest stable version of Python.
Next install the Gaphor prerequisites by installing the gobject introspection and cairo build dependencies, for example, in Ubuntu execute:
$ sudo apt-get install -y python3-dev python3-gi python3-gi-cairo gir1.2-gtk-3.0 libgirepository1.0-dev libcairo2-dev
Install Poetry (you may want to consider installing poetry via pipx, instead of pip):
pip install --user poetry
$ cd gaphor $ poetry install $ poetry run gaphor
Create a Flatpak Package¶
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 offer a sandbox environment in which users can run application software in isolation from the rest of the system.
$ sudo apt-get install flatpak-builder
Install the GNOME SDK
$ flatpak install flathub org.gnome.Sdk 3.38
Clone the Flathub repository and install the necessary SDK:
git clone https://github.com/flathub/org.gaphor.Gaphor.git $ cd org.gaphor.Gaphor $ make setup
Build Gaphor Flatpak
Install the Flatpak
$ make install
Create an AppImage Package¶
AppImage is a format for distributing portable software on Linux without needing superuser permissions to install the application. The AppImage file is one executable which contains both Gaphor and Python. It allows Gaphor to be run on any AppImage supported Linux distribution without installation or root access.
We build our AppImage by first bundling Gaphor with PyInstaller and then converting it in to an AppImage.
Activate your virtualenv,
make update VERSION=x.x.x
Build the AppImage by running
Test that Gaphor-x86_64.AppImage works by running