用Tauri跨平台框架在鸿蒙PC上开发闪控球与闪控窗:GlintPod的悬浮交互、贴边吸附与离线速算实践

欢迎加入开源鸿蒙PC社区: https://harmonypc.csdn.net/
欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper

前言

在桌面操作系统上,"悬浮球 + 轻量浮窗"是一类经久不衰的交互形态:它常驻屏幕一角、随取随用,把高频小操作从"切换应用"的沉重路径里解放出来。鸿蒙PC(HarmonyOS PC)把 2in1 设备作为一等公民支持之后,这类跨应用轻量交互自然也成为我们在鸿蒙PC上探索的方向之一——于是有了本文的主角:GlintPod 闪浮舱。

GlintPod 是一个完全用 Tauri 跨平台框架开发的鸿蒙PC应用:Rust 负责全部业务核心(吸附计算、表达式求值、倒计时状态机、沙箱持久化),Web 前端负责悬浮球的拖拽渲染与闪控窗弹层,两侧通过 Tauri 的 invoke IPC 桥接。整个应用最终编译成一个约 6MB 的 .so 动态库,由鸿蒙侧的 ArkTS NativeAbility 加载,跑在鸿蒙PC真机的 2in1 桌面上。

本文延续我们"用 Tauri 在鸿蒙PC上做真实应用"系列实践的写法:从架构决策、核心算法、真实代码到真机验证逐层展开。所有代码均取自 GlintPod 工程源码,可直接复现。项目源码托管在 AtomGit 的 OpenHarmonyPCDeveloper 社区,欢迎按文末方式获取。

关键词:鸿蒙PC,Tauri,跨平台框架,Rust,闪控球,闪控窗,悬浮球,贴边吸附,表达式求值,沙箱持久化,ArkTS,HarmonyOS

一、为什么是"闪控球与闪控窗",为什么是Tauri

1.1 交互主题的拆解

我们把"闪控球与闪控窗"这个主题拆成四个可落地的能力点:

  1. 闪控球拖拽:一颗 76px 的发光球体,可以在舞台内自由拖动;
  2. 贴边吸附:松手后自动吸附到最近的屏幕边缘,这是悬浮球类应用的经典体验;
  3. 快捷环展开:点击球体,围绕球心呈扇形弹出四个快捷入口——快捕(随手记)、速算(离线表达式求值)、倒数(计时器)、日志(操作轨迹);
  4. 闪控窗弹层:点快捷入口弹出对应功能的玻璃拟态浮窗,轻量完成任务后随手关闭。

这四个点合起来,正好构成"信息展示 + 轻量任务处理"的完整闭环,也覆盖了 Tauri 跨平台框架在鸿蒙PC上最典型的三类工作:前端交互渲染、Rust 算法计算、IPC 数据往返。

1.2 Tauri在鸿蒙PC上的技术形态

先澄清技术事实:标准 Tauri 2 官方支持的目标并不直接包含 HarmonyOS。我们在 Tauri 跨平台框架上的路线是 Tauri 鸿蒙分支 + Rust cdylib + ArkTS NativeAbility 的组合:

  • Rust 业务层编译为 aarch64-unknown-linux-ohos 目标的 cdylib(即 libglintpod_lib.so);
  • Tauri 在编译期把 web/ 前端资产嵌入这个 .so,运行时由鸿蒙侧的 ArkTS NativeAbility 加载;
  • 前端与 Rust 的通信走 Tauri 的 invoke 机制:前端 invoke("命令名", { 参数 }),Rust 侧用 #[tauri::command] 宏暴露命令。

这个跨平台框架组合的收益是明显的:一份 Rust 业务代码,天生可移植——今天跑在鸿蒙PC上,明天要迁回桌面端或移动端,业务层几乎零改动,这正是选择 Tauri 跨平台框架的核心动机。GlintPod 全部 15 个 IPC 命令都在这一通道上工作,下文逐一展开。

二、GlintPod的整体架构:15个Rust命令撑起闪控台

GlintPod 的 Rust 端注册了 15 个命令,按职责分四组:

