鸿蒙 PC 上的 Tauri 库存文件核验,把截断定位到 0x0E
Tauri鸿蒙适配分支的AtomGit入口 · 库存文件核验完整工程 · 鸿蒙 PC 开发者社区
前言
仓库导入程序收到一份十九字节的库存清单。表头写着两条,第一条又确实读得出来。如果界面一边读一边发布结果,接班人会先看到一条貌似能用的库存记录,最后才知道余下内容没传完。我用鸿蒙 PC 上的 Tauri 做了一个文件核验练习,让读取失败明确指到记录的偏移,并且整份文件通过后才生成明细。
这个工程使用三组固定字节作为模拟待交接文件。样例以 .bin 命名,前端在页面里提供字节数组,会调用同一个 Rust 命令,未实现读取任意磁盘文件或写入库存系统。先把这组三个样例跑顺,日后接文件选择器时仍可把原来的解析及验收逻辑保留下来。
0x0E 指向卡住的记录,0x13 才是文件尽头
核验界面报出 0x0E 时,先问它指的是哪一段。头部前四个字节是 49 4E 56 31,即 INV1,随后的 02 00 用小端表示声明条数为二。头部占六字节,每条记录占八,第一条从 0x06 开始,第二条就从 6 + 8,也就是 0x0E 开始。正常文件的两条都能读完,最后的有效字节在 0x15,整个数组长 22。
截断样例只保留前 19 字节,第二条从十进制 14 起剩 5 字节。两字节货号、两字节件数表面上还能读完,重量字段却只剩一个字节。Rust 在读取任何字段之前先检查整条是否够长,所以直接把这个结果作为坏记录报回来。0x0E 是这条记录的起点,0x13 是已收到数据的末端后的第一个位置。文件传输排障可以用后者确定缺口,库存复核人员可以用前者找到是哪行被截断。
第三种情况恰好相反。多余样例是完整的 22 字节再加一个 00,因此从 0x16 起有一个未声明的字节。普通位填充有时是格式定义的一部分,但这个样例格式没有扩展尾部。如果前端显示了两条库存、同时却没有报告剩余字节,说明成功条件只覆盖了读取到所需数据,没检查文件是否符合既定边界。
让表格只接收整份通过的库存
程序把记录先临时放在 Rust。检查规模上限、完整头部、魔数和记录数,再循环检查可用长度。函数使用 saturating_sub 算当前位置之后还剩多少字节,确认足够长才会取切片。单条内容按既定字段取货号、件数及重量,第二条若不够八字节,返回包含 kind、offset、required、available 的错误。前面临时读出的行会随着此次解析结束被释放,前端拿不到一份半成品列表。
use serde::Serialize;
const HEADER_LEN: usize = 6;
const RECORD_LEN: usize = 8;
const MAX_RECORDS: usize = 32;
#[derive(Serialize)]
#[serde(rename_all = "camelCase")]
pub(crate) struct Record {
offset: usize,
item: u16,
quantity: u16,
grams: u32,
}
#[derive(Serialize)]
#[serde(rename_all = "camelCase")]
pub(crate) struct Inventory {
record_count: usize,
records: Vec<Record>,
}
#[derive(Serialize)]
#[serde(rename_all = "camelCase")]
pub(crate) struct ParseError {
kind: &'static str,
offset: usize,
required: usize,
available: usize,
}
fn check_slice<'a>(bytes: &'a [u8], offset: usize, size: usize, kind: &'static str) -> Result<&'a [u8], ParseError> {
let available = bytes.len().saturating_sub(offset);
if available < size {
return Err(ParseError { kind, offset, required: size, available });
}
Ok(&bytes[offset..offset + size])
}
#[tauri::command]
pub(crate) fn inspect_inventory(bytes: Vec<u8>) -> Result<Inventory, ParseError> {
let max_size = HEADER_LEN + RECORD_LEN * MAX_RECORDS;
if bytes.len() > max_size {
return Err(ParseError { kind: "fileTooLarge", offset: 0, required: max_size, available: bytes.len() });
}
let header = check_slice(&bytes, 0, HEADER_LEN, "shortHeader")?;
if &header[0..4] != b"INV1" {
return Err(ParseError { kind: "badMagic", offset: 0, required: 4, available: 4 });
}
let record_count = usize::from(u16::from_le_bytes([header[4], header[5]]));
if record_count > MAX_RECORDS {
return Err(ParseError { kind: "countLimit", offset: 4, required: MAX_RECORDS, available: record_count });
}
let mut records = Vec::with_capacity(record_count);
for index in 0..record_count {
let offset = HEADER_LEN + index * RECORD_LEN;
let row = check_slice(&bytes, offset, RECORD_LEN, "shortRecord")?;
records.push(Record {
offset,
item: u16::from_le_bytes([row[0], row[1]]),
quantity: u16::from_le_bytes([row[2], row[3]]),
grams: u32::from_le_bytes([row[4], row[5], row[6], row[7]]),
});
}
let end = HEADER_LEN + record_count * RECORD_LEN;
if bytes.len() > end {
return Err(ParseError {
kind: "trailingBytes",
offset: end,
required: 0,
available: bytes.len() - end,
});
}
Ok(Inventory { record_count, records })
}
页面每次切换样例时,先清空明细,再画出待核验的原字节。若后端回来的结果属于较早一次点击,就由请求序号放弃。正常结果出现以后,才将完整的库存数据逐行填进去。错误回执拿到的偏移用来高亮对应字节。截断样例高亮仍存在的记录起点,额外字节样例高亮前一条记录之后确实出现的 00。这样的定位和前面的字节计数能相互核对。
import { invoke } from '@tauri-apps/api/core';
import './style.css';
type StockRecord = { offset: number; item: number; quantity: number; grams: number };
type Inventory = { recordCount: number; records: StockRecord[] };
type Issue = { kind: string; offset: number; required: number; available: number };
const complete = [
0x49, 0x4e, 0x56, 0x31, 0x02, 0x00,
0x2c, 0x01, 0x08, 0x00, 0xe2, 0x04, 0x00, 0x00,
0x2d, 0x01, 0x03, 0x00, 0xa8, 0x02, 0x00, 0x00,
];
const samples = [
{ name: 'inventory-ok.bin', bytes: complete },
{ name: 'inventory-short.bin', bytes: complete.slice(0, 19) },
{ name: 'inventory-extra.bin', bytes: [...complete, 0x00] },
];
const app = document.querySelector<HTMLElement>('#app')!;
app.innerHTML = `
<main>
<header>
<p class="domain">入库交接 / INV1</p>
<h1>库存文件核验</h1>
</header>
<div class="workspace">
<aside aria-label="待核验文件">
<h2>样例文件</h2>
<div id="samples"></div>
</aside>
<section aria-labelledby="file-name">
<div class="file-head"><h2 id="file-name"></h2><span id="length"></span></div>
<div class="hex" id="hex" aria-label="文件原始字节"></div>
<div id="diagnosis" role="status"></div>
<div class="table-wrap">
<table><thead><tr><th>偏移</th><th>货号</th><th>件数</th><th>重量(g)</th></tr></thead><tbody id="records"></tbody></table>
</div>
</section>
</div>
</main>`;
const byId = <T extends HTMLElement>(id: string) => document.getElementById(id) as T;
const controls = byId('samples');
const hex = byId('hex');
const diagnosis = byId('diagnosis');
const table = byId<HTMLTableSectionElement>('records');
let request = 0;
function address(value: number): string {
return '0x' + value.toString(16).padStart(2, '0').toUpperCase();
}
function showBytes(bytes: number[], highlight?: number): void {
hex.replaceChildren();
for (let start = 0; start < bytes.length; start += 8) {
const row = document.createElement('div');
const offset = document.createElement('strong');
offset.textContent = address(start);
row.append(offset);
for (const [index, value] of bytes.slice(start, start + 8).entries()) {
const column = document.createElement('span');
column.textContent = value.toString(16).padStart(2, '0').toUpperCase();
if (highlight === start + index) {
column.className = 'target';
}
row.append(column);
}
hex.append(row);
}
}
async function inspect(index: number): Promise<void> {
const current = ++request;
const { name, bytes } = samples[index];
[...controls.querySelectorAll('button')].forEach((button, i) => {
button.setAttribute('aria-pressed', String(i === index));
});
byId('file-name').textContent = name;
byId('length').textContent = bytes.length + ' 字节';
diagnosis.textContent = '正在核验…';
diagnosis.className = '';
table.replaceChildren();
showBytes(bytes);
try {
const result = await invoke<Inventory>('inspect_inventory', { bytes });
if (current !== request) return;
diagnosis.className = 'ok';
diagnosis.textContent = '核验通过 · ' + result.recordCount + ' 条完整记录';
for (const record of result.records) {
const row = table.insertRow();
for (const value of [address(record.offset), record.item, record.quantity, record.grams]) {
row.insertCell().textContent = String(value);
}
}
} catch (error) {
if (current !== request) return;
diagnosis.className = 'error';
const issue = error as Issue;
if (!issue || typeof issue.offset !== 'number') {
diagnosis.textContent = '无法读取原生核验结果';
} else if (issue.kind === 'shortRecord') {
diagnosis.textContent = `记录被截断 · ${address(issue.offset)} 需要 ${issue.required} 字节,实际 ${issue.available} 字节`;
showBytes(bytes, issue.offset);
} else if (issue.kind === 'trailingBytes') {
diagnosis.textContent = `多余数据 · 从 ${address(issue.offset)} 起有 ${issue.available} 字节不属于记录`;
showBytes(bytes, issue.offset);
} else {
diagnosis.textContent = `格式无效 · ${issue.kind},偏移 ${address(issue.offset)}`;
showBytes(bytes, issue.offset);
}
}
}
samples.forEach(({ name, bytes }, index) => {
const button = document.createElement('button');
const subtitle = document.createElement('span');
button.type = 'button';
button.textContent = name;
subtitle.textContent = bytes.length + ' 字节';
button.append(subtitle);
button.addEventListener('click', () => { void inspect(index); });
controls.append(button);
});
void inspect(0);
库存行的数字也值得验。完整样例的两条货号是 300 和 301,件数 8 和 3,重量 1,250 g 和 680 g。例如首行的 2C 01 小端转换后是 300;E2 04 00 00 是 1,250。若字段长度对了,字节序写反仍能得到两条看起来完整的记录。验收在保证记录数与边界之后,还要检查看得懂的业务值。
实际把截断和额外字节放到同一份页面里
我先在 MateBook 14 上打开完整样例,界面显示 22 字节和两条记录。两行分别从 0x06、0x0E 开始,货号、件数和克重均与原始字节一致。然后不关窗口,直接切换到十九字节样例。表格里的两行即刻被撤下,高亮落在十六进制区的 2D,即第二条起点。报错明确显示需要 8 字节、实际 5 字节。


