ArkUI的AtomGit框架仓 · 批次审批导航的完整工程 · 鸿蒙 PC 开发者社区

前言

终审录屏里有一个容易看漏的动作。QC-371 的二十四件物料确认放行以后,窗口回到了写着「已放行」的批次页。从这里再点一次返回,看到的是整张批次清单。刚才的复核明细和确认页已经从返回路径退出。下一位主管查看同一批次,仍能读到复核明细,但不会再收到一份待提交的确认单。

我在鸿蒙 PC 上用 ArkUI 做了一个两条批次的终审台,拿同一个批次分别走取消和放行。两条路径从同一张确认页出发,目的地不同。把走过的路径和页面上显示的批次状态并排核对,就能发现只改状态、只改栈或者只换按钮文案会各留下什么问题。

两条路线在确认页分开

点击之前

点击动作

点击之后应到的位置

页面应显示

批次清单

打开 QC-371

批次

24 件,待审批

QC-371 明细

去确认放行

确认

批次号、件数和影响范围

确认

取消

原复核明细

待确认,仍可重新进入

再次进入确认

确认放行

原批次

已放行

已放行批次

返回批次清单

列表

QC-371 已放行,QC-372 待审批

重新打开 QC-371

查看复核明细

只读的业务明细

已放行,提交入口收起

确认页是本篇唯一可以提交审批的地方。我在页头保留从批次清单到确认的路径,卡片内再次呈现批次号和数量,按钮分成取消和确认放行。Teams 的审批界面也从清单或通知进入详情,由表单反馈操作结果。我借鉴了把请求详情和决定放在一起的排版。这个工程的列表只有两个批次,操作区顺着阅读顺序竖排,窄窗也能先看到批次号再看到按钮。 Microsoft Teams 审批界面

审批前可以把清单上的二十四件同明细里的检验件数核对一遍。页面把申请人、登记数量和复核结论留在各自层级,但在最后的确认页重复展示批次号与数量。终审员如果是从另一个批次返回后打开的这张单,仍能在提交前认出要放行的物料。列表为两条数据保留不同的件数,也方便在录像里判断是否误点。按业务接入时,还可以把日期、工位和当前审批节点一起带到确认页,避免按相似标题做判断。

看完录像,再对路径日志

取消时先从确认页返回 QC-371 的原明细。截图仍有「去确认放行」,文本说明要点确认后才写入结果。此时栈深从三降到二,日志里留下 batch 和 detail。再次进入确认时深度恢复到三,里面只有一条 confirm。这里同时看了用户可见的按钮和栈中的名字,避免把视图暂时隐藏误当作路由已经退出。

随后点实际的放行。本轮 MateBook 14 新包直接回到原批次,日志为 approved_return_to_batch,深度一,只留下 batch。再退回列表,back_to_queue 的深度为零。根列表本来就在 Navigation 容器内,路径数组只数推入的目的页。所以深度零时窗口仍显示批次清单,并没有退出应用。若误把列表也当成一个目的页推入栈,就会平白多出一层返回。

复核时又打开相同批次,缩到窄窗再点明细,仍显示终审已放行,确认入口没有出现。QC-372 保持待审批,说明更新没有误落到另一条记录。本轮还在确认页补发一次系统后退事件,日志是 system_back_confirm,深度从三回到二,状态依然未放行。取消按钮和系统后退各自经过了实际处理,并非只在源码里声明了回退回调。

最后结束应用进程并重新打开,两条批次都回到待审批。这里的放行状态只保存在本次运行的内存,没有接审批服务器或写入持久账本。因此页面所说的写回清单,范围是当前页面状态,不能据此声称真实物料已经获得终审记录。这个重启对照也让复现者知道怎样恢复样例的初始条件。

模拟器本轮已启动,同一次本机构建的1.0.1未签名包也已安装。实际走完取消、重新放行、返回清单和只读重开;下面的旧双端视频仍按原批次区分,上面新增GIF来自MateBook 14。

MateBook 14 真机取消与放行。录像保留第一次取消、重新进入、确认和回清单。整段平均 17.41 fps,业务段按不同解码画面计 17.47 fps,无音轨。

