kozorizki/gaphor
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
gaphor/docs/linux.md
Arjan Molenaar 6e24bd4148
Remove venv file and update documentation
2021-02-18 09:18:05 +01:00

3.3 KiB
Raw Blame History

Gaphor on Linux

Development Environment

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

Clone the repository.

$ 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.

We distribute the official Flatpak using Flathub, and building of the image is done at the Gaphor Flathub repository.

  1. Install Flatpak

  2. Install flatpak-builder

    $ sudo apt-get install flatpak-builder

  3. Install the GNOME SDK

    $ flatpak install flathub org.gnome.Sdk 3.38

  4. 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

  5. Build Gaphor Flatpak

    $ make

  6. 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.

  1. Activate your virtualenv, poetry shell

  2. cd appimage

  3. make update VERSION=x.x.x

  4. Build the AppImage by running make all

  5. Test that Gaphor-x86_64.AppImage works by running make run

Linux Distribution Packages

Examples of Gaphor and Gaphas RPM spec files can be found in PLD Linux repository:

Please, do not hesitate to contact us if you need help to create a Linux package for Gaphor or Gaphas.