再选多余样例。界面保留全部 23 字节供复核,同时将最后的 00 高亮在 0x16,说明已解析完两条预期记录却还剩一字节。因为严格文件核验仍失败,底下不会出现两行可用库存。回到完整样例后,正常两条才能回来。我随后在窄窗口里再次点十九字节样例,样例选择移到上面,高亮和空表结果仍然一致。


| MateBook 14 本轮操作 | 可核对的结果 |
| 打开完整文件 22 B | 两条明细,偏移 0x06、0x0E |
| 切换到截断文件 19 B | 记录从 0x0E 报错,需要 8 B、实际 5 B,表格为空 |
| 切换到尾部多余的 23 B 文件 | 0x16 多 1 B,表格为空 |
| 回完整文件,再在窄窗点截断 | 完整样例恢复两条,窄窗截断仍清空明细 |
这里的验收顺序会专门经过正常、失败、再正常。假如切到短文件后 UI 只是改了提示却没清旧行,单跑一个失败样例很难发现。正常和失败都在同一窗口里连续跑,才能把前一次的残留与本次 Rust 回执区分开。这也是前端在发起命令前就清掉表格的一项直接效果。
下面保留早期 1.0.0 的真机和模拟器实录。以上真机照片和结果对应这次本机签名安装的 1.0.1。
MateBook 14 真机库存核验实录。切过完整、截断、尾部多余,再返回两条完整记录。平均 4.31 fps,动作段有效帧率 3.54 fps,无音轨。
MateBook Pro 库存核验模拟器实录。切换样例后可对照对应字节标记,平均 3.48 fps,动作段有效帧率 3.29 fps,无音轨。
本轮录屏把成功明细和错误回执放在同一位置对照。正常样例显示两条记录;切到19B截断样例,0x0E字节被标出,提示需要8B、实际5B,表格已经没有成功行。23B样例转而标出0x16的多余字节。最后切回22B,货号300和301才重新出现,能看出界面没有沿用前一次成功结果。

