David King
davidk@gnome.org 2014
Daniel Nylander
po@danielnylander.se 2007
Anders Jonsson
anders.jonsson@norsjovallen.se 2017, 2018

# Installera en desktop-fil

# Kör ditt program

Skriv och installera en desktop-fil så att användare kan upptäcka och köra ditt program.

GNOME använder freedesktop.orgs specifikationer Desktop Entry och Desktop Menu för att beskriva programstartare. Att installera en desktop-fil är standardsättet att registrera ditt program med GNOME och andra skrivbord.

En desktop-fil listar din programs binärfil, namn och typ, och kan även lista en ikon, beskrivning och diverse annan information om att köra ditt program.

För ett tänkt program Mitt program, skulle en desktop-fil se ut som följer:

# mittprogram.desktop

[Desktop Entry] Name=Mitt program Exec=mittprogram Type=Application Icon=mittprogram Comment=Gör saken som programmet gör Categories=GTK;GNOME;Utility;

Raden `[Desktop Entry]` indikerar att detta är en desktop-fil. Den följs av nycklar som beskriver programstartaren. Nyckeln `Name` är programmets namn för mänsklig konsumtion, vilket kommer att visas i användargränssnittet. Programmets binärfil listas i nyckeln `Exec`, antingen den fullständiga sökvägen eller en binärfil som slås upp i `PATH`. Den sista obligatoriska nyckeln är `Type`, vilken alltid är `Application` för program. Alternativa typer finns listade i desktop entry-specifikationen.

Andra fält i desktop-filen är valfria, men rekommenderas. Program bör installera en ikon, och lista namnet på ikonen (utan filändelsen) i nyckeln `Icon`. `Comment` är en kort beskrivning av programmet. För att hjälpa användare då de bläddrar bland program bör nyckeln `Categories` fyllas i med en lista över kategorier, avskilda med semikolon, från Desktop Menu-specifikationen.

Det finns flera andra nycklar som kan läggas till i desktop-filer. Dessa finns listade och beskrivna i Desktop Entry-specifikationen.