使用桌面项文件

语言：

桌面项文件是提供有关菜单中项的信息的数据文件。桌面项文件指定项（如名称、要执行的命令、图标等）的详细信息。桌面项文件还包含决定项在菜单分层结构中的位置的关键字。桌面项文件必须位于 $XDG_DATA_DIRS/applications 目录中，并且必须具有 .desktop 文件扩展名。

搜索缺省路径以解析 .desktop 文件的位置的顺序如下：

在 $XDG_DATA_HOME/applications 目录中搜索。如果未设置 $XDG_DATA_HOME 环境变量，则在 ~/.local/share/applications 缺省目录中搜索。
搜索 $XDG_DATA_DIRS 中每个目录的应用程序子目录。如果未设置 $XDG_DATA_DIRS 环境变量，则在 /usr/share/applications 缺省目录中搜索。
如果找到多个同名的 .desktop 文件，则优先使用找到的第一个文件。

以下示例提供了一个桌面项文件示例。

[Desktop Entry]
Encoding=UTF-8
Name=Calculator
Name[fr]=Calculatrice
...
Comment=Perform calculations
Comment[fr]=Effectue des calculs compliq

ue
...
Exec=gcalctool
Icon=accessories-calculator
Terminal=false
Type=Application
StartupNotify=true
Categories=GNOME;GTK;Utility;Calculator

下表介绍了桌面项文件中的一些重要键。有关桌面项文件的更多信息，请参见 XDG Desktop Entry Specification（XDG 桌面项规范）。

表 3-3 桌面项键

桌面项键	说明
`Categories`	指定说明项的关键字。各个关键字使用分号 (`;`) 分隔。有关标准类别关键字的列表，请参见 http://www.freedesktop.org/Standards/menu-spec 上的桌面菜单规范。要查明如何使用匹配规则（通过 Categories 键）将桌面项映射到菜单，请参见Working With Menu Definition Files。
`Comment`	指定项的简短说明。注释会在指向菜单中的项时作为工具提示显示。
`Encoding`	指定桌面项文件的编码。
`Exec`	指定从菜单中选择项时要执行的命令。
`Icon`	指定表示项的图标的文件名。不指定文件名的路径和文件扩展名。
`MimeType`	指定应用程序可以处理的 MIME 类型。
`Name`	指定项的名称。该名称显示在菜单中的项上。
`NoDisplay`	指定不应在菜单中显示现有应用程序。
`Terminal`	指定 `Exec` 键中的命令是否在终端窗口中运行。如果值为 `true`，则命令在终端窗口中运行。如果命令不打开窗口并运行，则必须将该键的值设置为 `true`。
`Type`	指定项的类型。`Type` 键可以具有以下值之一： `Application`：启动某个应用程序的项。 `Link`：链接到某个文件或文件夹或者某个远程资源（如 FTP 站点或 Web 页）的项。 `FSDevice`：作为文件系统设备的项。 `Directory`：作为文件夹的项。

有关桌面项文件中的键的更多信息，请参见 desktop entry specification（桌面项规范）。

注 - 面板启动程序和桌面对象也使用桌面项文件。用于启动程序和桌面对象的桌面项文件提供的信息与用于菜单中的项的桌面项文件提供的信息是相同的。例如，桌面项文件提供当用户选择启动程序或对象时要运行的命令。