Jade Dungeon

linux 图形界面

desktop文件

例子：

Eclipse安装包解压在/home/yueru/programs/eclipse

对应在/usr/share/applications/目录下新建一个名为eclipse.desktop 

#!/usr/bin/env xdg-open
[Desktop Entry]
Version=2018.09
Type=Application
Categories=Development
Name=Eclipse
GenericName[zh_CN]=Eclipse
Terminal=false
NoDisplay=false
StartupWMClass=Eclipse
Exec=/home/yueru/programs/eclipse/eclipse
Icon=/home/yueru/programs/eclipse/icon.xpm

此时，当StartupWMClass为空时，启动应用会出现双图标

为了解决这个问题，首先打开应用，然后在终端输入： 

xprop |grep WM_CLASS

此时鼠标指针会变成一个十字准心，然后点击打开的应用，终端会反馈一条信息， 包括2个字符串 

WM_CLASS(STRING) = "sun-awt-X11-XFramePeer", "jetbrains-pycharm"

把第1个字符串里的内容添加到StartupWMClass里，保存， 关闭应用重新打开，将不会出现双图标的情况了

例子2：

/usr/share/appdata/vscodium.appdata.xml 

<?xml version="1.0" encoding="UTF-8"?>
<component type="desktop">
	<id>vscodium.desktop</id>
	<metadata_license>MIT</metadata_license>
	<project_license>MIT</project_license>
	<name>VSCodium</name>
	<url type="homepage">https://code.visualstudio.com</url>
	<summary>Visual Studio Code. Code editing. Redefined.</summary>
	<description>
		<p>Visual Studio Code is a new choice of tool that combines the simplicity of a code editor with what developers need for the core edit-build-debug cycle. See https://code.visualstudio.com/docs/setup/linux for installation instructions and FAQ.</p>
	</description>
	<screenshots>
		<screenshot type="default">
			<image>https://code.visualstudio.com/home/home-screenshot-linux-lg.png</image>
			<caption>Editing TypeScript and searching for extensions</caption>
		</screenshot>
	</screenshots>
</component>

/usr/share/applications/vscodium-url-handler.desktop 

[Desktop Entry]
Name=VSCodium - URL Handler
Comment=Code Editing. Redefined.
GenericName=Text Editor
Exec=/usr/share/vscodium/vscodium --open-url %U
Icon=com.visualstudio.code.oss
Type=Application
NoDisplay=true
StartupNotify=true
Categories=Utility;TextEditor;Development;IDE;
MimeType=x-scheme-handler/vscodium;
Keywords=vscode;
X-Desktop-File-Install-Version=0.23

/usr/share/applications/vscodium.desktop 

[Desktop Entry]
Name=VSCodium
Comment=Code Editing. Redefined.
GenericName=Text Editor
Exec=/usr/share/vscodium/vscodium --unity-launch %F
Icon=com.visualstudio.code.oss
Type=Application
StartupNotify=false
StartupWMClass=VSCodium
Categories=Utility;TextEditor;Development;IDE;
MimeType=text/plain;inode/directory;
Actions=new-empty-window;
Keywords=vscode;

X-Desktop-File-Install-Version=0.23

[Desktop Action new-empty-window]
Name=New Empty Window
Exec=/usr/share/vscodium/vscodium --new-window %F
Icon=com.visualstudio.code.oss

/usr/share/pixmaps/com.visualstudio.code.oss.png 














通常放置的位置



    

  • 
/usr/share/applications/


  • 
/opt/gnome/share/applications/


  • 
~/.local/share/applications





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




主要属性




"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"的数值来决定。





"GenericName"：[可选]





该数值指定了相关应用程序的通用名称。比如在清单1中关键字"GenericName"的数值是
"User Tutorial"。打开应用程序浏览器，就可以看见字符串"User Tutorial"被显示在图标
的右侧，





"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。



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





双击含有上述内容的Desktop Entry文件将启动web浏览器，并打开指定网页
"http://www.ibm.com/developerworks"，





"Icon"：[可选]





该数值定义了当前Desktop Entry文件在应用程序浏览器或是在文件浏览器中所显示的图标
。如果关键字"Icon"的数值是以绝对路径的格式给出，那么其数值所指定图标文件将被使用
；反之，Linux系统将使用"Icon Theme Specification"[2]在系统指定图标目录下定位所
需要使用的图标文件。比如在本例中关键字"Icon"的数值是"cbt"，它实际对应着系统指定
图标目录下的图片文件"cbt.png"cbt.png 。





"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"等可选关键字。用户可以根据需要进行选取。




分析文件




操作 Desktop Entry 文件的第一步是获取文件的内容。假设有一 Desktop Entry 文件，
其路径信息存储在变量 pPath 中：



const char* pPath;





下列代码将把该文件内容读入内存"buffer"中。



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：




enum DestopEntryType
{
    Application, // Type = Application
    Link,             // Type = Link
    Unknown
};





下列程序将提取关键字"Type"，"Exec"/"URL"和"Terminal"的数值，并把这些数值分别
存储在变量"type"，"uri"和"bTerminal"中。




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





有了关键字"Type"，"Exec"和"Terminal"的数值，就可如下运行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;
}





有了关键字"Type"，"URL"和"Terminal"的数值，就可如下运行Desktop Entry文件



if ( type == Link )
{
    gnome_url_show( uri, NULL );
    g_free( uri );
    return 0;
}





创建实例：





application例子：



[Desktop Entry]
Version=1.0
Encoding=UTF-8
Name=Visit DeveloperWorks Application
GenericName=A developer's website
Comment=Submit your paper
Icon=gaim
StartupNotify=true
Terminal=false
Type=Application
Exec=firefox http://www.ibm.com/developerworks
Categories=GNOME;Application;Documentation;
OnlyShowIn=GNOME;
X-SuSE-translate=true 





link例子：



[Desktop Entry]
Version=1.0
Encoding=UTF-8
Name=Visit DeveloperWorks Application
GenericName=A developer's website
Comment=Submit your paper
Icon=gaim
Type=Link
URL=http://www.ibm.com/developerworks
X-SuSE-translate=true





Gnome文件打开方式




文件打开方式主要配置以下文件里：




    

  • 
/etc/gnome/defaults.list


  • 
/usr/share/applications/mimeinfo.cache


  • 
~/.local/share/applications/mimeinfo.cache






程序alacarte可以管理Gnome的开始程序菜单。



			

			
			
			

				

					© 2015 jade-dungeon.net. 
					Valid CSS 
					& XHTML
				

				
Website template by Arcsin