框架与适配 · Tauri 框架源码镜像 · Tauri 上游鸿蒙适配分支
桌面搜索框里,用户经常没等第一次查询结束就改了词。旧请求晚回来时若可以直接改结果区,刚显示的新结果可能被覆盖,取消日志也会让人误读。这篇把请求编号、结果区实际内容和后台完成顺序并排看,分别检查撤销工作与防止旧结果上屏。
日志先写出 sensor 已显示,过了约十毫秒,旧的 be 才报取消。读鸿蒙 PC 上这组 Tauri 搜索记录,要是只看最后一条,会误以为刚显示的结果也取消了。两条完成记录属于不同的请求。本文把一次重叠查询按顺序摊开,说明每条记录能证明到哪一步。
15:56:48.709 id=1 query=be phase=pending
15:56:48.949 id=2 query=sensor phase=pending
15:56:48.957 id=2 query=sensor phase=applied
15:56:48.967 id=1 query=be phase=cancelled
T₀:发出 be,故意让它慢一点
按「演示连续查询」会先发 be,后台给它预留 1350 毫秒的等待时间。前端等约 230 毫秒后再发 sensor,第二次不加等待。这个间隔是为了把请求的重叠暴露出来。执行结果看右侧的请求记录和左侧最终显示值,单看输入框只能知道最后键入了什么。

MateBook Pro 模拟器全屏,Tauri 备件查找加载了本地页面
1350 毫秒是加在旧请求里的测试等待。它给下一次调用留下可重叠的区间,不代表搜两件备件要花这么久。复测应先找到两条 pending,确认第二次到达时第一次仍在等待。若两个调用已经先后完成,那么各自显示结果也合理;那样的运行没有测到这里需要的取消分支。
T₁:sensor 完成,窗口还显示谁

鸿蒙 PC 模拟器全屏,新请求显示 sensor,旧请求在记录中标为已停止
MateBook 14 上,旧任务晚三毫秒报取消
下面是前次签名包 1.0.0 在 MateBook 14 上的业务实测。本次本机重建用的是相同业务入口,但目前只产出了前端资源。读这段日志时看请求编号而非最后一行,这样才能明确哪个结果进了结果区,哪个任务被 Rust 停下。
| 运行环境 | 设备版本 | 实测 |
|---|---|---|
| HUAWEI MateBook 14(MNTXM-24B) | HarmonyOS 7.0.0,软件 7.0.0.115(SP11C00E103R12P2patch01),API 26.0.0,aarch64 | 签名安装;sensor 显示,be 取消;gasket 正常完成且无命中 |
| MateBook Pro 2in1 模拟器 | HarmonyOS 6.1.0,软件 6.1.0.125(SP12DEVC00E47R1P3),API 6.1.1(24),x86_64 | 重叠查询对照、宽窄窗与演示 GIF |

MateBook 14 真机关于本机全屏,型号和系统版本

MateBook 14 真机全屏,旧请求已取消,左侧仍显示 sensor 的结果

MateBook 14 真机全屏,gasket 查询正常完成并显示无匹配
MateBook 14 全屏实录。连续查询时,左侧保留 sensor,右侧记录显示 Rust 已停止较早的 be 请求。再单独搜索 gasket,页面显示「没有匹配记录」,请求记录仍保留。原始 MP4 为 2880 × 1920,整段约 60 fps。

