最近，在實(shí)現(xiàn)「TodoList」應(yīng)用最小化到系統(tǒng)托盤(pán)的功能時(shí)，踩了幾個(gè)坑，記錄一下。

前言

這個(gè)功能其實(shí)挺常見(jiàn)的：用戶(hù)點(diǎn)擊應(yīng)用右上角的關(guān)閉按鈕，應(yīng)用不會(huì)直接退出，而是最小化到系統(tǒng)托盤(pán)，在后臺(tái)繼續(xù)運(yùn)行。

這么做的好處也很直觀——不占用桌面空間，同時(shí)保持后臺(tái)運(yùn)行，避免消息提醒失效。

不過(guò)真落地實(shí)現(xiàn)的時(shí)候，還是有幾個(gè)需要注意的地方，下面展開(kāi)聊聊~

代碼核心實(shí)現(xiàn)

一開(kāi)始讓 AI 幫忙寫(xiě)，結(jié)果跑不起來(lái)。后來(lái)參考了文末補(bǔ)充內(nèi)容，才把功能調(diào)通。

webview_process = None  
def run_webview():  
    webview.create_window('Webview', 'https://pywebview.flowrl.com/hello')  
    webview.start()  
if __name__ == '__main__':  
    def start_webview_process():  
        global webview_process  
        webview_process = Process(target=run_webview)  
        webview_process.start()  
    def on_open(icon, item):  
        global webview_process  
        if not webview_process.is_alive():  
            start_webview_process()  
    def on_exit(icon, item):  
        icon.stop()  
    start_webview_process()  
    image = Image.open('demo.png')  
    menu = Menu(MenuItem('Open', on_open), MenuItem('Exit', on_exit))  
    icon = Icon('Pystray', image, menu=menu)  
    icon.run()  
    webview_process.terminate()

整體思路是用到了 pystray 這個(gè)庫(kù)：

• 創(chuàng)建一個(gè)系統(tǒng)托盤(pán)圖標(biāo)
• 圖標(biāo)支持右鍵菜單，包含“打開(kāi)”和“退出”兩個(gè)選項(xiàng)
• 通過(guò) icon.run() 保持應(yīng)用在后臺(tái)持續(xù)運(yùn)行
• 改造原有代碼：
  • 將 create_window 提取為獨(dú)立方法，方便重復(fù)調(diào)用
  • 用全局變量 webview_process 管理子進(jìn)程，點(diǎn)擊“打開(kāi)”時(shí)判斷是否存活，避免重復(fù)啟動(dòng)
• 只有調(diào)用 icon.stop()，托盤(pán)圖標(biāo)才會(huì)退出，應(yīng)用才算真正關(guān)閉

注意事項(xiàng)

1. 單擊托盤(pán)圖標(biāo)打開(kāi)應(yīng)用

在 MenuItem 中設(shè)置 default=True 即可實(shí)現(xiàn)單擊托盤(pán)圖標(biāo)時(shí)觸發(fā)打開(kāi)操作。

這里有個(gè)小插曲：我用 DeepSeek 咨詢(xún)時(shí)，它推薦的 default_action 函數(shù)一直不生效。后來(lái)?yè)Q Gemini，給出的方案是直接加 default=True，看引用來(lái)源是 Stack Overflow 上的回答。

估計(jì)這個(gè)問(wèn)題在國(guó)內(nèi)社區(qū)討論不多，導(dǎo)致 DeepSeek 的訓(xùn)練數(shù)據(jù)里沒(méi)覆蓋到。

menu = Menu(MenuItem('打開(kāi)應(yīng)用', on_open, default=True), MenuItem('徹底退出', on_exit))

2. 解決重復(fù)打開(kāi)應(yīng)用的問(wèn)題

這個(gè)問(wèn)題也是靠 Gemini 解決的。DeepSeek 給的方案偏復(fù)雜，就沒(méi)繼續(xù)折騰。

if __name__ == '__main__':  
    # 用于解決打包后的多進(jìn)程問(wèn)題  
    multiprocessing.freeze_support()  
  
    # 其他代碼  

重復(fù)打開(kāi)的原因是子進(jìn)程重新執(zhí)行了 main 塊。兩個(gè) AI 分析的根因基本一致：

