鸿蒙 PC 开发者社区 · AtomGit 鸿蒙 PC 社区 · Tauri 上游鸿蒙适配分支

前言

关班时,门店有两笔补款,纸袋收了 0.10 元,包装收了 0.20 元。平台结算单写着 0.30 元,收银员需要确认这笔账能不能交班。如果软件把二进制浮点产生的尾数当成差额,值班同事就要重新翻凭证。反过来,平台真少一分钱,如果程序一律把小差异归零,那笔缺口在当天报表里就消失了。这两种情况看起来相近,给现场的处理指令却不同。

我把两笔明细做成鸿蒙 PC 的 Tauri 分币对账台。操作者把平台账单填进左边,右边显示明细合计、平台金额和差额。示例按人民币两位小数执行,接受负数以表达退款,使用固定的测试值,不连接真实支付或店铺系统。下面先从两张相差一分钱的票据看结果,再顺着这个结果找到实际执行计算的 Rust 代码。

先把 0.30 和 0.29 交给同一扇窗口

在 MateBook 14 上打开本机编译和签名的 1.0.1。第一次按「开始核对」,纸袋和包装两笔保留原值,合计和账单都显示 0.30,差额是 0.00。接着按「切换差一分样例」,账单字段变成 0.29,右侧旧结果立即清空。待核对期间,操作者还能看见新金额,旧的 0.00 已经不能被拿去抄账。再次提交,明细合计仍是 0.30,右侧明确显示缺一分。

保持明细不变,把平台账单输入成 0.001 再提交。这回右边三栏都留空,提示「对账单:小数应为一到两位」。这一步可以同时核对两件事。第一,输入框没有先把第三位小数抹掉,格式问题能进到 Rust。第二,失败响应没有把上一张结算单的差额留在界面上。同一字段先后得到平账、差额和格式错误,可以分别覆盖命令的两个成功分支和错误返回。复核时可以打开下文的命令注册,同时查页面请求和错误展示。

修改动作

1.0.1 真机显示

用原来的 0.30 提交

明细合计 0.30,账单 0.30,差额 0.00

切换到 0.29,暂不提交

三栏清空,提示等待重新核对

再提交 0.29

明细合计 0.30,账单 0.29,差额 0.01

输入 0.001 提交

对账单小数位报错,三栏留空

把平台账单的原始输入留到 Rust

金额进入前端时已经是字符。直接提交字符串能保留末尾零和小数点后出现的位置。假如表单把字符传给 JavaScript 的 Number,再输出给后端,像第三位小数这类格式约束可能落到数值变换之后,页面和后端处理的就可能是另一份输入。这里也没有调用 toFixed 当校验器。把错误值先舍入成一个可入账值,会让值班人员失去回原始凭证核对的机会。

Rust 先去掉两侧空白和可选的前导负号,验证主金额和小数都由 ASCII 数字构成,再把单位统一成分。一位小数乘以十,两位小数直接作为分数。明细在迭代中逐条校验。如果第三条写法不合法,接口用明细行号指出错误,页面不需要从错误金额反推是哪一条。账单字段单独加上「对账单」前缀,交班时看提示就知道该去改哪一侧。

整数的表示范围仍然有限。即使输入都是数字,整数段乘以一百可能溢出,多笔明细相加可能溢出,最后两边相减也可能溢出,因此每一步都检查返回值。格式和范围是两个问题,内容合法才会进入下一步运算。对账接口还限制明细为一到一百条,示例只有两条。业务以后允许跨币种时,得先定义每种币种的最小单位与打印口径,再调整解析和接口。

下面的 Rust 文件包括金额解析、结果格式化和命令定义。入口在 src-tauri/src/lib.rs 以 tauri::generate_handler![reconcile::reconcile] 注册。页面将其中的下划线参数按 Tauri 命令约定写成 statementAmount,并把结果中的字符串原样交给结果栏。数值比较完成后才格式化成两位文本,这样能保留 0.30 最后的零,前端也无需把很大的整数重新解释成 JavaScript 数字。

use serde::Serialize;

#[derive(Serialize)]
#[serde(rename_all = "camelCase")]
pub struct Reconciliation {
    ledger: String,
    statement: String,
    difference: String,
    aligned: bool,
}

fn cents(input: &str) -> Result<i64, &'static str> {
    let input = input.trim();
    let (negative, amount) = match input.strip_prefix('-') {
        Some(value) => (true, value),
        None => (false, input),
    };
    let (whole, fraction) = match amount.split_once('.') {
        Some((whole, fraction)) if (1..=2).contains(&fraction.len()) => (whole, fraction),
        Some(_) => return Err("小数应为一到两位"),
        None => (amount, "0"),
    };
    if whole.is_empty()
        || !whole.bytes().all(|b| b.is_ascii_digit())
        || !fraction.bytes().all(|b| b.is_ascii_digit())
    {
        return Err("请输入十进制金额");
    }
    let whole: i64 = whole.parse().map_err(|_| "金额超出范围")?;
    let scale = if fraction.len() == 2 { 1 } else { 10 };
    let fraction = fraction.parse::<i64>().map_err(|_| "小数格式有误")? * scale;
    let total = whole
        .checked_mul(100)
        .and_then(|major| major.checked_add(fraction))
        .ok_or("金额超出范围")?;
    Ok(if negative { -total } else { total })
}

