KDE上下文菜单的动态修改

KDE上下文菜单的动态修改

write by 九天雁翎(JTianLing) -- blog.csdn.net/vagrxie

讨论新闻组及文件

一、 提要

事实上静态改变KDE上下文菜单网上还有些资料（以E文为主），但是动态改变的我连E文的资料都没有看到，纯靠自己看代码摸索了。行文会比较乱，但是需要的人应该能找到自己所要的东西。文中复杂的行解释时会与KDE源代码相对应，以做备查。本文操作环境是kubuntu9.04

二、 静态修改

KDE中的上下文菜单是以.desktop形式的配置文件方式来管理的。此配置文件强大到甚至支持多语言-_-!牛吧

首先查看系统中此配置文件所在的位置。通过kde4-config –path services命令来查看，下面是我机器中运行的例子：

jtianling@jtianling-laptop:~$ kde4-config --path services

/home/jtianling/.kde/share/kde4/services/:/usr/share/kde4/services/

即有kde4 services配置的地方分别在/home/jtianling/.kde/share/kde4/services/这个个人的目录和/usr/share/kde4/services/这个改变全局配置的目录。这点符合Linux的习惯，在没有root权限或者仅仅想改变自己的操作习惯时，在自己的home目录下就能改变自己的配置，有root权限并且想改变所有用户的配置时，去/usr下面改。此处如是，这里全部以修改全局的为例。想尝试的推荐首先备份。

首先进入services目录下的ServiceMenus这个与上下文菜单相关的配置目录中去。

我们从一个简单的例子开始，下面是Kubuntu 9.04中自带的一个简单菜单项，类似于windows下常用的command prompt Here和cygwin的bash prompt here，作用是在当前文件夹位置打开一个konsole。对应的文件是konsolehere.desktop：

[Desktop Entry]
Type=Service
X-KDE-ServiceTypes=KonqPopupMenu/Plugin,inode/directory
Actions=openTerminalHere;
X-KDE-AuthorizeAction=shell_access

[Desktop Action openTerminalHere]
Name=Open Terminal Here
………
Name[zh_CN]=在此打开终端
Name[zh_TW]=在這裡開啟終端機
Icon=utilities-terminal
Exec=konsole --workdir %f
X-Ubuntu-Gettext-Domain=desktop_kdebase

一个一个解释一下：

配置的方式就与普通的ini文件类似，[]用于分段，xxx=yyy用于配置。这里解释一下配置选项。

Type=Service

官网说是类型默认为application，还解释application是有Exec行的东西（原话为：i.e. something with Exec line）需要指定Service表示类似于插件的东西，事实上我在我的机器上，将services目录所有的desktop文件全部统计了一下：

grep –R –e ‘Type=S’ * wc –l

一共有822个Service，但是

grep –R –e ‘Type=^S’

一个也没有，所以，直接将此行默认存在就完了。

X-KDE-ServiceTypes=KonqPopupMenu/Plugin,inode/directory

还是参考一有说明，KonqPopupMenu/Plugin表示是Konqueror的插件，inode/directory表示在指定目录或目录中的时候也有效。

还可以用all/all，all/allfiles表示所有文件，以逗号分隔。

Actions=openTerminalHere;

标明动作，由接下来的[Desktop Action openTerminalHere]分段具体说明

X-KDE-AuthorizeAction=shell_access

很明显，所要的权限，此处为shell_access

[Desktop Action openTerminalHere]

新的分节，后面的openTerminalHere与前面定义的动作一致，整个分节是对此动作的一个详细说明。

Name=Open Terminal Here

说明显示的菜单的名字，通过Name[zh_CN]这样的形式支持多语言版本

Icon=utilities-terminal

指定图标

Exec=konsole --workdir %f

指定菜单命令

上述的东西都不是关键，也不算什么难点，下面真的好戏登场了。

三、 动态修改

这在KDE中算是新鲜课题，一则少有人知，甚至没有找到E文资料，二则我看到在KDE的changelog中竟然提到kdesvn的作者发现了其中有一些问题。（见http://www.kde.org/announcements/changelogs/3_5_6/kdelibs.txt）说明平时用的人估计也少。要不是有kdesvn作者走在前面，我连看源代码的头绪都没有，向Rajko Albrecht致敬。

下面是kdesvn的配置片段：

[Desktop Entry]

Type=Service

ServiceTypes=KonqPopupMenu/Plugin,inode/directory,all/all,all/allfiles

X-KDE-Submenu=Subversion (kdesvn)

