Qt显示Linux desktop natification气泡提示框

在现代Linux桌面环境上我们时常可以看到类似的消息框：

这些消息框常用在如下场景：

即时聊天软件的新消息

闹钟定时提示

电池电量提示

邮件消息

长耗时操作的完成提示

在freedesktop.org的规范中这种消息框被称为Desktop Notification，中文名我们形象得称其为“气泡框”。通过调用D-BUS服务org.freedesktop.Notifications提供的接口即可显示在桌面上。

所以我们先了解一下这个D-BUS服务。

org.freedesktop.Notifications概览

一个气泡框消息通常会包含如下的属性：

名称 说明
Application Name   标示发送消息的程序，最好使用程序全名  
Replaces ID   可选的消息ID，服务器通过id控制消息框的渲染，通常不用关注  
Icon   显示在气泡框上的图标  
Summary   标题，只能显示一行，叫title应该更合适  
Body   消息体，支持部分HTML标签；<b></b>；<i></i>；<u></u>；<a></a>；<img src=http://www.likecs.com/... alt=http://www.likecs.com/...>  
Actions   显示一些按钮或者菜单（QAction），不过这一功能通常未被实现  
Hints   为消息体提供的额外数据，比如显示在屏幕的位置（x，y坐标）  
Expiration Timeout   气泡框显示的时长，单位毫秒；指定为-1时行为取决于实现；为0时气泡框将一直显示在桌面上直到用户点击  

其中Icon和Hints中的image_path必须为本地绝对路径或者file://开头的文件URL。另外使用桌面环境预定义图标的名字也是可以的。

气泡框还有三个紧急程度可供选择：

名称 值 说明
Low   0   默认值，可以设置如何显示，应该设置一个合理的显示时间以便气泡框可以隐藏退出  
Normal   1   同low  
Critical   2   代表重要通知，不应该自动过期隐藏  

所有的气泡框消息请求都是异步的，通常构造请求并发送后用户就可以不再关心后续的信息，如果有特殊需要则可以自定义处理org.freedesktop.Notifications发送的信号。

得益于freedesktop.org的标准规范，包括KDE，GNOME，XFCE4在内的许多桌面环境都提供了对Desktop Notification的支持，虽然外观上可能存在一些差异但是创建气泡框的方法是一样的。

不过不用担心，我们不会直接去使用D-BUS，因为已经有简化的现成方案可供选择了。下面就让我们一起看看这些方案。

方案一：调用外部命令

可能你已经知道了，我要介绍的命令就是notify-send。

notify-send几乎被所有的桌面环境和发行版支持，它依赖于后面会介绍的libnotify和glib，如果你的系统上没有安装可以使用如下命令进行安装：

debian/Ubuntu:

sudo apt install libnotify-bin

Arch Linux:

sudo pacman -S libnotify

安装后可以用如下命令显示气泡框：

# notify-send title body [options] notify-send test 'This is a desktop Notification test.' -t 10000

-t参数设置超时时间。效果如下：

具体的参数可以参考这里：https://ss64.com/bash/notify-send.html

方案二：通过编程方式实现

在Qt代码中调用外部命令就可以显示气泡框，然而这种方式不够灵活，所以我们需要使用前面提到的libnotify在我们的代码里生成并显示气泡框。

libnotify对各个语言都提供了binding，可以参考。
这里我们选择使用golang的binding：

package main import ("github.com/mqu/go-notify") func main() { notify.Init("Hello world") hello := notify.NotificationNew("Hello World!", "This is an example notification.","dialog-information") hello.SetTimeout(5000) hello.Show() }

上面的代码将会显示一个可以在桌面停留5s的气泡框：

不过如果每次都要使用一大串代码才能显示消息的话必然是低效的，而且需要换算时间至毫秒，所以我写了一个帮助函数在notify.go:

// ShowNotification 显示org.freedesktop.Notifications气泡消息框 // duration == -1时使用默认delay // duration == 0表示不设置超时，desktop notification将会一直显示 func ShowNotification(title, text, image string, delay time.Duration) { var notifyDelay int32 if delay == -1 { notifyDelay = duration2millisecond(defaultNotifyDelay) } else { notifyDelay = duration2millisecond(delay) // 不合法值(包括duration不足1ms)，使用默认值进行替换 if notifyDelay == -1 { notifyDelay = duration2millisecond(defaultNotifyDelay) } } libnotify.Init(applicationName) notify := libnotify.NotificationNew(title, text, image) if notify == nil { fmt.Fprintf(os.Stderr, "Unable to create a new notification\n") return } notify.SetTimeout(notifyDelay) notify.Show() } // duration2millisecond 将time.Duration转换成millisecond // duration不足1ms将返回-1 func duration2millisecond(duration time.Duration) int32 { res := int32(duration / time.Millisecond) if res < 0 { return -1 } return res }