分组命令职责
基础app_info / greet / platform_report版本自述、能力矩阵上报
闪控球orb_state_get / orb_state_update球位持久化、贴边判定、展开计数
快捕capture_add / capture_list / capture_delete / capture_clear随手记片段的增删查清
速算与倒数quick_calc / countdown_start / countdown_status / countdown_cancel表达式求值、计时状态机
日志log_event / load_log闪控轨迹环形日志(50 条截断)

管理状态用的都是 Tauri 的 manage() + tauri::State 模式:

tauri::Builder::default()
    .manage(LogState {
        entries: Mutex::new(Vec::new()),
    })
    .manage(OrbState {
        data: Mutex::new(OrbStateData::default()),
    })
    .manage(CountdownState {
        deadline: Mutex::new(None),
    })
    .invoke_handler(tauri::generate_handler![
        app_info, greet, platform_report,
        orb_state_get, orb_state_update,
        capture_add, capture_list, capture_delete, capture_clear,
        quick_calc, countdown_start, countdown_status, countdown_cancel,
        log_event, load_log
    ])
    .run(tauri::generate_context!())
    .expect("error while running GlintPod");

启动时界面顶部的"Rust 内核在线"徽标,就是前端 invoke("app_info") 拿到版本号后渲染的——它是整条 IPC 链路的首次握手验证。

三、闪控球的三板斧:拖拽、贴边吸附、状态记忆

3.1 贴边吸附:一个纯函数解决

悬浮球松手后的吸附判定,本质是"球心到四条边的距离取最小值"。我们把它写成纯函数,坐标全部归一化到 0-1 区间,与真机分辨率彻底解耦:

/// 吸附边判定:按球心到四边距离取最近者。
/// 视口与坐标均为 0-1 归一化比例,避免真机分辨率差异。
fn snap_edge_for(x: f64, y: f64) -> &'static str {
    let dists = [
        ("left", x),
        ("right", 1.0 - x),
        ("top", y),
        ("bottom", 1.0 - y),
    ];
    let mut best = ("left", f64::INFINITY);
    for (edge, dist) in dists {
        if dist < best.1 {
            best = (edge, dist);
        }
    }
    best.0
}

函数只有十几行,却承担了整颗球的"手感"。它有独立的单元测试覆盖四个象限的吸附方向,例如 (0.05, 0.5) 吸附左边缘、(0.97, 0.5) 吸附右边缘、(0.6, 0.4) 距右 0.4 最近所以吸附右侧。

3.2 球位持久化:归一化坐标跨设备复原

每次松手或展开快捷环,前端都会调用 orb_state_update 把归一化坐标写回 Rust 侧,落盘到应用沙箱的 glintpod-orb.json:

#[tauri::command]
fn orb_state_update(
    app: tauri::AppHandle,
    state: tauri::State<OrbState>,
    x: f64,
    y: f64,
    opened: Option<bool>,
    active_window: Option<String>,
) -> Result<OrbStateData, String> {
    if !(0.0..=1.0).contains(&x) || !(0.0..=1.0).contains(&y) {
        return Err("闪控球坐标须为 0-1 归一化比例".into());
    }
    let mut data = state.data.lock().map_err(|_| "闪控球状态不可用")?.clone();
    data.x = x;
    data.y = y;
    data.snap_edge = snap_edge_for(x, y).to_string();
    if let Some(true) = opened {
        data.opens = data.opens.saturating_add(1);
    }
    let path = orb_path(&app)?;
    save_orb_file(&path, &data)?;
    Ok(data)
}

注意两个细节:坐标先做合法性校验(超出 0-1 直接报错,防止前端异常值污染持久化文件);opens 计数用 saturating_add 防溢出。下次冷启动,前端 orb_state_get 读回这份状态,闪控球直接回到上次吸附的位置——在鸿蒙PC真机上关掉应用再打开,球还在原地,这就是"状态记忆"的完整体验。

3.3 前端拖拽:Pointer事件 + 吸附动画

前端用 Pointer 事件实现拖拽,松手后交给 Rust 计算吸附边,再用 CSS transition 做出"啪一下贴到边上"的弹性动画:

