David King
davidk@gnome.org 2014
Lucas Lommer
llommer@svn.gnome.org 2009.
Marek Černocký
marek@manet.cz 2015.

# Instalace souboru .desktop

# Spuštění vaší aplikace

Napiště a nainstalujte soubor .desktop, aby uživatelé mohli vaši aplikaci najít a spustit.

GNOME používá k popisu spouštěčů aplilací položky pracovní plochy podle freedesktop.org a specifikací nabídky pracovní plochy. Instalace souboru .desktop je standardní způsob, jak zaregistrovat svou aplikaci v GNOME a dalších pracovních prostředích.

Soubor .desktop specifikuje spustitelný soubor vaší aplikace, její název a typ. Navíc může uvádět její ikonu, popis a některé další doplňující informace ohledně spuštění aplikace.

Pro hypotetickou aplikaci My Application by mohl soubor .desktop vypadat nějak takto:

# myapplication.desktop

[Desktop Entry] Name=My Application Exec=myapplication Type=Application Icon=myapplication Comment=Do the thing that the application does Categories=GTK;GNOME;Utility;

Řádek `[Desktop Entry]` říká, že se jedná o soubor .desktop. Následují jednotlivé klíče, které popisují, jak spustit aplikaci. Klíč `Name` je název aplikace přívětivý pro člověka a zobrazuje se v uživatelském rozhraní. Klíč se sepustitelným souborem je `Exec` a může být uveden včetně celé cesty nebo jen jako název souboru a pak se vyhledává v cestách podle `PATH`. Posledním povinným klíčem je `Type`, který má pro aplikaci vždy hodnodu `Application`. Ostatní typy jsou uvedeny ve specifikaci souborů .desktop.

Ostatní pole v souboru .desktop jsou volitelná, ale doporučená. Aplikace by měla mít nainstalovanou ikonu a název ikony (bez přípony) uvést v klíči `Icon`. `Comment` je stručný popis aplikace. Při hledání aplikace může uživateli pomoci klíč `Categories` šířený se seznamem kategorií oddělených středníkem podle specifikace nabídky pracovní plochy.

Ve specifikaci položky pracovní plochy je uvedeno a popsáno i několik dalších klíčů, které je možné do souboru .desktop přidat.