Ionic 接入鸿蒙应用 Skill:两件耗材同名时,先确认库位再查询
前言
「标签纸还有几卷?」查询返回 A-12 和 B-07 两个库位,数量留空。选了 B-07,回单才出现 3 卷。这两步在 MatePad Edge 的 Ionic 页面上都能看到。在小艺接入里,第一步返回的也是候选库位,第二步才携带用户确认的位置。脚本与页面共用查询规则,系统对话的实际调起需要另外验证。
我准备了三条测试记录,专门验证「问得少、答得准」。名称唯一时直接回库位和数量。出现同名项时只返回候选库位,等用户提供库位再查。取消以后,页面回到可重新查询的状态。Ionic 页面的可视化入口和应用 Skill 使用同一份 ArkTS 查询代码,所以核对页面结果时能直接对应到脚本处理的状态。
问一次,选一次
第一次查询,标签纸。 结果回单只写「查到两处,请先选库位」。这时首页没有 8 卷、3 卷或 11 卷。A-12 和 B-07 是两个待确认的选项。

MatePad Edge 全屏:标签纸同名,返回两个库位 · 查看原件
第二次查询,B-07 的标签纸。 页面送回名称和已选库位,回单这次才填写数量。它显示 3 卷。

MatePad Edge 全屏:确认 B-07 后返回 3 卷 · 查看原件
同一个问题,也可以取消。 重开同名查询再点取消,候选项收起,数量栏也收起。下一次问热敏纸,仍然直接显示 C-03 和 12 卷。

MatePad Edge 全屏:取消后清空这次结果 · 查看原件

MatePad Edge 全屏:从同名选择到取消的操作 · 查看原件
真机演示:在应用内查询同名耗材
MatePad Edge 真机演示 · 查看原件
热敏纸只有 C-03 一条记录,直接得到 12 卷。把这两种输入放在一起看,正好能检查实现有没有简单地写成「先选库位再查」。追问有成本,唯一命中的时候还加一轮选择,会让最常见的操作变得更慢。

MatePad Edge 全屏:热敏纸唯一命中,直接返回 12 卷 · 查看原件
| 环境 | 版本 | 本轮检查 |
|---|---|---|
| MatePad Edge(QXS-W00) | HarmonyOS 7.0.0.111 (SP16C00E111R6P5),API 26 | Ionic 页面调用鸿蒙端规则,检查直接命中、同名选择和取消 |
| DevEco Emulator 26.0.0.402,MatePad Pro 13 镜像(PADEMU-FD00) | HarmonyOS 7.0.0.107 (SP8DEVC00E16R1P1),API 26 | 显示 Ionic 查询页,热敏纸回读到 12 卷 |
| 构建 | API 26 SDK 26.0.0.105;Ionic Core 8.8.19;鸿蒙 Capacitor 1.0.0 | 安装包含应用 Skill 声明与 ArkTS 脚本 |
| 小艺系统入口 | 以开发者文档中的真机测试步骤为准 | 此处的真机截图覆盖应用内预览路径 |

MatePad Edge 关于本机 · 查看原件

API 26 模拟器关于本机 · 查看原件

DevEco Studio 关于 · 查看原件

API 26 模拟器全屏:查询热敏纸并回读数量 · 查看原件
同名时先交出库位

