用Tauri跨平台框架在鸿蒙PC上开发系统能力观测站:Vantage的进程遥测、能力勘察与沙箱记录簿实践
用Tauri跨平台框架在鸿蒙PC上开发系统能力观测站:Vantage的进程遥测、能力勘察与沙箱记录簿实践
欢迎加入开源鸿蒙PC社区: https://harmonypc.csdn.net/
欢迎在PC社区平台申请新建项目:https://atomgit.com/OpenHarmonyPCDeveloper
前言
在开源鸿蒙PC生态里,围绕跨平台框架做应用开发的探索正在加速。继前几篇完成待办清单、便签、日历、性能实验室等主题之后,这一次我们把目光投向一个更"底层"的方向:把鸿蒙PC应用沙箱内的文件能力、外设状态与系统能力调用,做成一座可以"参观"的观测站——这就是 Vantage 观澜台(com.vantage.app)。

技术底座依然是 Tauri 这套跨平台框架:Rust 编写业务内核与命令层,Web 前端零依赖,两者通过 Tauri 的 IPC 机制(invoke)通信,最终以鸿蒙 HAP 形态运行在鸿蒙PC真机上。之所以选择 Tauri 这套跨平台框架,是因为它能让我们把"读系统"这类贴近底层的逻辑放进 Rust,而把呈现交给 Web,在鸿蒙PC上恰好形成一条清晰的观测链路:前端发起观测请求 → Rust 直读系统数据 → 沙箱落盘留痕。
与此前几个项目不同,Vantage 的设计语言走了一条"宣纸水墨"路线:米白宣纸底色、黛青主色、朱砂印章点缀,界面隐喻是一座观测站——系统能力是气象遥测、能力探测是观测点勘察、外设扫描是风向标、沙箱文件是记录簿、操作留痕是值班日志。
关键词:Tauri,跨平台框架,鸿蒙PC,开源鸿蒙,Rust,系统能力调用,沙箱文件IO,外设扫描,IPC,HAP
一、整体架构:三层观测链路
Vantage 的工程结构与标准 Tauri 项目一致,面向鸿蒙PC的部分由三块组成:
- Rust 内核层(
src-tauri/src/lib.rs):12 个#[tauri::command]命令,覆盖系统能力遥测、能力勘察、外设扫描、沙箱文件读写与日志持久化; - Web 前端层(
web/):单个 HTML + CSS + JS,无打包器、无框架依赖,通过window.__TAURI__.core.invoke与 Rust 通信; - 鸿蒙壳层(
src-tauri/gen/ohos/):标准 hvigor 鸿蒙工程,entry模块仅面向 2in1 设备,ArkTS 的EntryAbility加载 Rust 编译出的libvantage_lib.so。
这 12 个命令的清单如下:
app_info / greet —— 握手与身份自述
system_report —— 进程与系统遥测
capability_scan —— 沙箱能力勘察
peripheral_scan —— 外设(输入设备)扫描
file_write / file_list / file_read / file_delete —— 记录簿四件套
journal_log / journal_load / journal_clear —— 值班日志三件套
每一个命令都是真实实现:不读取任何前端伪造数据,系统能力层面能读到什么、读不到什么,界面上就如实显示什么。这也是本篇想传达的核心实践观——在鸿蒙PC的沙箱约束下,跨平台框架的能力边界必须靠真实探测来确认,而不是靠假设。
二、气象遥测:Rust 直读 /proc 的系统能力
观测站的第一站是"气象遥测"。Rust 侧直接读取 /proc/self/status 与 /proc/uptime,把进程线程数、系统持续运行时长等系统能力数据回传给前端:
fn read_u32_field(source: &str, key: &str) -> Option<u32> {
source
.lines()
.find(|line| line.starts_with(key))
.and_then(|line| line.split_whitespace().nth(1))
.and_then(|value| value.parse().ok())
}
fn read_uptime_seconds() -> Option<u64> {
let raw = fs::read_to_string("/proc/uptime").ok()?;
let head = raw.split_whitespace().next()?;
head.split('.').next()?.parse().ok()
}
#[tauri::command]
fn system_report() -> SystemReport {
let status = fs::read_to_string("/proc/self/status").ok();
let cwd = std::env::current_dir().ok();
let cwd_writable = cwd.as_ref().map(|dir| probe_writable(dir)).unwrap_or(false);
SystemReport {
pid: std::process::id(),
threads: status.as_deref().and_then(|s| read_u32_field(s, "Threads:")),
uptime_seconds: read_uptime_seconds(),
cwd: cwd.map(|p| p.display().to_string()),
cwd_writable,
page_size: 4096,
}
}
注意 threads 的写法:如果 /proc/self/status 不可读,返回的是 Option::None,前端就会显示"不可测",而不是伪装一个数字。前端对每个字段都有对应的降级文案,这是 Tauri 跨平台框架 IPC 双向设计里"如实标注"原则的体现——Rust 读不到的数据,宁可显示"不可测",也不给假数据。
前端拿到数据后,把 PID、线程数、运行时长渲染成"观测编号 / 观测线程 / 系统持续观测"等气象风格的读数卡片,同时补上前端自己的窗口遥测:视口尺寸、设备像素比、触控点数(navigator.maxTouchPoints)与页面语言。两路数据在同一屏汇合,构成完整的遥测视图。