orb.addEventListener("pointerup", async () => {
  if (!orbDragging) return;
  orbDragging = false;
  snapEdge = nearestEdge(orbX, orbY);
  // 贴边动画:吸附到最近边的比例处
  const snapX = snapEdge === "left" ? 0.05 : snapEdge === "right" ? 0.95 : orbX;
  const snapY = snapEdge === "top" ? 0.05 : snapEdge === "bottom" ? 0.95 : orbY;
  orbX = snapX;
  orbY = snapY;
  orb.style.transition = "left 0.28s ease, top 0.28s ease";
  placeOrb();
  setTimeout(() => (orb.style.transition = ""), 320);
  if (dragMoved) {
    closeRings();
    await persistOrb(false);
  } else {
    toggleRings();      // 原地点击 → 展开快捷环
    await persistOrb(!orbOpen);
  }
});

这里用 dragMoved 标志区分"拖拽"和"点击"两种手势:拖过了就收起快捷环并持久化位置;原地松手则展开快捷环。

GlintPod 启动总览:暗夜琉璃风主界面,左侧闪控舞台、右侧能力矩阵,闪控球吸附在左侧

上图为鸿蒙PC真机的完整启动界面:顶部状态栏、底部 Dock 栏清晰可见鸿蒙PC系统特征,应用内左侧是闪控舞台与闪控球,右侧能力矩阵已经完整加载。

点按闪控球展开快捷环:算、志等快捷入口呈扇形环绕

点按球体后快捷环展开,四个快捷入口以弹性动画从球心弹出,这是图2的真机现场。

四、离线速算:一个不依赖任何库的表达式求值器

速算窗是闪控窗里算法含量最高的一块。我们选择不引入任何表达式解析库,在 Rust 里手写了一个递归下降求值器,支持 + - * /、负号与括号:

fn parse_additive(tokens: &[char], pos: &mut usize) -> Result<f64, String> {
    let mut left = parse_multiplicative(tokens, pos)?;
    while *pos < tokens.len() {
        let op = tokens[*pos];
        if op != '+' && op != '-' {
            break;
        }
        *pos += 1;
        let right = parse_multiplicative(tokens, pos)?;
        left = if op == '+' { left + right } else { left - right };
    }
    Ok(left)
}

fn parse_multiplicative(tokens: &[char], pos: &mut usize) -> Result<f64, String> {
    let mut left = parse_primary(tokens, pos)?;
    while *pos < tokens.len() {
        let op = tokens[*pos];
        if op != '*' && op != '/' {
            break;
        }
        *pos += 1;
        let right = parse_primary(tokens, pos)?;
        if op == '/' && right == 0.0 {
            return Err("除数不能为零".into());
        }
        left = if op == '*' { left * right } else { left / right };
    }
    Ok(left)
}

parse_additive 处理加减、parse_multiplicative 处理乘除、parse_primary 处理数字/括号/负号,三层函数的调用层级天然编码了运算符优先级。求值前先做两层防护:表达式长度上限 64 字符,结果非有限数(NaN/无穷)一律报错。

单元测试覆盖了优先级、括号与非法输入三类场景:

#[test]
fn eval_expressions_respect_precedence() {
    assert_eq!(eval_expression("1+2*3").unwrap(), 7.0);
    assert_eq!(eval_expression("(1+2)*3").unwrap(), 9.0);
    assert_eq!(eval_expression("10/4").unwrap(), 2.5);
    assert_eq!(eval_expression("-3+5").unwrap(), 2.0);
    assert_eq!(eval_expression(" 12 * 12 ").unwrap(), 144.0);
}

#[test]
fn eval_rejects_bad_input() {
    assert!(eval_expression("").is_err());
    assert!(eval_expression("1/0").is_err());
    assert!(eval_expression("(1+2").is_err());
    assert!(eval_expression("1+abc").is_err());
}

还有一个值得单独说的工程细节:quick_calc 每次求值成功后会顺手把 expr = value 写进闪控日志。它在命令内部直接复用了 log_event 的状态——tauri::State<LogState> 作为参数原样转发即可,多个命令共享同一个 Mutex 状态,不需要任何额外的同步代码。这是 Tauri 状态管理在鸿蒙PC应用里最顺手的地方。