采集上限请求60 fps;这段可变帧率原片平均13.84 fps,GIF保留124帧、9.04秒,平均13.72 fps。静态字节表停留按原始时序保留,没有复制帧或插帧。当前业务库是本机编译的ARM64 release库,封装为调试签名HAP;模拟器虽已启动,不能拿这份ARM64包当作x86_64验证。原有模拟器视频仍只表示早期1.0.0。
从本机源码产物走到测试窗口
先把 TauriInventoryBinary 项目归档解包到 MateBook 14。项目有前端 src、Rust Cargo 工作目录 src-tauri,以及可在 DevEco Studio 中打开的 src-tauri/gen/ohos。检查三个目录时,前端资源应由这里重新生成,Rust 库由这里执行 Cargo,应用模块里最终只留本次需要的 ARM64 动态库。三个位置的应用标识也要对齐,避免前端的 IPC 找不到它期待的宿主。这个项目的命令在 lib.rs 以 inventory::inspect_inventory 注册。
本机前端在 Node.js 24.18.1 下按 package-lock.json 恢复。项目用了适合本机执行的 esbuild-wasm 0.28.2 辅助构建,生成 dist/index.html、app.js 和 app.css。该脚本从实际 src/main.ts 入口打包,把 index.html 的开发入口换成包里的 app.js,并补上样式。运行 node --check 检查输出脚本,再让 Tauri 把 ../dist 收进发布库。这样本机 IDE 可独立启动一份含页面的调试应用。
tar -xzf tauri-inventory-binary-source.tar.gz
cd TauriInventoryBinary
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
Rust 使用 Harmonybrew 的 Rust 和 Cargo 1.99.1。Cargo 与此前已在本机验证的项目所用锁文件版本完全相同,因此复用 MateBook 14 上已有的依赖源码缓存。编译输出使用本项目独立的 CARGO_TARGET_DIR。OHOS_NDK_HOME 仍指向鸿蒙版 DevEco SDK,链接时使用能为本机构建辅助程序签名的 cc。直接运行 cargo build 时立即启用 tauri/custom-protocol,避免库构建成功但窗口仍以开发方式请求页面。这里选择 release 配置编译 Rust 库,随后生成的 HAP 仍按本机调试配置签名,这两个设置服务于不同阶段。
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.ugctauriinventory
export WRY_OHOS_LIBRARY=tauri_ohos_test_lib
export TAURI_OHOS_PACKAGE_UNESCAPED=com.aasd23.ugctauriinventory
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
打开 src-tauri/gen/ohos,项目结构里确认 target 设备为「此电脑」、入口模块为 entry。RustAbility 声明要加载 tauri_ohos_test_lib,包内的 SO 要与 ARM64 目标一致。由 IDE 的签名配置生成本设备可用的调试签名,然后运行一次,确认用的是 entry-default-signed.hap。安装成功后还要查包名 com.aasd23.ugctauriinventory,versionName 1.0.1 和 versionCode 2,这样才知道窗口来自本轮编译,而不是桌面上原本就装过的 1.0.0。
本机 Cargo release 耗时 3 分 13 秒,单独生成的动态库为 7,567,168 字节。随后 Hvigor 首轮完成 34 项任务,用时 12.404 秒,构建未签名 HAP 为 6,727,768 字节。IDE 首次尝试安装未签名包返回 9568320,确认需要本地调试签名。签名后打出的 HAP 为 6,826,340 字节,IDE 安装和启动均返回成功。HAP 外部大小和应用模块的 SO 大小是不同阶段的指标,排查时要查具体包内是否带对版本的库,不能只看两个大小相不相等。
| 项目 | 本轮验收值 |
| 使用的鸿蒙电脑 | 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,Rust / Cargo 1.99.1,Tauri 2.11.2 鸿蒙适配 |
| 工程与签名 | 2in1,兼容 HarmonyOS 6.1.1(API 24),ARM64,1.0.1(2)调试签名 |
| 早期模拟器记录 | MateBook Pro 2in1,管理器配置HarmonyOS6.1.1(API24);实际软件6.1.0.125(SP12DEVC00E47R1P3),API24,x86_64。模拟器已启动;现有视频对应早期1.0.0,本轮1.0.1仅编译ARM64,未记录当前x86构建通过。 |