三、观测能力:沙箱能力勘察与探测回退链
第二站"观测能力",回答的问题是:这座沙箱里,哪些系统能力真的可用? capability_scan 命令逐项探测四类能力:
- 沙箱文件存储:探测可写目录;
- 进程信息(/proc):确认
/proc/self/status可读性; - 输入外设节点(/dev/input):确认输入设备节点可枚举性;
- 环境变量:读取
PATH并回显。
其中"可写目录探测"是这个系列项目里反复沉淀的关键经验。鸿蒙PC真机上,app_data_dir 走的 XDG 路径在部分场景并不可写,直接写入会得到 os error 1。Vantage 沿用了探针回退链方案:
fn writable_dir(candidates: &[PathBuf]) -> Option<PathBuf> {
for dir in candidates {
if fs::create_dir_all(dir).is_ok() {
let probe = dir.join(".vantage-probe");
if fs::write(&probe, b"ok").is_ok() {
let _ = fs::remove_file(&probe);
return Some(dir.clone());
}
}
}
None
}
fn storage_dir(app: &tauri::AppHandle) -> Result<PathBuf, String> {
let mut candidates = Vec::new();
if let Ok(dir) = app.path().app_data_dir() {
candidates.push(dir.join("vantage"));
}
if cfg!(target_env = "ohos") {
candidates.push(PathBuf::from(
"/data/storage/el2/base/haps/entry/files/vantage",
));
candidates.push(PathBuf::from("/data/storage/el2/base/files/vantage"));
}
candidates.push(PathBuf::from("/data/local/tmp/vantage"));
candidates.push(std::env::temp_dir().join("vantage"));
writable_dir(&candidates).ok_or_else(|| "未找到可写的数据目录".to_string())
}
逻辑不复杂:候选目录逐个尝试"建目录 + 写探针文件 + 删探针",第一个真正可写的胜出。探测结果连同探测到的具体路径一起显示在界面上——所以"观测能力"页面上每一张卡片,都能看到本次运行时真实探测到的沙箱路径。这一段也在 Tauri 的 Rust 单测里覆盖(writable_dir_skips_unusable_candidates 等),确保回退链在桌面环境同样可验证。