install bundle successfully.
start ability successfully.
versionName: 1.0.0
19:37:54.851 id=1 query=be phase=pending
19:37:55.085 id=2 query=sensor phase=pending
19:37:55.096 id=2 query=sensor phase=applied
19:37:55.099 id=1 query=be phase=cancelled
19:38:29.121 id=4 query=gasket phase=applied
复测空结果时,要先选中并替换搜索词。第一次直接输入得到的是 sensorgasket,界面虽然也没有命中,却是不同输入。第二次用全选覆盖,才留下 gasket 对应的结果和日志。
前端自己的序号只管渲染。如果旧查询刚结束、随后才有新调用,旧响应可能已在回传途中。前端收到成功结果后仍会核对该次调用是不是最新的,只有最新一次才可写结果区。旧任务返回取消时也只增加一行记录,以免把新结果换成「已取消」。这一轮在鸿蒙 PC 观察到了 Rust 取消分支;旧请求恰好成功并被前端丢弃的分支留作另一项验证。
请求在 Rust 里已经结束,响应却还可能在回前端的途中。页面给每次调用记一个序号,接到结果后再比较当前序号。较旧的成功回调应被页面丢弃。此次鸿蒙 PC 实测里,旧的 be 走到了 Rust 的取消分支;恰好成功后又被页面丢弃属于代码处理的另一路,现有这条运行记录无法证明它发生过。
T₂:be 被取消,状态只记在右栏
Tauri 用 invoke 把输入送到 Rust 命令。每次进入命令会分配一个新的序号,阻塞任务在等待期间检查当前最新序号。一旦看见新请求,旧任务返回 CANCELLED。这种取消是协作式的。例子把模拟等待切成短间隔,真实的扫描或解析也得在可中断的边界加上检查;如果底层调用在一个长操作中无法返回,前端也不能替 Rust 停下那段工作。 Tauri 调用 Rust 命令
#[tauri::command]
async fn search_local(query: String, delay_ms: u64) -> Result<String, String> {
use std::sync::atomic::{AtomicU64, Ordering};
static GENERATION: AtomicU64 = AtomicU64::new(0);
let id = GENERATION.fetch_add(1, Ordering::SeqCst) + 1;
tauri::async_runtime::spawn_blocking(move || {
let until = std::time::Instant::now() + std::time::Duration::from_millis(delay_ms.min(1500));
while std::time::Instant::now() < until {
if GENERATION.load(Ordering::SeqCst) != id {
return Err("CANCELLED".to_string());
}
std::thread::sleep(std::time::Duration::from_millis(15));
}
Ok(["bearing", "belt", "sensor"].into_iter().filter(|item| item.contains(&query))
.collect::<Vec<_>>().join(", "))
}).await.map_err(|error| error.to_string())?
}
Rust 循环以短间隔检查原子序号。新请求到达就让旧工作在下一个检查点退出。已经进入一段不可中断的底层调用时,这种机制要等它返回才能检查序号。更重要的是作用范围。当前后台只服务一个窗口,如果两个窗口能各自查找,要把最新序号划到不同会话,避免一边键入就让另一边的搜索停掉。
import { invoke } from '@tauri-apps/api/core';
import './search.css';
document.querySelector('#app')!.innerHTML = `
<main>
<header><div class="mark" aria-hidden="true">⌕</div><div>
<h1>备件快速查找</h1><p>搜索本地备件,检查连续查询时哪个结果会留在屏幕上。</p>
</div></header>
<div class="query">
<label for="query">物料关键字</label>
<div class="input-row"><input id="query" placeholder="bearing、belt、sensor" autocomplete="off" />
<button id="submit" type="button">查找</button></div>
<button id="compare" type="button" class="secondary">演示连续查询</button>
</div>
<div class="workspace">
<section><h2>当前结果</h2><p id="result" role="status">等待查询</p></section>
<section><h2>请求记录</h2><ol id="history" aria-label="请求记录"></ol></section>
</div>
</main>`;
const query = document.querySelector<HTMLInputElement>('#query')!;
const result = document.querySelector<HTMLParagraphElement>('#result')!;
const history = document.querySelector<HTMLOListElement>('#history')!;
const compare = document.querySelector<HTMLButtonElement>('#compare')!;
let latest = 0;
function trace(id: number, value: string, phase: string, visible: string) {
const item = document.createElement('li');
const name = document.createElement('strong');
name.textContent = '#' + id + ' · ' + value;
const status = document.createElement('span');
status.textContent = visible;
item.dataset.phase = phase;
item.append(name, status);
history.prepend(item);
if (history.children.length > 9) history.lastElementChild?.remove();
console.info('UGC_TAURI_SEARCH id=' + id + ' query=' + value + ' phase=' + phase);
}
async function search(value: string, delayMs: number) {
const id = ++latest;
result.textContent = '正在查找 ' + value;
trace(id, value, 'pending', '已发出');
try {
const found = await invoke<string>('search_local', { query: value, delayMs });
if (id !== latest) {
trace(id, value, 'stale', '旧结果已忽略');
return;
}
result.textContent = found || '没有匹配记录';
trace(id, value, 'applied', '已显示');
} catch (error) {
if (String(error) === 'CANCELLED') {
trace(id, value, 'cancelled', 'Rust 已停止旧查询');
} else {
trace(id, value, 'failed', '查询失败');
if (id === latest) result.textContent = '查询失败:' + String(error);
}
}
}
function submit() {
const value = query.value.trim().toLowerCase();
if (value) void search(value, 0);
}
document.querySelector('#submit')!.addEventListener('click', submit);
query.addEventListener('keydown', event => { if (event.key === 'Enter') submit(); });
compare.addEventListener('click', async () => {
compare.disabled = true;
try {
query.value = 'be';
const older = search('be', 1350);
await new Promise(resolve => setTimeout(resolve, 230));
query.value = 'sensor';
await Promise.all([older, search('sensor', 0)]);
} finally {
compare.disabled = false;
}
});
| 请求 | 注入条件 | 通过条件 |
|---|---|---|
| be | 先发送,带 1350 毫秒等待 | 日志记录 cancelled,旧查询退出 |
| sensor | 后发送,等待为零 | 日志记录 applied,结果显示 sensor |
| 缩窄窗口 | 请求记录移到结果下方 | 同一页面实例保持当前结果 |
| 手动查找 gasket | 本地样本里没有匹配 | 显示「没有匹配记录」 |
用 gasket 还做了一次无命中对照。没有匹配项依然是已完成的查询,页面显示空结果,日志为 applied。取消记录则属于前一个任务。把两种结果都留在日志上,遇到空页面时可以区分用户查错词、后台被更新替代、页面没应用结果三种情况。

