鸿蒙 PC 的 Tauri 工作回执台,三次提交都指向同一张回执
Tauri鸿蒙适配分支AtomGit入口 · 工作回执台完整工程 · 鸿蒙 PC 开发者社区
三条回应,把正式清单增加一条
值班人员在确认卸货口时,可能遇到操作后暂时没看到结果,便重新点一次提交。工作回执台把这类重复调用搬到同一个窗口中验收。TK-041 是「核对卸货口」,页面给它一个「同时提交三次」的按钮。点击一次就发三份相同的 Tauri 调用,专门观察它们是否生成了重复的工作记录。另一个任务 TK-052 用来检查正常的新任务还能不能拿到下一张回执。
本机的旧版演示账上已有两条,只用其中的 TK-041 做重试,最多能看到返回旧结果。我先保存这个应用自己的两条样例数据副本并核对校验和,用空数组准备一份干净的验收起点。MateBook 14 上签名安装 1.0.1 后,界面读到「还没有本机回执」,计数为零。这时按下三次提交的专用按钮。原生日志在同一毫秒记了 1 条新建、2 条返回已有回执,指向的都是 RCPT-1。窗口下方出现三条操作记录,右侧正式列表只显示一条。

我再读见本机 JSON 中确实只有一个对象,对应任务 TK-041 和回执 RCPT-1。这样可以排除只是前端把重复条目过滤掉了。提交 TK-052 后,右侧列表增加 RCPT-2。我结束应用进程并重新开,操作区清空,右侧仍能读回两条。然后在窄窗口按一次 TK-041 的普通「提交」,屏幕显示返回已有回执,正式计数保持两条。两个工单分别拿到自己的回执,同一个工单始终认得原回执。
复测时这两类证据都要留下。日志能看见同一毫秒内返回了三条消息,但毫秒级时间戳看不出哪个请求先完成文件写入。保存第一轮之后的文件副本,可以独立核对任务编号和回执号,只数文件里的对象也能得到一条。再次提交时先读请求回执,再看正式清单是否多了同名记录。下一班拿到截图和文件就能自己对照结果,无需依赖操作人员对点击顺序的回忆。
| 实际操作 | 请求区或当前回执 | 从本机文件读出的正式记录 |
| 空账时三次提交 TK-041 | 新建一次、返回已有两次,均为 RCPT-1 | 1 条 |
| 提交 TK-052 | TK-052 获得 RCPT-2 | 2 条,任务各有一条 |
| 结束进程再打开 | 本次操作为空 | 仍为 RCPT-1、RCPT-2 |
| 窄窗再提交 TK-041 | 返回 RCPT-1 | 仍为 2 条 |


验收结束后,把设备上的两条演示数据与复测前的备份逐字节对照,哈希相同。下方保留先前录的连续动作,环境和帧率以各自图注为准。本轮真机截图和本机编译日志来自改稿实测。
MateBook 14 真机工作回执完整流程。并发提交,同一回执;另一个任务得到新回执;重启后再返回已有回执。平均 7.28 fps,动作段有效帧率 8.09 fps,无音轨。
MateBook Pro 模拟器任务提交和重启。从已确认空表开始,平均约 3.5 fps,四个动作段去重后 3.11 至 3.75 fps,无音轨。
这轮先备份应用自己的两条样例回执,再从空账开始录像。三次提交TK-041后,操作区有一条新建、两条返回已有,全都指向RCPT-1;从沙箱读出的JSON只有一个对象。提交TK-052,再结束进程重开,右侧仍有两条,左下操作区清空。最后再提交TK-041,当前操作返回原RCPT-1,账本仍只有两条。

录制请求上限60 fps,正文只取真实业务段,不用录屏工具窗口的过渡抬高数字。这段原片平均6.43 fps,GIF保留74个实采画面、11.68秒,平均6.34 fps。界面主要是几次静态列表重绘和启动等待,没有添加帧或插帧。下面保留完整截图,便于停下来读三条响应与重开后的单次重放。


