Девід Кінг (David King)
davidk@gnome.org 2014

This work is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License.

За виняткових обставин власники авторських прав можу надати вам дозвіл копіювати, змінювати і розповсюджувати приклади коду, що містяться у цьому документі, за довільних умов, без обмежень.

Максим Дзюманенко
dziumanenko@gmail.com 2010
Юрій Чорноіван
yurchor@ukr.net 2020

# Встановлення файла desktop

# Команда для запуску цієї програми.

Напишіть і встановіть файл desktop, щоб користувачі могли знаходити і запускати вашу програму.

У GNOME використовуються специфікації стільничного запису freedesktop.org та стільничного меню для опису засобів запуску програм. Встановлення файла desktop є стандартним способом реєстрації вашої програми у GNOME та інших стільничних середовищах.

У файлі desktop визначається виконуваний файл вашої програми, її назва та тип. Ви також можете вказати піктограму, опис та деякі інші дані щодо запуску програми.

Для гіпотетичної програми My Application файл desktop має виглядати так:

# 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;

Рядок `[Desktop Entry]` вказує на те, що це файл desktop. За цим записом йдуть ключі, які описують засіб запуску програм. Ключ `Name` визначає зручну для читання назву програми, яку буде показано у інтерфейсі користувача. Виконуваний файл програми зазначають у ключі `Exec`. Можна вказати або шлях повністю, або просто назву виконуваного файла, якщо він зберігається в одному з каталогів змінної середовища `PATH`. Останнім обов'язковим ключем є `Type`. Його значенням для програм завжди є `Application`. Інші типи наведено у списку специфікації записів desktop.

Інші поля у файлі desktop є необов'язковими, але рекомендованими. Програми мають встановлювати піктограму і вказувати назву піктограми (без суфікса) за допомогою ключа `Icon`. У ключі `Comment` має бути наведено короткий опис програми. Для полегшення навігації програмами у ключі `Categories` можна вказати список категорій, відокремлених крапкою з комою, зі специфікації стільничного меню.

До файлів desktop можна додати декілька інших ключів, список і опис яких наведено у специфікації стільничних записів.