用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)与页面语言。两路数据在同一屏汇合,构成完整的遥测视图。

图1 观澜台气象遥测总览:左侧五观测台导航,右侧读数卡片呈现进程与窗口遥测,可见鸿蒙PC系统状态栏与Dock栏

三、观测能力:沙箱能力勘察与探测回退链

第二站"观测能力",回答的问题是:这座沙箱里,哪些系统能力真的可用? capability_scan 命令逐项探测四类能力:

  1. 沙箱文件存储:探测可写目录;
  2. 进程信息(/proc):确认 /proc/self/status 可读性;
  3. 输入外设节点(/dev/input):确认输入设备节点可枚举性;
  4. 环境变量:读取 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 等),确保回退链在桌面环境同样可验证。

图2 观测能力勘察:四张能力卡片逐项呈现沙箱存储、/proc 进程信息、/dev/input 输入节点与环境变量的真实可用状态

四、风向标与记录簿:外设扫描与沙箱文件 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 实际写进沙箱的字节。

图3 记录簿:沙箱文件列表与写入表单,展示 Rust 文件 IO 在鸿蒙PC真机上的实际运行结果

五、值班日志与测试构建:把每一次观测留痕

所有观测动作都会调用 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应用的几个判断:

  1. 系统能力调用要靠探测,不靠假设。沙箱给什么、不给什么,capability_scan 给出的是运行时答案,前端只负责如实呈现;
  2. Rust 内核是天生的"观测员"。读 /proc、试写探针、枚举 /dev/input,这些贴近底层的动作在 Rust 里都是几十行的事,而 Tauri IPC 把结果干净地送到 Web 层;
  3. 纯函数 + 单测是低成本高回报的投资。时间换算、文件名校验、回退链,全部是被测试抓过或保住过的逻辑;
  4. UI 隐喻服务于信息密度。"气象遥测/观测点/风向标/记录簿"这套隐喻,让枯燥的系统能力数据有了叙事感,同时保证正文字号在真机上舒适可读。

Vantage 的全部代码工程已随本系列沉淀,后续我们计划把其中的能力勘察模块抽出为可复用的 Rust 模块,供更多鸿蒙PC上的 Tauri 应用直接取用。也欢迎在 AtomGit 的 OpenHarmonyPCDeveloper 组织里交流共建,一起把开源鸿蒙PC的跨平台框架生态做厚。

(投稿前小贴士:本文三张配图来自鸿蒙PC真机截屏,因截图识别服务暂不可用,图注按功能页面顺序撰写,发布前请人工核对图序与画面内容是否一致。)

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