FAQ
为什么 19 字节明明够看一部分,却不能先报一条通过? 文件头已经声明两条,库存导入的确认单位是整份文件。界面上下文没有获得第二条完整重量,也没有理由当作完整文件。需要紧急救回部分数据时,应把它做成独立的只读结果,并提供二次确认,避免残缺结果进入同一导入队列。
末尾多一个零,为什么也报错? 在这份 INV1 样例里,规定的长度是六字节头部加每条八字节。尾部没有声明扩展或填充。在别的文件格式里可以存在扩展段,增加支持时要通过新规范或版本来区分,不能以附件中出现了零字节就自动忽略。
前端按钮点了,怎么区分解析失败与调用失败? Rust 原生核验错误包含结构化的 offset 等字段,UI 可以高亮到实际位置。若没收到这个结构,页面只提示无法读取原生核验结果,应检查已签名包内的动态库、命令注册名和实际安装版本。用一份预期成功的样例复测有助于区分两个分支。
总结
库存记录的起点和文件的停止位置可以不同。截断样例返回 0x0E,同时保留所需和实际字节数;有附加数据时则从 0x16 报起。把原始字节、错误偏移和完整文件才生成的明细放在同一页,既能解释失败在哪一段,也给接班人留下一份可以逐字核对的复现记录。
更多推荐

所有评论(0)