采完后恢复复测前的187字节样例账本,读回与备份逐字节相同,SHA-256为 eed98825a203b64eb54d30e3eaa314225f488f53461b08f6a09748ca6cc640ae。这个恢复检查只涉及本测试应用自己的固定样例,不修改其他应用数据。模拟器已启动,当前1.0.1 Rust库仍仅编译ARM64,历史x86视频不作为本轮同包通过证据。
一条已经落盘的记录,允许三次回应
用鼠标试出三条日志只是第一步。右侧回执表重新读的是本地文件,下方「本次操作」显示的是每份请求各自得到的答复。网页连续发三次 invoke,Tauri 把参数交给 Rust 的 submit_task。三个调用都是同一个任务编号。Rust 端只根据业务标识查重,网页有没有禁用提交按钮不影响这个判断。
Rust 入口先验证任务编号属于这份工程的两条固定任务,再锁住 ReceiptStore。现在去找文件、读已有记录、按编号搜、必要时追加并完成保存。一条记录真正写入后才归还锁。后来的请求拿锁读到相同任务,就把整条回执克隆出去,结果标记为 replayed。第一次成功创建返回 created。页面继续使用 Rust 返回的回执号,不从请求先后或按钮位置推算。
容易漏掉的范围是锁覆盖多久。若读取时加锁、查重时已经放开,两个请求有机会各自看到一份空清单。它们随后都生成一个新回执,最后一次保存甚至可能覆盖另一份结果。这个工程把锁持有到读、查、写全部完成,连列表读回也用同一个进程内锁。示例条件是一个 Tauri 进程使用自己的应用数据目录。跨进程、多人一起确认和服务端部署都需要由存储层实现唯一约束和事务。
fn save(path: &Path, receipts: &[Receipt]) -> Result<(), String> {
let data = serde_json::to_vec_pretty(receipts).map_err(|error| error.to_string())?;
let staging = path.with_extension("tmp");
let result = (|| -> io::Result<()> {
let mut file = OpenOptions::new().create(true).truncate(true).write(true).open(&staging)?;
file.write_all(&data)?;
file.sync_all()?;
drop(file);
fs::rename(&staging, path)
})();
if result.is_err() {
let _ = fs::remove_file(&staging);
}
result.map_err(|error| format!("保存回执失败:{error}"))
}
#[tauri::command]
pub(crate) fn list_receipts(app: tauri::AppHandle, store: tauri::State<'_, ReceiptStore>) -> Result<Vec<Receipt>, String> {
let _guard = store.0.lock().map_err(|_| "回执存储暂时不可用".to_string())?;
load(&receipt_path(&app)?)
}
#[tauri::command]
pub(crate) async fn submit_task(
task_id: String, app: tauri::AppHandle, store: tauri::State<'_, ReceiptStore>,
) -> Result<Submission, String> {
let label = TASKS.iter().find(|(id, _)| *id == task_id)
.map(|(_, label)| *label)
.ok_or_else(|| "未知任务编号".to_string())?;
let _guard = store.0.lock().map_err(|_| "回执存储暂时不可用".to_string())?;
let path = receipt_path(&app)?;
let mut receipts = load(&path)?;
if let Some(receipt) = receipts.iter().find(|entry| entry.task_id == task_id) {
return Ok(Submission { outcome: "replayed", receipt: receipt.clone() });
}
let receipt = Receipt {
receipt_id: format!("RCPT-{}", receipts.len() + 1),
label: label.to_string(),
task_id,
};
receipts.push(receipt.clone());
save(&path, &receipts)?;
Ok(Submission { outcome: "created", receipt })
}
写盘途中用同目录暂存文件容纳完整 JSON,先写入和同步文件内容,再用 rename 替换目标路径。打开旧记录报「不存在」会给出空列表,格式坏掉则报告读取失败。在后一种情况下直接返回空数组会害后续提交把旧文件覆盖掉。这里保留错误,提醒使用者先查原数据。这次验收覆盖正常提交、重复提交和结束进程后重开,断电时的恢复范围需要另测。
前端让三份 invoke 一起发出,再用 Promise.allSettled 显示每项结果。哪一份请求先拿到锁由运行时决定,弹出的操作行不能拿来当数据库的写入顺序。把页面最下面的日志和正式列表放在同一窗口,是为了让现场一眼区分「按了几次」和「留下几条」。前端重新读文件时还带自己的刷新序号,晚返回的旧读请求不会盖掉新的显示。
async function refresh(): Promise<void> {
const generation = ++readGeneration;
const receipts = await invoke<Receipt[]>('list_receipts');
if (generation !== readGeneration) return;
byId('count').textContent = receipts.length + ' 条';
byId('receipts').replaceChildren(...(receipts.length
? receipts.map((item) => entry(item.receiptId + ' · ' + item.taskId + ' · ' + item.label))
: [entry('还没有本机回执')]));
}
async function submit(id: string, count: number): Promise<void> {
status.textContent = '正在提交 ' + id + '。';
const attempts = Array.from({length: count}, () => invoke<Submission>('submit_task', {taskId: id}));
for (const result of await Promise.allSettled(attempts)) {
if (result.status === 'fulfilled') {
const {outcome, receipt} = result.value;
const text = receipt.taskId + ' · ' + receipt.receiptId + (outcome === 'created' ? ' · 新建' : ' · 返回已有回执');
log.prepend(entry(text));
console.info('TaskReceipts', text);
} else {
log.prepend(entry(id + ' · 提交失败 · ' + String(result.reason)));
}
}
while (log.children.length > 6) log.lastElementChild?.remove();
try {
await refresh();
status.textContent = '已从本机文件重新读取回执。';
} catch (error) {
status.textContent = '无法读取回执 · ' + String(error);
}
}
从工程里的两套源码做到签名 HAP
本次把源文件副本解到 MateBook 14 本机目录,在鸿蒙电脑上生成网页资源、ARM64 Rust 动态库以及可安装 HAP。项目根目录有网页代码,src-tauri 放 Rust 命令,src-tauri/gen/ohos 是 DevEco Studio 打开的宿主。临时目录里可看到前端输出的 app.js、app.css 和 index.html,Rust 业务产物再放到宿主的 entry/libs/arm64-v8a。只重新打宿主的 HAP,可能装到旧网页和旧的库,所以这次三步分别留了日志。
前端在本机用 package-lock 还原依赖,使用 esbuild-wasm 在 Node 内生成离线包,检查 app.js 可解析。Cargo 锁定了 Tauri、Tao、Wry 和 OpenHarmony Ability 的源码版本。本机网络曾无法直接访问这些 Git 地址,构建时使用 MateBook 上已准备的同提交源码缓存。缓存目录内是依赖源码,项目使用单独的构建输出目录。Rust 目标是 aarch64-unknown-linux-ohos,启用 tauri/custom-protocol,把实际生成的 dist 放进应用运行路径。没有启用时,应用看起来能启动,却可能停在白色 Web 窗口。
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
export CARGO_HOME="$HOME/Documents/ugc-native-39/cargo-source-cache"
export CARGO_TARGET_DIR="$HOME/Documents/ugc-native-50/native-target-signed"
export CARGO_HTTP_SSL_CAINFO="$HOME/.harmonybrew/etc/ca-certificates/cert.pem"
export OHOS_NDK_HOME="$DEVECO_SDK_HOME/default/openharmony/native"
export LIBCLANG_PATH="$OHOS_NDK_HOME/llvm/lib"
export CARGO_TARGET_AARCH64_UNKNOWN_LINUX_OHOS_LINKER="$HOME/.harmonybrew/bin/cc"
export CC_aarch64_unknown_linux_ohos="$HOME/.harmonybrew/bin/cc"
export CXX_aarch64_unknown_linux_ohos="$HOME/.harmonybrew/bin/c++"
export AR_aarch64_unknown_linux_ohos="$OHOS_NDK_HOME/llvm/bin/llvm-ar"
export TAURI_ENV_DEBUG=false
export TAURI_ENV_TARGET_TRIPLE=aarch64-unknown-linux-ohos
export WRY_OHOS_PACKAGE=com.aasd23.ugctauritaskreceipts
export WRY_OHOS_LIBRARY=tauri_ohos_test_lib
export TAURI_OHOS_PACKAGE_UNESCAPED=com.aasd23.ugctauritaskreceipts
export TAURI_OHOS_PROJECT_PATH="$PWD/src-tauri/gen/ohos"
export CARGO_BUILD_JOBS=4
test -f dist/index.html
test -f dist/app.js
test -f dist/app.css
rustc --version
cargo --version
cd src-tauri
cargo build --locked --release --target aarch64-unknown-linux-ohos --lib --features tauri/custom-protocol
artifact="$CARGO_TARGET_DIR/aarch64-unknown-linux-ohos/release/libtauri_ohos_test_lib.so"
test -s "$artifact"
mkdir -p gen/ohos/entry/libs/arm64-v8a
cp "$artifact" gen/ohos/entry/libs/arm64-v8a/
ls -l gen/ohos/entry/libs/arm64-v8a/libtauri_ohos_test_lib.so
cd gen/ohos
ohpm install --all
hvigorw --mode module -p product=default -p module=entry@default -p buildMode=debug assembleHap --no-daemon
ls -l entry/build/default/outputs/default/*.hap
本机 cargo 实际编译 3 分 12 秒,生成 7,624,512 字节的动态库。宿主执行 34 项任务,用了 12.111 秒。第一次运行时,未签名包在包管理器处返回 9568320。按 DevEco 的提示打开项目结构,生成该应用包名的调试签名,接着重新运行。「此电脑」装上的签名 HAP 版本为 1.0.1(版本号 2)。查看应用信息要读实际安装版本。把版本填过源码后就拿旧窗口截图,仍然无法证明确实在新包执行。
| 环境和产物 | 本次记录 |
| 鸿蒙电脑 | 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,Harmonybrew 的 Rust/Cargo 1.99.1,Tauri 2.11.2 鸿蒙适配分支 |
| HAP | 未签名 8,050,452 字节,签名 8,171,496 字节,真机 1.0.1(2) |
| 模拟器 | MateBook Pro 2in1,管理器配置HarmonyOS6.1.1(API24),运行软件6.1.0.125(SP12DEVC00E47R1P3),API24,x86_64。模拟器已启动;当前1.0.1只生成ARM64库,保留的视频属1.0.0历史对照。 |



FAQ|验收时回看哪一列
重开后,「本次操作」没有三条,是否落盘失败。 打开右侧「已保存回执」核对任务和回执编号。操作列表只用于当场观察,请求已保存的证据是独立的清单。应用结束后再打开,这两个区域应当给出不同的结果。还要再点一次提交,看 Rust 是返回已有回执还是生成新的序号。
重复请求是否始终返回旧结果。 要看业务如何定义同一次确认。样例每个任务只允许确认一次。正式业务可能同一任务每天都需要复核,也可能允许撤回然后重新发起。应把日期、班次或确认轮次纳入业务定义,再据此确定唯一键。复测时可以用同任务、同轮次和新轮次分别对照。
主窗口启动了,怎样确认网页可用。 除了日志中的启动成功,还要等界面右侧给出已读取本机回执,点一次实际任务看两边是否更新。如果只有白底,先检查网页产物是否生成,再检查 Rust 启用本地资源协议及宿主运行日志。这样可以把元素没出现、桥接不能调用和业务写盘失败分开。
交接时先读工单和回执
三份回应说明各次请求都有结果,持久清单只有一条才满足同任务重复提交的验收条件。再提交独立任务、结束进程重开并重试原任务,才能同时检查新回执与旧回执。完整修订工程已在文首固定目录公开,源码、锁定框架及本机安装步骤可分别核对。
更多推荐

所有评论(0)