Linux Desktop Entry 文件深入解析

1.Desktop Entry 文件標準簡介

在 Windows 平臺上,用戶可以通過點擊位於桌面或菜單上的快捷方式輕鬆打開目標應用程序。現代 Linux 桌面系統也提供了此項功能。目前,Linux KDE 和 Linux GNOME 桌面系統都使用 Desktop Entry 文件標準來描述程序啓動配置信息。Desktop Entry 文件標準是由 FreeDesktop.org(http://freedesktop.org/wiki/) 制定的,目前最新的版本是"Desktop Entry Specification 1.0"[1]。

2.Desktop Entry文件

圖1 Linux GNOME 應用程序瀏覽器
圖1 Linux GNOME 應用程序瀏覽器

Desktop Entry 文件以".desktop"爲後綴名。以 Linux GNOME 桌面系統爲例,用戶打開應用程序瀏覽器後(見圖1)會看見很多應用程序快捷方式。事實上,每個應用程序快捷方式都和一個 Desktop Entry 文件相對應。這些 Desktop Entry 文件通常被存放在 /usr/share/applications/ /opt/gnome/share/applications/ 等目錄下。從文件瀏覽器進入這些目錄,點擊相應的 Desktop Entry 文件同樣可以啓動相對應的應用程序。

假設當前"/usr/share/applications/"目錄下有一文件"cbt.desktop",用任意文件編輯軟件(如 vi 或 gedit)打開"cbt.desktop",將得到如下內容:

清單1 "cbt.desktop"文件內容
[Desktop Entry]
Version = 1.0
Encoding = UTF-8
Name = Quick Start Tour
GenericName = User Tutorial
Comment = Computer Based Training tutorial to \
     guide and help you learn how to use the Desktop
Exec = 
gnome-open /usr/share/doc/manual/sled-gnome-cbt_en/index.html
Icon = cbt
StartupNotify = true
Terminal = false
Type = Application
Categories = GNOME;Application;Documentation;
OnlyShowIn = GNOME;
X-SuSE-translate = true
Name[cs] = Rychlá prohlídka systému
Comment[cs] = V?ukov? program seznamující u?ivatele 
       se základy pracovního prost?edí
GenericName[cs] = U?ivatelsk? tutoriál
Name[hu] = Rendszerbemutató
Comment[hu] = A munkaállomés használatát bemutató segédlet
GenericName[hu] = Felhasználói segédlet

本文將在下一節中結合上述"cbt.desktop"文件內容重點解析 Desktop Entry 的文件結構。讀者可以從中深入領會上述各條語句的具體含義。

3.Desktop Entry 文件結構

Desktop Entry 文件通常以字符串"[Desktop Entry]"開始。由清單 1 可以得知,Desktop Entry 文件的內容是由若干{關鍵字,數值}配對的 Entry 組成的。例如,"Version"就是一個關鍵字,關鍵字"Version"對應的數值是"1.0"。Desktop Entry 文件標準定義了一系列標準關鍵字。標準關鍵字分爲必選和可選兩種:必選標準關鍵字必須在 .desktop 文件中被定義;而可選關鍵字則不必。以下是對重點關鍵字的解析。

  • 關鍵字"Version":[可選] 該數值指定了當前 Desktop Entry 文件所遵循的 Desktop Entry 文件標準版本。

  • 關鍵字"Encoding":[1.0 版本不推薦使用] 該數值指定了當前 Desktop Entry 文件中特定字符串所使用的編碼方式。儘管Desktop Entry 文件標準 1.0 不再推薦使用該關鍵字,但由於歷史原因該關鍵字仍然廣泛出現在現有的 Desktop Entry 文件中。

  • 關鍵字"Name":[必選]
    該數值指定了相關應用程序的名稱。比如在清單1中關鍵字"Name"的數值是"Quick Start Tour"。打開文件瀏覽器,進入"/usr/share/applications"目錄,就可以看見"cbt.desktop"文件所定義的快捷方式的顯示樣式,如圖2所示。其中,快捷方式的顯示名稱由關鍵字"Name"的數值所決定,快捷方式所使用的圖標由下文中將要介紹的關鍵字"Icon"的數值來決定。當然,這些定義在應用程序瀏覽器中同樣適用,請參考圖3。

    圖2 "cbt.desktop"文件在文件瀏覽器中的顯示樣式
    圖2 cbt.desktop 文件在文件瀏覽器中的顯示樣式


  • 關鍵字"GenericName":[可選]
    該數值指定了相關應用程序的通用名稱。比如在清單1中關鍵字"GenericName"的數值是"User Tutorial"。打開應用程序瀏覽器,就可以看見字符串"User Tutorial"被顯示在圖標的右側,如圖3所示:

    圖3 "cbt.desktop"文件在應用程序瀏覽器中的顯示樣式
    圖3 cbt.desktop 文件在應用程序瀏覽器中的顯示樣式


  • 關鍵字"Comment":[可選]
    該數值是對當前Desktop Entry的簡單描述。

  • 關鍵字"Type":[必選]
    關鍵字"Type"定義了Desktop Entry文件的類型。常見的"Type"數值是"Application"和"Link"。"Type = Application"表示當前Desktop Entry文件指向了一個應用程序;而"Type = Link"表示當前Desktop Entry文件指向了一個URL (Uniform Resource Locator)。

  • 關鍵字"Exec":[可選]
    關鍵字"Exec"只有在"Type"類型是"Application"時纔有意義。"Exec"的數值定義了啓動指定應用程序所要執行的命令,在此命令是可以帶參數的。在本例中,關鍵字"Exec"的數值是字符串"gnome-open /usr/share/doc/manual/sled-gnome-cbt_en/index.html"。在shell中輸入該字符串並按回車鍵同樣可以啓動指定應用程序。

  • 關鍵字"URL":[可選]
    關鍵字"URL"只有在"Type"類型是"Link"時纔有意義。"URL"的數值定義了該Desktop Entry文件指向的URL。例如:

    清單2 "Type = Link"類型Desktop Entry文件示例

    Type = Link
    URL = http://www.ibm.com/developerworks

    雙擊含有上述內容的Desktop Entry文件將啓動web瀏覽器,並打開指定網頁"http://www.ibm.com/developerworks",運行結果請參考圖4。


  • 關鍵字"Icon":[可選]
    該數值定義了當前Desktop Entry文件在應用程序瀏覽器或是在文件瀏覽器中所顯示的圖標。如果關鍵字"Icon"的數值是以絕對路徑的格式給出,那麼其數值所指定圖標文件將被使用;反之,Linux系統將使用"Icon Theme Specification"[2]在系統指定圖標目錄下定位所需要使用的圖標文件。比如在本例中關鍵字"Icon"的數值是"cbt",它實際對應着系統指定圖標目錄下的圖片文件"cbt.png"cbt.png。該圖片作爲圖標的顯示效果如圖2,圖3所示。

  • 關鍵字"StartupNotify":[可選]
    關鍵字"StartupNotify"的數值是布爾值(true 或是 false)。該關鍵字只有在"Type"類型是"Application"時纔有意義。其數值的含義由規範"Startup Notification Protocol Specifications"[3]定義,在此不再詳述。

  • 關鍵字"Terminal":[可選]
    和"StartupNotify"一樣,關鍵字"StartupNotify"的數值也是布爾值,並且該關鍵字只有在"Type"類型是"Application"時纔有意義。其數值指出了相關應用程序(即關鍵字"Exec"的數值)是否需要在終端窗口中運行。本文將在下一節中給出關鍵字"Terminal"的具體使用方法。

  • 關鍵字"Categories":[可選]
    關鍵字"Categories"只有在"Type"類型是"Application"時纔有意義。"Categories"的數值指出了相關應用程序在菜單中顯示的類別。具體菜單分類由規範"Desktop Specification Menu"具體定義[4]。

  • 關鍵字"OnlyShowIn"和"NotShowIn":[可選]
    這兩個關鍵字分別定義了當前Desktop Entry是否在特定Linux 桌面系統(例如:Linux GNOME 或 Linux KDE)下顯示(由"OnlyShowIn"定義),或不顯示(由"NotShowIn"定義)。具體定義請參考"Desktop Specification Menu"[4]。

  • 關鍵字"X-SuSE-translate":[SUSE Linux特有]
    關鍵字"X-SuSE-translate"是SUSE Linux(http://www.novell.com/linux/)特有的。"X-SuSE-translate"符合SUSE RPM Package風格。"X-SuSE-translate"數值表示是否要對關鍵字"Name"和"GenericName"進行翻譯。詳情請參考"SUSE Package Conventions"[5]。

  • 本地化關鍵字"[LOCALE]"
    根據"Desktop Entry Specification"規範[1],在關鍵字後加上字符串"[LOCALE]"就可以對該關鍵字進行特定的本地化定義。"LOCALE"的合法取值爲:

    LOCALE= lang_COUNTRY.ENCODING@MODIFIER

    在此,域"_COUNTRY",".ENCODING"和"@MODIFIER"是可以被忽略的。當指定Desktop Entry文件被解析時,解析器應當根據當前POSIX locale來正確獲取本地化的關鍵字數值。例如清單1就分別定義了在"cs"和"hu"語言環境下關鍵字"Name","Comment"和"GenericName"的不同數值。


  • 其餘關鍵字
    除了上述在清單1中出現的關鍵字外,"Desktop Entry Specification"還定義了"Hidden","TryExec","MimeType"等可選關鍵字。用戶可以根據需要進行選取。

4.分析運行 Desktop Entry 文件

Desktop Entry文件是一種常見的Linux文件格式,很多Linux程序需要對該種文件提供支持。在此,本文給出分析運行 Desktop Entry 文件的基本編成思路。

4.1 分析 Desktop Entry 文件內容

操作 Desktop Entry 文件的第一步是獲取文件的內容。假設有一 Desktop Entry 文件,其路徑信息存儲在變量 pPath 中:

const char* pPath;

下列代碼將把該文件內容讀入內存"buffer"中。

清單3 讀取 Desktop Entry 文件內容
int file_size = 0;
char *file_contents = NULL;
char *buffer = NULL;

if( eel_read_entire_file ( pPath, &file_size, &file_contents ) == GNOME_VFS_OK )
{
    buffer = (char *)g_realloc ( file_contents, file_size + 1 );
    buffer[file_size] = '\0';
}
else
{
    return 1;
}

獲取 Desktop Entry 文件內容後,就可進一步分析文件內容。在此,分析的重點是獲取關鍵字"Type","Exec"/"URL",以及"Terminal"的數值。首先定義結構 DestopEntryType:

清單4 DestopEntryType 結構定義
enum DestopEntryType
{
    Application, // Type = Application
    Link,             // Type = Link
    Unknown
};

下列程序將提取關鍵字"Type","Exec"/"URL"和"Terminal"的數值,並把這些數值分別存儲在變量"type","uri"和"bTerminal"中。

清單5 獲取關鍵字"Type","Exec"/"URL",以及"Terminal"數值
DestopEntryType type = Unknown;
char *uri = NULL;
bool bTerminal = false;

GnomeDesktopItem *desktop_file;

desktop_file = gnome_desktop_item_new_from_string( NULL, buffer, file_size,
(GnomeDesktopItemLoadFlags)0, NULL );
if ( !desktop_file )
{
    g_free( buffer );
    return 1;
}

const char *strType = gnome_desktop_item_get_string( desktop_file, "Type" );
if ( !strType )
{
    g_free( buffer );
    gnome_desktop_item_unref ( desktop_file );
    return 1;
}

if ( 0 == strcmp( strType, "Application" ) )    //type = Application
{
    const char *exec_str = gnome_desktop_item_get_string( desktop_file, "Exec" );
    if( !exec_str )
    {
        g_free( buffer );
        gnome_desktop_item_unref( desktop_file );
        return 1;
    }
   uri = g_strdup( exec_str );
    type = Application;

    const char *strTerminal = gnome_desktop_item_get_string( desktop_file, "Terminal" );
    if ( strTerminal )
    {
        if ( 0 == strcmp( "true", strTerminal ) )
            bTerminal = true;
        else
            bTerminal = false;
    }
}
else if(strcmp(strType, "Link") == 0)    //type = Link
{
    uri = g_strdup( gnome_desktop_item_get_string( desktop_file, "URL" ) );
    type = Link;
}

    g_free( buffer );
    gnome_desktop_item_unref( desktop_file );

4.2 運行"Type = Application"類型Desktop Entry文件

有了關鍵字"Type","Exec"和"Terminal"的數值,就可如下運行Desktop Entry文件。

清單6 運行"Type = Application"類型Desktop Entry文件
if ( type == Application )
{
    if( bTerminal )
        eel_gnome_open_terminal_on_screen( uri, NULL );
    else
        eel_gnome_shell_execute_on_screen( uri, NULL);
    g_free( uri );
    return 0;
}

4.3 運行"Type = Link"類型Desktop Entry文件

有了關鍵字"Type","URL"和"Terminal"的數值,就可如下運行Desktop Entry文件。

清單7 運行"Type = Link"類型Desktop Entry文件
if ( type == Link )
{
    gnome_url_show( uri, NULL );
    g_free( uri );
    return 0;
}

5.創建Desktop Entry文件實例

在這部分中,本文將給出創建Desktop Entry文件的兩個具體實例。這兩個實例的目標都是要創建自動訪問IBM DeveloperWorks網站的快捷方式,具體運行結果如圖4所示。這兩個實例將使用不同的方法實現這一目標。第一個實例將創建的文件類型是"Application"的Desktop Entry文件"VisitDeveloperWorks-Application.desktop";第二個實例將創建的文件類型是"Link" 的Desktop Entry文件"VisitDeveloperWorks-Link.desktop"。

圖4 "VisitDeveloperWorks-Application.desktop" / "VisitDeveloperWorks-Link.desktop"運行結果
圖4

5.1 創建"Type = Application"Desktop Entry文件實例

假設系統指定圖標目錄下存有圖片文件"gaim.png"gaim.png 。如圖5所示編輯文件"VisitDeveloperWorks-Application.desktop",並把結果存於"/usr/share/applications/"目錄下。

圖5 "VisitDeveloperWorks-Application.desktop"文件內容
圖5

該文件的核心內容是將應用程序圖標設置爲"gaim.png"文件,將Desktop Entry文件的類型設置爲"Application",並將應用程序所要執行的命令設置爲"firefox http://www.ibm.com/developerworks"。編輯完成後,在文件瀏覽器和應用程序瀏覽器下(如圖6所示)就可以看見該實例的顯示樣式。

圖6 "VisitDeveloperWorks-Application.desktop"文件在應用程序瀏覽器中的顯示樣式
圖6

5.2 創建"Type = Link"Desktop Entry文件實例

對上述"VisitDeveloperWorks-Application.desktop"文件進行如圖7所示的修改,並將文件更名爲"VisitDeveloperWorks-Link.desktop",保存於"/usr/share/applications/"目錄下。

圖7 "VisitDeveloperWorks-Link.desktop"文件內容
圖7

該文件的核心內容是將 Desktop Entry 文件的類型設置爲"Link",並將 Desktop Entry 文件指向的 URL 設置爲"http://www.ibm.com/developerworks"。編輯完成後,在文件瀏覽器下(如圖8所示)就可以看見該實例的顯示樣式。值得注意的是,由於該實例並不是一個應用程序,因此在應用程序瀏覽器下是看不到相應快捷方式的。

圖8 "VisitDeveloperWorks-Link.desktop"文件在文件瀏覽器中的顯示樣式
圖8

6.結束語

Desktop Entry文件是Linux KDE 和Linux GNOME桌面系統中標準的程序啓動配置描述方式。本文對該文件格式的定義和應用進行了深入的探討。欲求更詳細的使用和編程信息,請查找相關參考文獻。


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章