X-KDE-GetActionMenu=org.kde.kded /modules/kdesvnd org.kde.kdesvnd getActionMenu

Actions=Log;Info;Add;Addnew;Delete;Revert;Rename;Import;Checkout;Switch;Merge;Blame;CreatePatch;Export;Diff;Update;Commit;Checkoutto;Exportto;Tree;

其他的都好说了，主要的问题在X-KDE-GetActionMenu=org.kde.kded /modules/kdesvnd org.kde.kdesvnd getActionMenu一句，kdesvn也就是靠此句实现了动态的上下文菜单。

从应用上看，对于非svn工程的目录，在平时显示的是Checkout from a repository和Export from a subversion repository，而Actions里面也有，而Actions里面还有当目标的确是一个svn工程的目录时的一大堆选项。说明事实上选项是通过某个函数进行筛选然后显示的。看上面的配置，很显然是X-KDE-GetActionMenu配置的getActionMenu函数（从命名上猜的），通过关键字，我定位到了关键的KDE源代码：

kdelibs/kio/kio/kdesktopfileactions.cpp:219开始

QList<KServiceAction> KDesktopFileActions::userDefinedServices( constKService& service, boolbLocalFiles, constKUrl::List & file_list )
{
QList<KServiceAction> result;

if(!service.isValid()) // e.g. TryExec failed
returnresult;

QStringList keys;
constQString actionMenu = service.property("X-KDE-GetActionMenu", QVariant::String).toString();
if(!actionMenu.isEmpty()) {
constQStringList dbuscall = actionMenu.split(QChar(' '));
if(dbuscall.count() >= 4) {
constQString& app = dbuscall.at( 0);
constQString& object= dbuscall.at( 1);
constQString& interface = dbuscall.at( 2);
constQString& function= dbuscall.at( 3);

QDBusInterface remote( app, object, interface );
// Do NOT use QDBus::BlockWithGui here. It runs a nested event loop,
// in which timers can fire, leading to crashes like #149736.
QDBusReply<QStringList> reply = remote.call(function, file_list.toStringList());
keys = reply; // ensures that the reply was a QStringList
if(keys.isEmpty())
returnresult;
} else{
kWarning(7000) << "The desktop file"<< service.entryPath()
<< "has an invalid X-KDE-GetActionMenu entry."
<< "Syntax is: app object interface function";
}
}

// Now, either keys is empty (all actions) or it's set to the actions we want

foreach(constKServiceAction& action, service.actions()) {
if(keys.isEmpty() || keys.contains(action.name())) {
constQString exec = action.exec();
if(bLocalFiles || exec.contains("%U") || exec.contains("%u")) {
result.append( action );
}
}
}

returnresult;
}

源码可以看出，其一，我们分析配置文件没有错误，此行的确是关键，其二，获取具体字符串的方式利用了D-bus这个进程间通信手段远程调用了getActionMenu这个函数，然后获取到了一个字符串list，此list就是我们最后看到的菜单项。至此，一切问题已经得到解决，动态菜单的关键就是以X-KDE-GetActionMenu配置然后通过D-bus调用函数。D-bus作为Linux下非常流行的进程间通信手段就远没有KDE动态菜单这么神秘了，资料丰富的多，需要的就自己去查阅吧。

四、 参考资料

1.KDE tech base，Konqueror Service Menu相关章节：

http://techbase.kde.org/Development/Tutorials/Creating_Konqueror_Service_Menus

write by 九天雁翎(JTianLing) -- blog.csdn.net/vagrxie

<script type="text/javascript"><!-- var sitebro_tracker_atc={u:'http://www.sitebot.com.cn/754892/',w:'NzU0ODky',bt:'#804000',bg:'#FFFFCC',cf:'#ffffff',ca:'#666666',bh:'#f4f4c6',cp:'%E6%9C%AC%E7%AB%99%E7%83%AD%E9%97%A8%E6%96%87%E7%AB%A0',l:10,s:0,lang:'zh_CN'}; // --></script><script src="http://www.sitebot.com.cn/js/widget_track2/tracker_atc.js" type="text/javascript"></script>

<script type="text/javascript"><!-- var sitebro_tracker_atc_kw = {u:'http://www.sitebot.com.cn/754892/',w:'NzU0ODky',bt:'#804000',bg:'#FFFFCC',fs:1,ca:'#666666',bh:'#f4f4c6',cp:'',l:10,s:1,lang:'zh_CN'}; // --></script><script src="http://www.sitebot.com.cn/js/widget_track2/tracker_atc_kw.js" type="text/javascript"></script>