四、风向标与记录簿:外设扫描与沙箱文件 IO
**外设扫描(风向标)**采用"Rust + 前端"双向合成。Rust 侧枚举 /dev/input 下的 event* 节点数量;同时前端把 navigator.maxTouchPoints 作为参数传入 peripheral_scan,两侧数据合成一份外设清单:键盘、指针设备、触控屏、显示输出。沙箱开放 /dev/input 时显示节点数;被沙箱限制时,界面如实标注"待遥测",并说明由前端事件补充。页面上还有一个 canvas 绘制的"指针气流仪":pointermove 事件的位移被压入一个 120 点的环形数组,逐帧绘制成气流波形,让外设状态变得可见、可玩。
记录簿则是完整的沙箱文件 IO 演示。Rust 侧四个命令构成一个最小但严谨的文件工作集:
fn valid_file_name(name: &str) -> bool {
!name.is_empty()
&& name.len() <= 40
&& !name.contains('/')
&& !name.contains('\\')
&& !name.starts_with('.')
}
#[tauri::command]
fn file_write(app: tauri::AppHandle, name: String, content: String) -> Result<PortFile, String> {
if !valid_file_name(&name) {
return Err("文件名需为 1-40 字符,且不含路径分隔符或以点开头".into());
}
if content.len() > 64 * 1024 {
return Err("文件内容超过 64KB 上限".into());
}
let dir = storage_dir(&app)?;
let path = dir.join(&name);
fs::write(&path, content.as_bytes()).map_err(|e| format!("写入失败:{e}"))?;
Ok(PortFile { name, content, updated_at: now_stamp() })
}
三道防线值得展开说:文件名校验(拒绝空名、超长、路径分隔符与点开头,防止穿越沙箱)、内容上限(64KB,防止误操作写爆存储)、错误透传(fs::write 的失败原因格式化后直接抛回前端 alert)。前端拿到 file_list 返回的清单后渲染成目录,双击可回填内容继续编辑,删除则是真实的 fs::remove_file。在鸿蒙PC真机上,这一页展示的每个文件名、每条更新时间,都来自 Rust 实际写进沙箱的字节。

五、值班日志与测试构建:把每一次观测留痕
所有观测动作都会调用 journal_log 记入日志,并在 Rust 侧持久化为 journal.json,保留最近 60 条。时间戳完全由 Rust 手写生成——不依赖任何 chrono 之类的依赖,format_epoch 把 Unix 秒数换算成 YYYY-MM-DD hh:mm,并用 format_epoch(0) == "1970-01-01 00:00" 这类断言在单测里锁住边界。这个"手写时间换算"还有个小故事:初版实现对闰年天数有过一次 off-by-one 风险,靠 epoch 断言测试当场抓出,这也是坚持给纯函数写单测的价值所在。
测试与构建链路同样是本系列的标准形态:
sh tools/test.sh:先cargo fmt --check再cargo test --target aarch64-unknown-linux-ohos --lib,Vantage 共 9 项 Rust 单测;npm test:8 项工程测试,断言包名一致(com.vantage.app)、Rust 库名四处一致(vantage_lib)、12 个命令在 Rust 侧齐全、沙箱回退链就位;sh tools/build-rust.sh && sh tools/build-hap.sh:release 构建 Rust cdylib → hvigor 打 HAP。
两点提醒沿用自前几篇的踩坑实录:其一,Tauri 在编译期把 web/ 前端嵌入动态库,改了前端必须重编 Rust 再打 HAP,否则真机界面纹丝不动且无任何报错;其二,签名 profile 与包名绑定,新项目要用 devecocli 按 com.vantage.app 重新生成 profile,不要复用其他应用的共享 profile。
六、复盘:跨平台框架在鸿蒙PC上的"如实探测"之道
Vantage 的开发过程再次验证了用 Tauri 这套跨平台框架开发鸿蒙PC应用的几个判断:
- 系统能力调用要靠探测,不靠假设。沙箱给什么、不给什么,
capability_scan给出的是运行时答案,前端只负责如实呈现; - Rust 内核是天生的"观测员"。读
/proc、试写探针、枚举/dev/input,这些贴近底层的动作在 Rust 里都是几十行的事,而 Tauri IPC 把结果干净地送到 Web 层; - 纯函数 + 单测是低成本高回报的投资。时间换算、文件名校验、回退链,全部是被测试抓过或保住过的逻辑;
- UI 隐喻服务于信息密度。"气象遥测/观测点/风向标/记录簿"这套隐喻,让枯燥的系统能力数据有了叙事感,同时保证正文字号在真机上舒适可读。
Vantage 的全部代码工程已随本系列沉淀,后续我们计划把其中的能力勘察模块抽出为可复用的 Rust 模块,供更多鸿蒙PC上的 Tauri 应用直接取用。也欢迎在 AtomGit 的 OpenHarmonyPCDeveloper 组织里交流共建,一起把开源鸿蒙PC的跨平台框架生态做厚。
(投稿前小贴士:本文三张配图来自鸿蒙PC真机截屏,因截图识别服务暂不可用,图注按功能页面顺序撰写,发布前请人工核对图序与画面内容是否一致。)
更多推荐




所有评论(0)