用Tauri跨平台框架在鸿蒙PC上开发闪控球与闪控窗:GlintPod的悬浮交互、贴边吸附与离线速算实践
用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 交互主题的拆解
我们把"闪控球与闪控窗"这个主题拆成四个可落地的能力点:
- 闪控球拖拽:一颗 76px 的发光球体,可以在舞台内自由拖动;
- 贴边吸附:松手后自动吸附到最近的屏幕边缘,这是悬浮球类应用的经典体验;
- 快捷环展开:点击球体,围绕球心呈扇形弹出四个快捷入口——快捕(随手记)、速算(离线表达式求值)、倒数(计时器)、日志(操作轨迹);
- 闪控窗弹层:点快捷入口弹出对应功能的玻璃拟态浮窗,轻量完成任务后随手关闭。
这四个点合起来,正好构成"信息展示 + 轻量任务处理"的完整闭环,也覆盖了 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 标志区分"拖拽"和"点击"两种手势:拖过了就收起快捷环并持久化位置;原地松手则展开快捷环。

上图为鸿蒙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应用里最顺手的地方。

上图为鸿蒙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 纯函数里,同样有独立测试。

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

日志窗是整条闪控轨迹的存证:打开哪个闪控窗、速算了什么表达式、倒数何时完成,全部按时间戳落盘在 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 的开发,有三条经验值得沉淀:
- 算法纯函数化是测试性的根基。吸附判定、表达式求值、倒数计算全部抽成不依赖 Tauri 状态的纯函数,13 项单元测试才得以在毫秒级跑完;命令函数只做参数校验、状态存取与转发。
- 归一化坐标是跨设备UI状态的通用语言。球位、快捷环位置全部以 0-1 比例存储,同一份持久化数据在不同分辨率的鸿蒙PC设备上语义一致。
- 能力矩阵是跨平台框架落地的诚实表达。Tauri 把 Web 技术带进了鸿蒙PC,但各端能力边界不同——与其遮掩,不如把"可用/受限"直接渲染给用户。
下一步计划把快捕窗升级为"跨应用投递"雏形:利用鸿蒙PC的系统分享通道,把闪捕片段一键发往其他应用;同时尝试为闪控球接入系统级悬浮窗权限,验证能力矩阵里那一项"受限"能否转为"可用"。
如果你也想在鸿蒙PC上用 Tauri 跨平台框架构建自己的应用,欢迎加入开源鸿蒙PC社区(https://harmonypc.csdn.net/)交流,或在 AtomGit 的 OpenHarmonyPCDeveloper 组织(https://atomgit.com/OpenHarmonyPCDeveloper)申请新建项目。GlintPod 的完整源码——15 个 Rust 命令、13 项单元测试、7 项工程测试——都在工程目录里,期待看到更多开发者用 Tauri 在鸿蒙PC上点亮自己的那颗"闪控球"。
更多推荐





所有评论(0)