当前位置：首页 > news >正文

给Go+Sciter开发的桌面客户端软件添加系统托盘图标

news 2025/8/7 17:53:04

在桌面端软件开发中，系统托盘图标是提升用户体验的重要元素。托盘图标不仅能提供直观的状态反馈，还能让软件在后台运行时依然保持与用户的交互。通过托盘图标，用户可以轻松最小化软件、退出程序，甚至弹出通知，从而避免占用过多的屏幕空间。

在之前的文章中，我们介绍了如何使用Go与Sciter框架开发桌面客户端软件，例如【手把手教你用Go开发客户端软件（使用Go + HTML）】以及【Go+Sciter开发桌面客户端软件小试：网站Sitemap生成】。本篇文章将进一步探讨如何为这些桌面软件添加系统托盘图标，并且通过右键菜单实现更多功能。

系统托盘图标的基本原理

什么是系统托盘？

系统托盘通常位于操作系统任务栏的一侧，用于显示小型应用图标。这些图标为用户提供了程序的运行状态和快捷操作的入口。

托盘图标的常见交互方式：

右键菜单：通过右键点击托盘图标，用户可以访问特定功能菜单，如显示主界面、退出、最小化等。
通知气泡：托盘图标也可以用来弹出提示或通知，让用户关注到软件的关键事件。

在Go中实现托盘图标的基础知识

在Go语言中，原生并没有直接支持系统托盘功能，因此我们通常需要借助第三方库来实现这一功能。常见的做法是使用systray库来管理托盘图标的展示和交互。

引入第三方库：systray

为什么需要systray库？

systray库是一个轻量级且跨平台的解决方案，能够帮助开发者快速为桌面软件添加托盘图标和菜单。其支持Windows、macOS以及大多数Linux发行版，非常适合跨平台应用的开发需求。

安装systray库

在Go项目中，可以通过以下命令安装systray库：

go get github.com/getlantern/systray

初始化系统托盘

在程序启动时初始化托盘图标：

package mainimport ("github.com/getlantern/systray"
)//go:embed icon.png
var iconData []bytefunc main() {systray.Run(onReady, onExit)
}func onReady() {systray.SetIcon(iconData)  // 设置托盘图标systray.SetTitle("我的应用")systray.SetTooltip("这是一个托盘图标应用")mQuit := systray.AddMenuItem("退出", "退出程序")go func() {<-mQuit.ClickedChsystray.Quit()}()
}func onExit() {// 托盘程序退出时的清理逻辑
}

通过systray.Run方法启动托盘服务，并在onReady回调函数中设置图标和菜单。

使用Sciter与Systray的结合

在桌面应用中，Sciter负责展示用户界面，而Systray负责托盘图标和菜单功能。我们可以结合两者，创建一个完整的用户体验。

示例代码：
下面我们用前面写的【Go+Sciter开发桌面客户端软件小试：网站Sitemap生成】软件中添加相应代码，来展示如何在使用Sciter构建的桌面应用中结合systray库实现托盘功能：

func main() {w, err := window.New(sciter.SW_TITLEBAR|sciter.SW_RESIZEABLE|sciter.SW_CONTROLS|sciter.SW_MAIN|sciter.SW_ENABLE_DEBUG, &sciter.Rect{Left:   100,Top:    50,Right:  1100,Bottom: 660,})if err != nil {log.Fatal(err)}w.SetCallback(&sciter.CallbackHandler{OnLoadData: func(params *sciter.ScnLoadData) int {if strings.HasPrefix(params.Uri(), "home://") {fileData, err := views.ReadFile(params.Uri()[7:])if err == nil {w.DataReady(params.Uri()[7:], fileData)}}return 0},})w.DefineFunction("openUrl", openUrl)w.DefineFunction("getRunningTask", getRunningTask)w.DefineFunction("createTask", createTask)mainView, err := views.ReadFile("views/main.html")if err != nil {os.Exit(0)}w.LoadHtml(string(mainView), "")// 注意这里，这里使用了一个协程，用于启动systray服务go systray.Run(onReady, onExit)w.SetTitle("Sitemap 生成")w.Show()w.Run()
}func onReady() {systray.SetTemplateIcon(iconData, iconData)systray.SetIcon(iconData)systray.SetTitle("Sitemap")about := systray.AddMenuItem("关于", "Sitemap 生成")systray.AddSeparator()openHelp := systray.AddMenuItem("使用帮助", "打开使用帮助")openOrigination := systray.AddMenuItem("访问官网", "https://www.anqicms.com")systray.AddSeparator()mQuit := systray.AddMenuItem("退出", "Sitemap 生成")go func() {for {select {case <-about.ClickedCh:_ = open.Run("https://www.anqicms.com/about.html")case <-openHelp.ClickedCh:_ = open.Run("https://www.anqicms.com/help")case <-openOrigination.ClickedCh:_ = open.Run("https://www.anqicms.com/")case <-mQuit.ClickedCh:systray.Quit()return}}}()
}func onExit() {// clean up herelog.Println("退出程序")
}