速算窗真机求值:145671+35792 = 181463,Rust 内核在线徽标清晰可见

上图为鸿蒙PC真机上的速算窗:输入 145671+35792,点击"Rust 求值",结果区即刻显示 = 181463,计算完全发生在设备端,无任何网络请求。

五、倒数状态机与沙箱存储回退链

5.1 用 Instant 搭建的倒数状态机

倒数窗不需要前端每秒发一次 IPC,Rust 侧只记录一个 (起始时刻, 总时长, 标签) 三元组,任何时刻来查询都能算出剩余秒数:

fn countdown_status_from(deadline: &Option<(std::time::Instant, u64, String)>) -> CountdownStatus {
    match deadline {
        Some((start, total, label)) => {
            let elapsed = start.elapsed().as_secs();
            let remaining = total.saturating_sub(elapsed);
            CountdownStatus {
                active: remaining > 0,
                label: label.clone(),
                total_secs: *total,
                remaining_secs: remaining,
                finished: remaining == 0,
            }
        }
        None => CountdownStatus { active: false, /* ... */ },
    }
}

前端以 500ms 间隔轮询 countdown_status,大字号倒计时数字实时刷新;倒数归零时弹出系统提示气泡并写日志"完成:专注冲刺"。输入校验(1-86400 秒、标签 1-40 字符)收敛在 countdown_validate 纯函数里,同样有独立测试。

倒数窗真机运行:05:00 倒计时大字显示,倒数已启动的提示气泡弹出

倒数窗在鸿蒙PC真机上的运行现场:300 秒倒数以 05:00 大字号青玉色数字呈现,底部提示气泡确认倒数已启动。

5.2 沙箱存储:探针写入回退链

所有持久化文件(球位、快捕、日志)都经由同一条存储回退链写入。这条链路是我们前几个鸿蒙PC项目踩坑沉淀下来的:鸿蒙应用的 app_data_dir 在不同设备形态下可能返回不可写路径,所以每一层候选目录都要先做探针写入验证:

fn writable_dir(candidates: &[PathBuf]) -> Option<PathBuf> {
    for dir in candidates {
        if fs::create_dir_all(dir).is_ok() {
            let probe = dir.join(".glintpod-probe");
            if fs::write(&probe, b"ok").is_ok() {
                let _ = fs::remove_file(&probe);
                return Some(dir.clone());
            }
        }
    }
    None
}

候选顺序是:app_data_dir/glintpod → 鸿蒙沙箱固定路径 → /data/local/tmp → 系统临时目录。第一层失败自动降级下一层,永远不会因为某个目录不可写而让整个应用的功能瘫痪。这套机制在我们的真机环境里已稳定运行多个项目,GlintPod 的三类持久化文件全部走它。

贴边吸附与能力矩阵:闪控球吸附下侧,快捷环展开,系统级悬浮窗如实标注受限

这张真机截图展示了完整的 8 项能力矩阵:闪控球拖拽、贴边吸附、球位记忆、快捕片段、离线速算、闪控倒数、闪控日志落盘七项标注"可用",而"系统级悬浮窗"如实标注"受限"——下一节解释这个设计决策。

六、能力如实降级:受限就明说

把跨平台框架的浮窗体验做上鸿蒙PC,绕不开一个诚实的架构问题:应用级的悬浮球窗口能不能置顶到所有应用之上? 答案取决于系统权限模型。GlintPod 的选择是:不伪造能力,把真实情况做成能力矩阵告诉用户。

Rust 侧用编译期常量区分目标环境:

const NATIVE_FLOAT_WINDOW: bool = cfg!(not(target_env = "ohos"));

#[tauri::command]
fn platform_report() -> PlatformReport {
    // ... 8 项能力逐条上报:supported / note
    cap("native_float", "系统级悬浮窗", NATIVE_FLOAT_WINDOW, "鸿蒙端由应用内闪控窗承载"),
}

