{{tag>sysadmin software linux freedesktop icone lanceur bureau}}

 
====== Création d'un icône (lanceur) pour un bureau virtuel Linux ======

La plupart des environnements graphiques proposant des bureaux virtuels peuvent utiliser le format proposé par le projet freedesktop (desktop entry) pour la création de lanceur d’application disposé sur le bureau ou dans les menus. C'est le cas de Gnome et de KDE.


Pour illustrer pas à pas la création d'un lanceur, On crée ici un lanceur pour l'application Freecad téléchargée sur l’hôte au format [[sysadmin/linux/format_appimage|AppImage]].


S'il n'existe pas, créer le répertoire pour stocker les icônes (fichiers au formant PNG 512x512)

<code bash>
# Création d'un répertoire pour stocker les icônes
mkdir ~/.local/share/icons

# Place l’icône dans le répertoire dédié
mv /tmp/FreeCAD-logo.svg ~/.local/share/icons/
</code>

Créer un fichier d'extension .desktop dans le répertoire ''~/.local/share/applications''. Le contenu du fichier ''.desktop'' peut être relativement simple :

<file>
[Desktop Entry]

Type=Application
Version=1.0

Name=FreeCAD-0.21.2-Linux-x86_64.AppImage

Comment=DAO Freecad 0.21.2 (AppImage)

# NB : Utiliser des chemins absolus
# Executables et ses arguments
Exec=/home/yoann/Applications/FreeCAD-0.21.2-Linux-x86_64.AppImage

# Icône associé au lanceur
Icon=/home/yoann/.local/share/icons/FreeCAD-logo.svg

# Describes whether this application needs to be run in a terminal or not
Terminal=false
</file>

La documentation officielle fournit la [[https://specifications.freedesktop.org/desktop-entry-spec/1.5/recognized-keys.html|liste des attributs (keys) disponibles]].

Placer le droit d'exécution sur le fichier:

<code bash>
chmod u+x FreeCAD-0.21.2.desktop
</code>

===== Les catégories =====

L'application lancée peut être associée à une ou plusieurs catégories/sous-catégories (entrée ''Categories''). Les catégories préexistent et leur nom est sensible à la casse : [[https://specifications.freedesktop.org/menu-spec/1.0/category-registry.html|Liste exhaustive des catégories]].

===== Vérifier la syntaxe =====

<code bash>
desktop-file-validate FreeCAD-0.21.2.desktop
</code>

Invoquer **update-desktop-database** pour que les modifications apportées soient prises en compte:
<code bash>
update-desktop-database ~/.local/share/applications
</code>


===== Exécuter un fichier .desktop depuis le terminal =====

<code bash>
gtk-launch /path/to/application.desktop
</code>



===== Dépannage =====

Sous GNOME Shell, lorsque l'application est lancée, son icône n'est pas représentée dans la barre de dock : une roue crantée apparaît à la place. Voir la note [[sysadmin:linux:gui:icone-application-manquante-dans-dock-gnome|Icône de l'application manquante dans le dock de Gnome]].

===== Références =====

  * [[https://stackoverflow.com/questions/119031/how-to-set-my-applications-desktop-icon-for-linux-kde-gnome-etc|Comment créer son lanceur sous KDE ou Gnome (stackoverflow.com) ]]
  * [[https://www.freedesktop.org/wiki/| wiki du standard freedesktop (freedesktop.org) ]]
  * [[https://specifications.freedesktop.org/desktop-entry-spec/latest/index.html|Spécifications du fichier .desktop (freedesktop.org) ]]
  * [[https://www.devdungeon.com/content/create-linux-desktop-launch-icon|Créer un icône de lanceur (devdungeon.com)]]
  * [[https://wiki.archlinux.org/title/Desktop_entries| Application entry (archlinux) ]]