fn money(value: i64) -> String {
    let amount = value.unsigned_abs();
    let sign = if value < 0 { "-" } else { "" };
    format!("{sign}{}.{:02}", amount / 100, amount % 100)
}

#[tauri::command]
pub fn reconcile(entries: Vec<String>, statement_amount: String) -> Result<Reconciliation, String> {
    if entries.is_empty() || entries.len() > 100 {
        return Err("对账单应有 1 到 100 条明细".into());
    }
    let ledger = entries
        .iter()
        .enumerate()
        .try_fold(0_i64, |total, (index, entry)| {
            let entry = cents(entry).map_err(|error| format!("明细 {}:{error}", index + 1))?;
            total.checked_add(entry).ok_or_else(|| "明细总额超出范围".to_string())
        })?;
    let statement = cents(&statement_amount).map_err(|error| format!("对账单:{error}"))?;
    let difference = ledger.checked_sub(statement).ok_or("差额超出范围")?;
    Ok(Reconciliation {
        ledger: money(ledger),
        statement: money(statement),
        difference: money(difference),
        aligned: difference == 0,
    })
}

前端用同一个 render 更新三栏和状态提示。正常返回读取 Rust 提供的三项金额,重新输入和失败时则使用默认的破折号。样例按钮修改输入之后显式派发 input 事件,使程序切换样例和用户手输金额共享作废旧结果的步骤。用户点击提交时按钮暂时禁用,结束后由 finally 恢复。这个例子服务于手工核对一张单据,后续如果要允许并发导入多单,应为每条返回结果标识请求所属的单据。

type Reconciliation = {
  ledger: string;
  statement: string;
  difference: string;
  aligned: boolean;
};

const form = document.querySelector<HTMLFormElement>('#form')!;
const statement = document.querySelector<HTMLInputElement>('#statement')!;
const button = document.querySelector<HTMLButtonElement>('#compare')!;
const status = document.querySelector<HTMLParagraphElement>('#status')!;
const amounts = Array.from(document.querySelectorAll<HTMLInputElement>('.entry'));
const resultFields = ['ledger', 'reported', 'difference'].map((id) => document.getElementById(id)!);

function render(state: string, message: string, values: string[] = ['—', '—', '—']) {
  resultFields.forEach((field, index) => { field.textContent = values[index]; });
  status.dataset.state = state;
  status.textContent = message;
}

form.addEventListener('submit', async (event) => {
  event.preventDefault();
  button.disabled = true;
  try {
    const result = await invoke<Reconciliation>('reconcile', {
      entries: amounts.map(({ value }) => value),
      statementAmount: statement.value,
    });
    render(result.aligned ? 'aligned' : 'difference',
      result.aligned ? '两边金额一致,差额为零。' : '金额有差异,请核对平台账单。',
      [result.ledger, result.statement, result.difference]);
  } catch (error) {
    render('error', String(error));
  } finally {
    button.disabled = false;
  }
});

form.addEventListener('input', () => render('', '金额已修改,等待重新核对。'));
document.querySelector('#adjust')!.addEventListener('click', () => {
  statement.value = statement.value === '0.29' ? '0.30' : '0.29';
  statement.dispatchEvent(new Event('input', { bubbles: true }));
});

下面保留 1.0.0 的对照实录与 GIF。本轮 1.0.1 的原生重建与业务操作以新截图为证,早期模拟器录制对应其原有安装包。

MateBook Pro 模拟器运行实录。实际分时截帧,无音轨。整段平均 3.05 帧每秒,3 至 12 秒操作段每秒 2.89 个不同解码画面。

先过三道检查,才看得到对账页

这次把工程交给 MateBook 14 本机之后,从前端、Rust 动态库到 HAP 依次由本机生成。源码使用原项目归档,归档带前端和 Cargo 锁文件,不带签名和已编译动态库。打开本机 DevEco Studio 的终端后先解包,从项目根目录执行下面这组操作。第一个 npm 命令恢复项目依赖,第二个为本机添加 esbuild 的 WebAssembly 入口,不改项目锁文件。脚本用现成的 HTML、CSS 和 TypeScript 生成 dist;跑完先检查 app.js 能解析,再去编译 Rust。

tar -xzf tauri-reconcile-cents-source.tar.gz
cd TauriReconcileCents
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

Cargo 启动后,第一处中断在访问依赖仓。指定 CA 文件后 crates.io 可以访问,GitHub 在本机仍有连接超时。我把 Cargo.lock 所指向的 Tauri、Tao、Wry 和 OpenHarmony Ability 提交从已有源码缓存导出,解包到本机的项目专用 CARGO_HOME,再继续拉取注册表依赖。缓存只提供源码。这里用锁文件的目的,是让缓存和读者日后从上游拿到的源码指向相同提交。复现机器能直连 Git 仓库时,用 Cargo 按锁文件取依赖即可。

