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:

<file>myapplication.desktop</file> [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.