VS Code 工程:同名时返回可选库位 · 查看原件
这份查询只有两个业务参数。第一个是物料名,第二个是已确认的库位。未确认时传空字符串,返回的候选项用真实库位编码。页面选择时传回 B-07,不传「第二个」或者当前列表下标。这是因为下一次查询时库存数组的排序可能变化,同一个下标未必还指向同一个库位。
这类查询有一点和一张传统搜索列表不同。第一次命中多项时,关心的是状态“待确认”,数量应当暂时隐藏。脚本的返回值因此分为 found、choose、cancelled 和 missing。后续接入真实库存时仍然可以使用这些状态,并在第二次请求重新读取库位,处理首轮与第二轮之间数据变化。测试版只读取随应用安装的固定样本,所有返回值都可以从三条样本中复算,也不会改动库存。
export interface StockAnswer {
state: string;
name: string;
location: string;
quantity: number;
choices: string[];
}
interface Supply {
name: string;
location: string;
quantity: number;
}
const supplies: Supply[] = [
{ name: '标签纸', location: 'A-12', quantity: 8 },
{ name: '标签纸', location: 'B-07', quantity: 3 },
{ name: '热敏纸', location: 'C-03', quantity: 12 }
];
export function lookupStock(name: string, location: string): StockAnswer {
const place = location.trim().toUpperCase();
const result: StockAnswer = {
state: 'missing', name: name.trim(), location: '', quantity: 0, choices: []
};
if (place === '取消') {
result.state = 'cancelled';
return result;
}
const matched = supplies.filter((item: Supply) =>
item.name === result.name && (!place || item.location === place));
if (matched.length > 1) {
result.state = 'choose';
result.choices = matched.map((item: Supply) => item.location);
} else if (matched.length === 1) {
result.state = 'found';
result.location = matched[0].location;
result.quantity = matched[0].quantity;
}
return result;
}
从页面按钮到 Skill 脚本
后续为工程原包名 com.aasd23.stockskill 重新打包,确认 HAP 内包含库位查询的 Skill 声明、关联的 EntryAbility 和 StockSkill 脚本入口。API 26 平板模拟器安装新版后,在应用里查到热敏纸 12 卷,查标签纸返回 A-12 和 B-07,选 B-07 返回 3 卷,再次查询并取消后显示「查询已取消」。小艺入口还需要在开放平台导入这个包,发布至真机测试组,再用组内账号在小艺对话里发起请求。导入 Skill · Skill 真机测试
同一份签名包在 MatePad Edge 上也通过了应用内测试。热敏纸返回 12 卷。标签纸先列出 A-12 和 B-07,选 B-07 后返回 3 卷。再次查询后取消,页面显示「查询已取消」。
应用内接法很直接。Capacitor 的 lookup 方法取出页面传入的 name、place,交给 lookupStock。这个桥主要负责校验是否能从 WebView 进到鸿蒙宿主,以及 ArkTS 对象能否正确回到 Ionic。对话入口的接法多了一层生命周期。模块登记 skillProfiles,由技能目录下的 SKILL.md 说明调用参数和返回值约定。ArkTS 脚本在收到上下文与 requestCode 后,通过 completeArkTSScriptInApp 回传结果。复用规则时不要把页面组件放进脚本,应用页面是否打开不应成为查询的输入。
import { scriptManager } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { lookupStock, StockAnswer } from '../../../src/main/ets/entryability/StockRules';
export default class StockSkill {
public async lookup(info: scriptManager.ArkTSScriptInfo, ...args: string[]): Promise<void> {
const answer: StockAnswer = lookupStock(args[0] ?? '', args[1] ?? '');
const data: Record<string, Object> = {
state: answer.state, name: answer.name, location: answer.location,
quantity: answer.quantity, choices: answer.choices
};
const response: Record<string, Object> = {
type: 'result', status: answer.state === 'missing' ? 'failed' : 'success', data: data
};
hilog.info(0, 'StockSkill', 'result=%{public}s', answer.state);
await scriptManager.completeArkTSScriptInApp(info.context, info.requestCode,
{ code: answer.state === 'missing' ? -1 : 0, result: response });
}
}
实现时有意让 choose 仍然是一次成功的响应。只要脚本正确识别了同名项,并给出了候选库位,系统调用就已经正常结束。下一轮是否还会执行取决于系统如何处理候选项和用户响应。缺失记录则以 missing 返回,取消也可以在对话层直接结束,页面示例用显式调用来验证它能收起候选和结果。若要测试小艺对话链路,请从系统侧发起指令,并结合脚本返回日志核对两次调用。应用内的按钮能够覆盖业务规则,却无法替代系统调起和多轮对话的验证。
参见应用 Skill 的 ArkTS 脚本开发和真机测试技能。
FAQ
候选项为什么暂时不显示库存? 界面引导用户选库位。把每处数量提前放在候选里,用户和程序就容易拿未确认的数字当正式结果。需要显示总量时,应另做「汇总库存」入口,让提示与统计范围一致。
把 a-12 输成小写怎么办? 查库位时会先去掉首尾空白,再转换为大写。物料名只去首尾空白,示例没有定义同义词。真实系统如果接受简称,应该先有一张明确的别名字典。
怎么确认系统真的执行了脚本? 在申请并完成系统侧调试后,从小艺发起唯一命中和同名两组请求,观察应用日志中的 StockSkill 与状态回执。安装包里存在 SKILL.md、在应用内查到了数量,都只能证明各自覆盖的那一段。
总结
同名耗材的处理由一次追问解决。先给库位、再回一个数量,让测试和现场沟通都能核对到同一条记录。MatePad Edge 上已验证三条业务分支。把演示接入小艺时,继续用这三组输入复查系统触发、库位追问和取消行为,即可定位哪一层需要补齐。
工程代码
Ionic 页面与查询回执
entry/src/main/resources/rawfile/www/stock.js
'use strict';
const get = id => document.getElementById(id);
let current = '';
let pending = false;
async function lookup(name, place = '') {
if (pending) return;
pending = true;
try {
const result = await window.Capacitor.Plugins.StockRoom.lookup({name,place});
current = name;
get('choices').replaceChildren();
get('answer').hidden = result.state !== 'found';
if (result.state === 'choose') {
get('message').textContent = '查到两处,请先选库位。';
for (const value of [...result.choices,'取消']) {
const option = document.createElement('button');
option.textContent = value;
option.addEventListener('click', () => lookup(current,value));
get('choices').append(option);
}
} else if (result.state === 'found') {
get('message').textContent = result.name;
get('place').textContent = result.location;
get('quantity').textContent = result.quantity + ' 卷';
} else {
get('message').textContent = result.state === 'cancelled' ? '查询已取消' : '这个库位没有该耗材';
}
} catch (error) {
get('message').textContent = error.message || '查询失败';
} finally { pending = false; }
}
document.addEventListener('DOMContentLoaded', () => {
for (const button of document.querySelectorAll('[data-name]')) button.addEventListener('click', () => lookup(button.dataset.name));
});
Capacitor 插件
entry/src/main/ets/entryability/ScanBridge.ets
import { CapacitorPlugin, PluginCall } from 'harmony-capacitor';
import { lookupStock, StockAnswer } from './StockRules';
export class StockBridge extends CapacitorPlugin {
constructor() {
super();
this.registerMethod('lookup', (call: PluginCall) => {
const answer: StockAnswer = lookupStock(call.getString('name'), call.getString('place'));
call.resolve(answer);
});
}
}
鸿蒙应用 Skill 声明
entry/src/main/module.json5
{
"module": {
"name": "entry",
"type": "entry",
"description": "$string:module_desc",
"mainElement": "EntryAbility",
"deviceTypes": [
"phone",
"tablet",
"2in1"
],
"deliveryWithInstall": true,
"installationFree": false,
"skillProfiles": [{
"name": "aasd-stockroom-lookup", "abilityName": "EntryAbility", "version": "1.0.0",
"srcEntries": ["../../skills/aasd-stockroom-lookup/scripts/StockSkill.ets"]
}],
"pages": "$profile:main_pages",
"abilities": [
{
"name": "EntryAbility",
"srcEntry": "./ets/entryability/EntryAbility.ets",
"description": "$string:EntryAbility_desc",
"icon": "$media:layered_image",
"label": "$string:EntryAbility_label",
"startWindowIcon": "$media:startIcon",
"startWindowBackground": "$color:start_window_background",
"exported": true,
"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"action.system.home"
]
}
]
}
],
"extensionAbilities": [
{
"name": "EntryBackupAbility",
"srcEntry": "./ets/entrybackupability/EntryBackupAbility.ets",
"type": "backup",
"exported": false,
"metadata": [
{
"name": "ohos.extension.backup",
"resource": "$profile:backup_config"
}
],
}
]
}
}
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐

所有评论(0)