鸿蒙 PC 模拟器全屏,手动搜索未收录的 gasket
界面参考了 VS Code Quick Open 把搜索框放在结果前面的做法。这里把当前命中和请求记录分开,便于看到新结果是否留下,以及旧任务有没有继续跑。窗口收窄时两块内容上下排列,输入框、当前结果和记录仍使用原来的节点。 VS Code 的 Quick Open

鸿蒙 PC 模拟器窄窗全屏,当前结果与请求记录改为上下排列

模拟器实录,先演示连续查找,再缩窗并查询一个未命中的关键字
模拟器 GIF 保留 90 个不同画面,共 13.08 秒。当前结果与右栏历史属于同一次操作,查看时按请求编号分别追踪。MateBook 14 视频为前次 1.0.0 实录,当前重建进度另见下面的终端输出。
早期模拟器的系统版本

MateBook Pro 模拟器原生关于本机,保留系统栏和软件版本
在 MateBook 14 上能重建到哪一步
这次重新拿源码,从 DevEco Studio 的终端开始。根目录的 src/main.ts 保存搜索入口和请求序号,src/search.css 负责把当前结果与请求记录分栏,src-tauri/src/lib.rs 注册 search_local。先核对前端调用名和 Rust 注册名一致,再打开 src-tauri/gen/ohos 查看入口模块。如果把生成的鸿蒙工程误当完整源码根目录,项目能在 IDE 打开,但在那一层找不到前端的依赖锁文件,运行构建命令也就无法重建页面。
| 环境 | 版本和验证范围 |
|---|---|
| 本次重建的鸿蒙 PC | HUAWEI MateBook 14(MNTXM-24B),HarmonyOS 7.0.0,软件 7.0.0.115(SP11C00E103R12P2patch01),API 26.0.0,aarch64。DevEco Studio 26.0.0.220,Node.js 24.18.1,esbuild-wasm 0.28.2。 |
| 早期模拟器运行 | MateBook Pro 2in1,HarmonyOS 6.1.0,软件 6.1.0.125(SP12DEVC00E47R1P3),API 24,x86_64。使用已构建的调试 HAP 观察请求重叠。 |
在工程根目录恢复锁定的依赖,再用 WebAssembly 版的构建器生成资源。这里单独处理前端,是为了确认页面、事件和调用参数有没有独立的打包问题。脚本从 src/main.ts 打包 JS 和 CSS,并把 HTML 里的开发入口换成同目录的 app.js。Tauri 配置的 frontendDist 指向这些文件所在的目录。完成后逐一查看文件和脚本语法,避免把上次遗留的产物当成本次输出。
node -v
npm ci --ignore-scripts
npm install --ignore-scripts --no-save --package-lock=false esbuild-wasm@0.28.2
node build-native-frontend.mjs
node --check dist/app.js
ls -l dist

MateBook 14 原生 DevEco Studio 终端,本次产出 dist 内三份前端资源,系统栏保留
Rust 的验证从编译器本身开始。在同一台 MateBook 14 上,已校验归档的鸿蒙 arm64 Rust 工具链执行 rustc --version 时,终端返回 zsh: permission denied。这个命令还没有读取当前项目的 Cargo 配置,就已经停了。因此目前无法判断搜索代码在本次本机链接里的结果,也没有生成本轮签名 HAP。

同一台 MateBook 14 上,Rust 编译器在版本查询阶段被系统拒绝,未进入项目构建
恢复受支持的本机工具链以后,先确认 rustc --version、cargo --version 都能运行,再给当前 Rust 目标配置鸿蒙 SDK 的链接器和系统库,编译并核对包内的 arm64 动态库。在 DevEco 打开生成的 hm 工程时还要复核目标模块声明了 2in1,并用该项目包名对应的调试证书签名。这些是下一次实际安装的验收点。检测到窗口能打开时再点连续查询,必须等到真正的 Rust 响应才算完成调用链。页面 HTML 能离线加载,只覆盖了资源装载这一段。
FAQ
结果区一直显示正在查找,先看哪里? 先看记录里是否出现新的 pending,再看这一条有没有后续事件。点击后连 pending 都没有,先确认事件绑定和搜索词。出现 pending 但没有 applied 或 cancelled 时,再确认安装包是否包含 Rust 库以及命令是否注册。这次本机复测停在工具链启动阶段,不能用早期包能够执行命令来证明新产物正常。
取消一定排在新结果之后吗? 调度顺序会变化。只要较早的编号进入取消分支、较新的编号写入结果,就满足这组测试。即使旧任务赶在新请求之前完成运算,只要响应到达页面时编号已经过期,前端也应丢掉它。想覆盖这一小段竞态,需要单独控制消息返回的顺序;现有录屏只覆盖后台主动取消。
验收结论
早期运行通过三条不同的观察记录:旧编号取消,新编号显示 sensor,另一次 gasket 得到正常的空结果。本次本机重建确认需要的三个前端文件已生成,Rust 工具链的运行权限仍是后续打包的前置条件。要补足从源码到安装的证据,应先产出同版签名包,再重新走一遍连续查询和未命中,两次结果各自按请求编号核对。