主進(jìn)程啟動(dòng)
    ↓
執(zhí)行 if __name__ == '__main__': 塊
    ↓
創(chuàng)建 webview_process (子進(jìn)程A)
    ↓
webview_process.start() 觸發(fā)：
    ├─ 創(chuàng)建新進(jìn)程
    ├─ 重新導(dǎo)入 main.py
    ├─ 子進(jìn)程A執(zhí)行 if __name__ == '__main__'?
    │   └─ 是的！因?yàn)檫@是新進(jìn)程的入口
    └─ 再次打印 "啟動(dòng)任務(wù)提醒服務(wù)..." (第2次)
    ↓
主進(jìn)程繼續(xù)執(zhí)行 icon.run()
    ↓
icon.run() 阻塞主進(jìn)程

3. 點(diǎn)擊關(guān)閉按鈕時(shí)彈出提醒

這個(gè)可以通過(guò)前端自定義彈窗 + 后端監(jiān)聽(tīng)關(guān)閉事件來(lái)實(shí)現(xiàn)。不過(guò) pywebview 本身提供了默認(rèn)實(shí)現(xiàn)，我就直接偷懶用了：

webview.create_window(  
    'TodoList',  
    frontend_path,  
    js_api=api,  
    width=1400,  
    height=900,  
    text_select=True,  
    resizable=True,  
    confirm_close=True  # 增加該配置項(xiàng)
)

另外，pywebview 的關(guān)閉彈窗支持中文化配置，但遺憾的是不支持動(dòng)態(tài)切換。如果后續(xù)英文用戶(hù)不多，可能就不折騰了~

# 定義本地化字符串字典  
chinese_localization = {  
    'global.quitConfirmation': '溫馨提示：\n關(guān)閉后，程序?qū)⒆钚』较到y(tǒng)托盤(pán)以保持消息后臺(tái)提醒。\n如需徹底關(guān)閉，請(qǐng)?jiān)谕斜P(pán)右鍵退出~',  
    'global.ok': '確定',  
    'global.cancel': '取消'  
}

webview.start(bind, backend.globals.window, private_mode=False, ssl=True, debug=False, localization= chinese_localization)

知識(shí)補(bǔ)充

使用pywebview創(chuàng)建后臺(tái)運(yùn)行的桌面應(yīng)用

pywebview是一個(gè)輕量級(jí)的Python庫(kù)，專(zhuān)門(mén)用于創(chuàng)建跨平臺(tái)的桌面GUI應(yīng)用。它最大的優(yōu)勢(shì)在于能夠?qū)F(xiàn)代Web技術(shù)與傳統(tǒng)桌面應(yīng)用完美結(jié)合。通過(guò)集成pystray庫(kù)，你可以輕松為應(yīng)用添加系統(tǒng)托盤(pán)功能，讓用戶(hù)即使關(guān)閉主窗口也能保持應(yīng)用在后臺(tái)運(yùn)行。

快速搭建系統(tǒng)托盤(pán)應(yīng)用

讓我們從基礎(chǔ)開(kāi)始，創(chuàng)建一個(gè)簡(jiǎn)單的系統(tǒng)托盤(pán)應(yīng)用：

from PIL import Image
from pystray import Icon, Menu, MenuItem
import webview
def create_tray_icon():
    # 加載應(yīng)用圖標(biāo)
    image = Image.open('logo/logo.png')
    # 創(chuàng)建托盤(pán)菜單
    menu = Menu(
        MenuItem('打開(kāi)應(yīng)用', on_open),
        MenuItem('退出', on_exit)
    )
    # 創(chuàng)建系統(tǒng)托盤(pán)圖標(biāo)
    icon = Icon('MyApp', image, menu=menu)
    return icon
def on_open(icon, item):
    # 顯示應(yīng)用窗口的邏輯
    pass
def on_exit(icon, item):
    # 退出應(yīng)用的邏輯
    icon.stop()

到此這篇關(guān)于Python桌面端應(yīng)用最小化托盤(pán)開(kāi)發(fā)實(shí)踐指南的文章就介紹到這了,更多相關(guān)Python桌面應(yīng)用開(kāi)發(fā)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論