MateBook Pro 模拟器取消与放行。连续全屏截帧,整段平均 2.51 fps,业务段按不同解码画面计 2.29 fps,无音轨。

补录把取消和提交接在同一个批次上看。取消后还在明细里,去确认放行仍可点;第二次确认放行后回到批次。再退回清单、重新打开QC-371,明细写着终审已放行,提交入口已收起。这样既能看见返回的位置,也能确认重开后没有残留一张待确认页。

原片平均60.03 fps;GIF按实际时间戳保留1138帧、18.96秒,平均60.02 fps。没有插帧或额外重复补帧,视频无音轨。审批状态只保留在本进程中,不能把本次重开页面理解为退出应用后的持久化恢复。

在哪一刻把状态和导航接起来

根页面把一个 NavPathStack 交给 Navigation。点击列表中的批次,再进入明细和确认。每一层的进入都有对应深度与业务状态检查。已经通过终审的批次即使仍有明细,其去确认的处理函数也会拦住请求。道路只有一条,按钮重复触发时也要确认路径栈仍在可进入的位置。这里 depth 是单入口结构里的简单约束。如果页面未来允许从待办通知直接跳进明细,最好把校验扩展为检查顶层目标和当前批次标识。

取消可以直接 pop,因为当前测试路径的上一页就是原明细。确认先将当前批次编号写到页面共享的状态,再对路径调用 popToIndex(0)。此处的零指第一条目的页 batch。若只 pop 一次会回到 detail,若连续按两次通用返回,业务代码又会依赖当时的中间页面。明确目标页的做法还能把列表项目的最新状态传到再次进入的明细。 华为 ArkUI 导航跳转

private record(action: string): void {
    this.lastAction = action;
    hilog.info(0x0412, 'ApprovalRoute', 'action=%{public}s case=%{public}s depth=%{public}d paths=%{public}s',
      action, QUEUE[this.current].id, this.paths.size(), this.paths.getAllPathName().join('>'));
  }

  private enter(index: number): void {
    if (this.paths.size() !== 0) {
      return;
    }
    this.current = index;
    this.paths.pushPath({ name: 'batch' });
    this.record('open_batch');
  }

  private inspect(): void {
    if (this.paths.size() !== 1) {
      return;
    }
    this.paths.pushPath({ name: 'detail' });
    this.record('open_detail');
  }

  private openConfirmation(): void {
    if (this.paths.size() !== 2 || this.approvedIds.includes(QUEUE[this.current].id)) {
      return;
    }
    this.paths.pushPath({ name: 'confirm' });
    this.record('open_confirm');
  }

  private goBack(action: string): void {
    this.paths.pop();
    this.record(action);
  }

  private approve(): void {
    const id = QUEUE[this.current].id;
    if (this.paths.size() !== 3 || this.approvedIds.includes(id)) {
      return;
    }
    this.approvedIds = this.approvedIds.concat(id);
    this.paths.popToIndex(0);
    this.record('approved_return_to_batch');
  }

在生产流程中,状态写回可能来自服务端。这里用本地内存模拟成功,适合拆出路线验证,重启会恢复两条测试数据的初始状态。接入真实接口时,点击确认后应保留提交中的状态,收到明确成功再触发回到批次。如果后台响应超时,需要能重新查询这一条审批的最终结果,再决定确认页是否仍可提交。否则一次重复确认可能产生两次业务记录。点击守卫能挡住当前页面的重复进入,最终的审批操作还得由服务端保持幂等。

页面不把用户看的列表行号当成审批记录的主键。当前浏览位置用一个索引从固定清单取批次,真正记为已放行的是批次编号。等以后允许用户在列表里搜索或排序,最好把路由参数也换成编号,并在打开页面时按编号读最新记录。如果原批次在另一端被撤回,就能在进入确认前重新核对是否仍可处理。相反,沿用视图索引时,同一个位置在过滤前后指向的可能是两个批次。