通过依赖下载后,Cargo 编译出的构建辅助程序又因系统拒绝执行而停住。它是编译期间要在本机运行的程序,和最终要装进应用包的动态库处于两个阶段。这里把 Cargo 和原生依赖的链接器指向 Harmonybrew 中支持本机签名的 cc 和 c++,先实际运行一个由该链接器产出的最小可执行程序,确认本机能启动,再重新执行应用的构建。OHOS_NDK_HOME 和 LIBCLANG_PATH 仍来自 DevEco 的 OpenHarmony Native SDK,用于生成绑定和原生编译。

最后一次中断发生在已经安装之后。DevEco 日志里启动成功,应用也出现了窗口,但窗口正文只有 Failed to request tauri://localhost。直接运行 Cargo 时,release 优化和嵌入本地前端是两件事。这个分支由 tauri/custom-protocol 特性选择发布环境的前端处理,TAURI_ENV_DEBUG=false 本身不会启用这个特性。用以下配置和命令在本机重新编译,再让 HAP 重新收集 ARM64 的动态库,窗口才进入对账界面。

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.ugctauricents
export WRY_OHOS_LIBRARY=tauri_ohos_test_lib
export TAURI_OHOS_PACKAGE_UNESCAPED=com.aasd23.ugctauricents
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

在 DevEco Studio 中打开 src-tauri/gen/ohos,把目标选为「此电脑」。第一次直接运行时未签名包被拒绝,提示 9568320 和 no signature file。从输出里的 Open signing configs 打开工程签名配置,使用已登录账号为这个包名生成调试签名。生成后由本机重新执行 Hvigor 打包。成功的构建日志列出 entry-default-signed.hap,文件为 6,814,021 字节。再次运行,IDE 本机调用安装和 EntryAbility 启动。安装后检查包名 com.aasd23.ugctauricents、versionName 1.0.1 和 versionCode 2,再去执行前文三张测试单。源码归档只保留代码和工程约定,开发者要为自己的设备重新生成调试签名。

环境

核对到的设备和工具

本轮开发、打包和测试

HUAWEI MateBook 14(MNTXM-24B),HarmonyOS 7.0.0 软件版本 7.0.0.115(SP11C00E103R12P2patch01),API 26.0.0,aarch64

本机工具

DevEco Studio Beta 与原生 SDK,Rust / Cargo 1.99.1,Node.js 24.18.1,npm 11.16.0,Tauri 2.11.2 鸿蒙适配分支

兼容目标和入口

HarmonyOS 6.1.1(API 24),2in1;RustAbility 加载 tauri_ohos_test_lib

本轮签名包

1.0.1(2),ARM64,DevEco 自动调试签名

早期模拟器证据

MateBook Pro 2in1,设备管理器配置 HarmonyOS 6.1.1(API 24),运行镜像 OpenHarmony-6.1.1.125,x86_64;录制使用 1.0.0,本轮设备离线

键盘旁边还有一扇窄窗

值班同事可能把对账程序放在一侧,另一侧打开平台结算表。宽窗里左边是输入,右边是结果;缩窄后界面把两块内容上下排。我在窄窗里实际再次切到 0.29 并提交,差额仍为 0.01。页面变窄影响的是 CSS 排列,原始输入、事件和 Rust 对账命令继续使用原来的处理顺序。在示例界面里,状态信息与三个金额一直处在同一个结果区域,滚动到那里时仍能读到完整一组输出。

FAQ

同样是发布编译,为什么还有白窗? 先确认应用能安装且有窗口,再记录窗口里报出的 URL。对本分支,直接跑 Cargo 时需要明确启用 tauri/custom-protocol,并确认构建前 dist 已在指定目录。重建时要把新动态库放回 entry/libs/arm64-v8a,再让 DevEco 重新打包和安装。只重开窗口仍然加载上一次安装的库。

账单填 0.300 会不会自动成为 0.30? 这两个文本在金额数学值上相等,但示例数据契约只收一位或两位小数。额外小数位会抛出格式错误,和本次用 0.001 得到的错误相同。如果来源允许多位小数,业务需要先定舍入规则,改动后以来源数据做独立验收。

同一个包能拿去验证早期模拟器吗? 本轮只在鸿蒙电脑本机生成 ARM64 库。早期模拟器是 x86_64,需要另行构建对应 ABI 并复测。安装包就算含有合适的 ABI,也还要实际点击三种样本,核对成功响应和失败分支后再登记实测结果。

总结

现在用 MateBook 14 可以把同一份项目从源码编译、打包和签名一路跑到现场用得上的三次核对。平账时保留 0.00,确实少一分就显示 0.01,格式错误把旧结果撤下并指出要核对的输入。把这三张样本放进日常回归,既能检查金额口径,也能发现 Tauri 页面与 Rust 命令之间的接线有没有在新包中丢掉。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