unistore-tray

跨平台系统托盘能力 - UniStore 能力生态的一部分。

功能特性

• 跨平台: 支持 Windows/macOS/Linux
• 统一 API: 屏蔽平台差异，提供一致的接口
• 异步友好: 与 tokio 运行时无缝集成
• 事件驱动: 通过 broadcast channel 订阅托盘事件
• 可扩展菜单: 灵活的菜单构建器 API

快速开始

use unistore_tray::{SystemTray, TrayConfig, TrayEvent, MenuBuilder};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 创建托盘配置
    let config = TrayConfig::builder()
        .tooltip("My App v1.0")
        .build();

    // 创建系统托盘
    let tray = SystemTray::new(config)?;

    // 设置菜单
    let menu = MenuBuilder::new()
        .item("open", "打开主窗口")
        .separator()
        .item("exit", "退出")
        .build();
    tray.set_menu(menu)?;

    // 订阅事件
    let mut rx = tray.subscribe();
    
    loop {
        match rx.recv().await {
            Ok(TrayEvent::MenuItemClicked(id)) => {
                match id.as_str() {
                    "exit" => break,
                    "open" => println!("打开窗口"),
                    _ => {}
                }
            }
            Ok(TrayEvent::DoubleClick) => {
                println!("双击托盘图标");
            }
            _ => {}
        }
    }

    Ok(())
}

平台支持

⚠️ 表示行为可能与 Windows 不同 ❌ 表示平台不支持

Feature Flags

License

Licensed under either of:

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT license (LICENSE-MIT)

at your option.