鸿蒙PC真机上,NATIVE_FLOAT_WINDOW 编译期为 false,能力矩阵把这一项标注为"受限",说明文案是"鸿蒙端由应用内闪控窗承载"——闪控球和闪控窗在应用视口内完整可用,跨应用全局悬浮留待系统权限开放后自然升级。这种"能力探测 + 如实降级"的模式是我们系列项目反复验证的做法:与其让用户遇到难以理解的行为差异,不如把边界明明白白画出来。

日志窗与闪控日志:打开 log 窗、速算 181463 等操作轨迹逐条落盘

日志窗是整条闪控轨迹的存证:打开哪个闪控窗、速算了什么表达式、倒数何时完成,全部按时间戳落盘在 Rust 沙箱里,最多保留 50 条环形截断。

七、测试、构建与真机验证

GlintPod 的质量保障分两层:

Rust 单元测试 13 项:吸附判定四象限、表达式优先级与非法输入、倒数剩余时间与校验边界、快捕轮转删除、日志 50 条截断、探针目录回退、时间转换的纪元断言等。所有算法都以纯函数形态实现,测试不依赖 Tauri 运行时。

工程测试 7 项:用 Node 校验包名在 tauri.conf.json / app.json5 / Cargo.toml 三处一致、Rust 库名四处一致、SDK 版本为纯三段式 26.0.0、前端必须包含 browser-preview 降级标识、基础字号不低于 15px 等——这些断言把我们踩过的每一类发布事故都固化成了回归测试。

构建链路两条命令完成:

sh tools/build-rust.sh   # Rust release 编译 → libglintpod_lib.so(6.4MB)→ 拷入鸿蒙工程
sh tools/build-hap.sh    # ohpm install → hvigor assembleHap → 未签名 HAP(6.1MB)

特别提醒一个本系列反复强调的坑:Tauri 在编译期把 web/ 前端资产嵌入 .so。改了前端必须重跑 build-rust.sh 再打 HAP,否则真机上永远运行旧界面且无任何报错——GlintPod 的工程测试专门保留了这条链路的守护断言。

真机验证环节,我们把 HAP 安装到鸿蒙PC 2in1 设备上完整跑了一遍用户路径:拖动闪控球 → 松手贴边 → 展开快捷环 → 打开速算窗求值 → 切换倒数窗启动计时 → 查看日志窗轨迹 → 清屏重开应用确认球位复原。本文五张截图全部来自这一轮真机操作,顶部状态栏与底部 Dock 栏的鸿蒙PC系统特征清晰可辨。

八、复盘与下一步

回顾 GlintPod 的开发,有三条经验值得沉淀:

  1. 算法纯函数化是测试性的根基。吸附判定、表达式求值、倒数计算全部抽成不依赖 Tauri 状态的纯函数,13 项单元测试才得以在毫秒级跑完;命令函数只做参数校验、状态存取与转发。
  2. 归一化坐标是跨设备UI状态的通用语言。球位、快捷环位置全部以 0-1 比例存储,同一份持久化数据在不同分辨率的鸿蒙PC设备上语义一致。
  3. 能力矩阵是跨平台框架落地的诚实表达。Tauri 把 Web 技术带进了鸿蒙PC,但各端能力边界不同——与其遮掩,不如把"可用/受限"直接渲染给用户。

下一步计划把快捕窗升级为"跨应用投递"雏形:利用鸿蒙PC的系统分享通道,把闪捕片段一键发往其他应用;同时尝试为闪控球接入系统级悬浮窗权限,验证能力矩阵里那一项"受限"能否转为"可用"。

如果你也想在鸿蒙PC上用 Tauri 跨平台框架构建自己的应用,欢迎加入开源鸿蒙PC社区(https://harmonypc.csdn.net/)交流,或在 AtomGit 的 OpenHarmonyPCDeveloper 组织(https://atomgit.com/OpenHarmonyPCDeveloper)申请新建项目。GlintPod 的完整源码——15 个 Rust 命令、13 项单元测试、7 项工程测试——都在工程目录里,期待看到更多开发者用 Tauri 在鸿蒙PC上点亮自己的那颗"闪控球"。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