明细和确认页的系统后退处理都使用同一个路径对象,日志带上当时页面名与批次号。本轮确认页的系统后退已与取消按钮分别核对,结果都是保留 batch、detail 两层。后续若接入桌面退出快捷键,还要另测父窗口与根页面的行为;当前结果不能代表所有物理按键映射或窗口关闭操作都等同于业务取消。

在鸿蒙电脑建立这条返回路径

本轮工程目录为 ~/Documents/ugc-native-58/ArkUIApprovalRoute,在 MateBook 14 的 DevEco Studio 打开根目录。业务流程与构建入口都在这份工程内:Index.ets 保存导航栈、当前批次和已放行编号;同目录 Cases.ets 提供 QC-371 与 QC-372 两条合成数据。要改确认以后的目的地,应先找到 approve,再核对页面读取批准状态的方法,不能只把返回按钮换个文字。

本机 IDE 的 AppScope/app.json5 声明当前包名及 1.0.1 版本,entry/src/main/module.json5 的设备类型为 2in1,入口是 EntryAbility。根构建配置使用 HarmonyOS API 24 的兼容与目标,实际设备运行时为 API 26。这两个版本描述不同层面。只有截图中的系统版本,没有工程目标与当前包信息,读者仍然无法判断自己照做时应该选哪套配置。

cd ArkUIApprovalRoute
uname -m
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

在工程根目录的本机终端安装依赖并构建,首次完成 34 项任务,耗时 9.584 秒,得到 91,707 字节未签名 HAP。然后在「项目结构 → 签名配置」为当前包名自动生成匹配目标设备的调试签名,再构建。SignHap 通过后得到 117,607 字节的签名包。业务 ArkTS 和应用资源均在这台鸿蒙电脑编译,未使用其它平台提前构建的业务产物。

安装明确指定 MateBook 14,选择 entry/build/default/outputs/default/entry-default-signed.hap。读回设备包信息为 1.0.1(1000001),再启动 EntryAbility,等待清单上两条批次和打开按钮出现,才开始表中的取消及放行操作。安装成功、应用启动和业务状态更新分别留证,避免把一个能显示图标的包当成全部流程都通过。

复现环境与产物

本轮实际值

鸿蒙电脑

HUAWEI MateBook 14,MNTXM-24B,aarch64

完整系统

HarmonyOS 7.0.0,7.0.0.115(SP11C00E103R12P2patch01),API 26.0.0

本机 IDE 与模型

DevEco Studio 26.0.0.220,ArkTS、ArkUI、Stage

构建目标

HarmonyOS API 24,2in1

应用

com.aasd23.ugcapproval,1.0.1(1000001)

签名重编译

33 项任务,26 执行、7 复用,9.317 秒

历史模拟器

MateBook Pro 2in1;配置HarmonyOS6.1.1(API24),实际软件6.1.0.125(SP12DEVC00E47R1P3),API24,x86_64。同一次本机构建的1.0.1包已安装,取消及放行后的只读重开均通过。

FAQ

从列表再次点开同一批次,为什么还有明细入口? 复核记录之后还要查询。本次实测打开已放行的同一批次,页面维持只读,原有批次号和复核件数都能看到。关闭的是提交入口。若只把整个明细隐藏,后来的主管会找不到这批物料为什么被放行。

返回时深度是零,但窗口为什么没有关闭? 批次清单是 Navigation 的根内容,弹出第一个目的页之后,路径栈为空,根页仍可见。本轮回清单的日志与界面已经对应核对。操作系统在根页上的后退和窗口关闭应另测,不宜由目的页的 pop 推断。

已经取消,为什么能再次打开确认? 取消只是退出本次操作。它使确认页从三层回到两层,不写批准状态。再次进入时栈的名字仍只有 batch、detail、confirm。如果业务还需说明退回给申请人的理由,应新增明确定义的状态与表单。它与离开确认页是不同的业务动作。

总结

这次把两条审批路线分开验。取消保留原明细,终审清掉明细和确认,列表及再次进入的页面都沿用更新后的状态。改审批流程时,可以照着截图和日志把每次按钮对应的目的地列出来,再决定用普通返回还是退到指定的批次层。这样下一次增加退回补正或复核人变更时,也能检查页面是否把用户引回了正确位置。

Logo

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

更多推荐