Gaphor dans un conteneur¶

Au lieu de mettre en place un environnement de développement local, la manière la plus simple de contribuer au projet est d’utiliser les Codespaces de GitHub.

Espaces de code GitHub¶

Procédez comme suit pour ouvrir Gaphor dans un espace de codage :

Naviguez vers https://github.com/gaphor/gaphor
Cliquez sur le menu déroulant Code et sélectionnez l’option Open with Codespaces.
Sélectionnez + New codespace en bas du volet.

Pour plus d’informations, consultez la documentation GitHub.

Accès à distance à la fenêtre graphique de Gaphor avec Codespaces¶

Lorsque vous utilisez les Codespaces, il est probable que vous souhaitiez également interagir avec la fenêtre graphique de Gaphor.

Cette opération est facilitée dans Gaphor par l’utilisation d’un conteneur appelé desktop-lite. Cette fonctionnalité est activée par défaut dans le fichier devcontainer.json de Gaphor.

Notez les valeurs webPort/vncPort et mot de passe. Elles seront utilisées dans les étapes suivantes.

    		"desktop-lite": {
			"password": "vscode",
			"webPort": "6080",
			"vncPort": "5901"
		},

Deux options sont possibles :

Utilisation d’une visionneuse VNC locale¶

Téléchargez et installez la visionneuse VNC de votre choix (par exemple, realvnc)
Spécifiez le nom de l’hôte distant comme localhost et le port comme 5901 et connectez-vous à VNC. Le numéro de port doit être le même que celui spécifié dans l’attribut vncPort
Lors du débogage/exécution Gaphor, la fenêtre graphique familière devrait s’afficher dans la vue VNC

Utilisation de la visionneuse noVNC sur le navigateur¶

Ceci est basé sur l’application noVNC
Ouvrez le navigateur sur votre machine locale et donnez l’adresse http://127.0.0.1:6080/. Le numéro de port doit être le même que celui spécifié dans l’attribut webPort
Une fenêtre noVNC s’ouvre, cliquez sur Connect et fournissez le mot de passe vscode. Le mot de passe doit être le même que celui spécifié dans l’attribut password
Lors du débogage/exécution Gaphor, la fenêtre graphique familière devrait être affichée dans la vue noVNC sur le navigateur