Aller au contenu

02. Règles d'Acceptation du Bucket gui

Navigation : Documentation > Chartes de Contribution > Règles Bucket GUI

Sommaire

  1. Critères d'Éligibilité
  2. Exigences Techniques Obligatoires
  3. Configuration des Raccourcis (shortcuts.toml)
  4. Sous-système Windows GUI
  5. Nettoyage lors de la Désinstallation

Le bucket gui regroupe les applications dotées d'une interface graphique fenêtrée (IDE, navigateurs, outils multimédias, clients de bases de données, etc.).

1. Critères d'Éligibilité

  1. Nature Graphique : L'application doit instancier une fenêtre de bureau native (Win32/WPF, GTK, Qt, Cocoa/AppKit, Electron, Tauri).
  2. Licence Libre ou Reconnue : Les applications doivent être sous licence open source. Les applications propriétaires à usage commercial relèvent du bucket commercial.
  3. Extraction Propre sans Installateur Système Lourd : L'archive doit contenir l'exécutable portable ou permettre une extraction directe sans déclencher un installeur MSI ou InnoSetup nécessitant des privilèges root ou administrateur.

2. Exigences Techniques Obligatoires

2.1 Configuration des Raccourcis (parts/shortcuts.toml)

Tout paquet dans gui doit obligatoirement activer et renseigner le module shortcuts.toml :

[shortcuts]
enabled = true
name = "Nom Convivial de l'Application"
binary = "app.exe"
icon = "resources/app.ico"
categories = ["Development", "Utility"]
comment = "Description courte pour le lanceur d'applications"
  • Sous Windows : Génération automatisée du raccourci .lnk dans le Menu Démarrer.
  • Sous Linux : Génération du fichier Freedesktop .desktop dans ~/.local/share/applications/.
  • Sous macOS : Création du lanceur bundle dans ~/Applications/.

2.2 Sous-système Windows GUI

Le binaire ou le trampoline généré pour Windows doit impérativement déclarer le sous-système WINDOWS (et non CONSOLE), afin d'éviter l'apparition d'une console d'invite de commande noire lors du double-clic ou du lancement depuis le menu Démarrer.

2.3 Nettoyage lors de la Désinstallation

La désinstallation du paquet doit obligatoirement purger les raccourcis créés sans laisser d'icônes mortes sur le bureau ou dans le menu de l'utilisateur.