插件「打开方式」新增协议唤起(openMode=app),协议模板与网页模板分离
- 原来「协议唤起」是靠把 URL 模板写成 yuncang:// 来隐式表达的,用户在界面上看不到、
也不好在「唤起软件」和「开网页」之间切。
- 现在「点击后打开方式」有三个值:app(直接唤起本机软件,默认)/ window(独立小窗)/ tab(新标签页)。
- openMode=app 时用新增的 appUrlTemplate(默认 yuncang://open?code={code}),规则级的网页模板不参与;
- openMode=window/tab 时仍用 urlTemplate(默认 http://localhost:7301/local?code={code})。
- 配置版本 3 → 4:v3 曾把协议模板当作 urlTemplate 的默认值,升级时把网页模板还原、
并设置 openMode=app,行为保持不变;用户自定义过的模板不动。
- 兜底不变:4 秒内页面没失焦 → 右下角「在网页中查看」(fallbackUrl)+「下载安装」(downloadUrl)。
验证(options 页跑 PSTRules):
- 默认 { openMode: app, urlTemplate: http://localhost:7301/local?code={code},
appUrlTemplate: yuncang://open?code={code} };
- v3 配置 { version:3, urlTemplate:'yuncang://open?code={code}', openMode:'window' }
升级后 → { openMode: app, urlTemplate: http://localhost:7301/local?code={code} };
- 自定义网页模板 + openMode=tab 保持不变;window 模式仍可正常保存。
- 插件脚本 node --check 全通过。
桌面端 README:更新「和前端 / 插件怎么配合」与「插件直接唤起与兜底」两节,
说明打开方式、两种模板与配置迁移。
This commit is contained in:
parent
c12ea3b197
commit
cae0440fa1
@ -204,8 +204,8 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command"
|
||||
|
||||
## 和前端 / 插件怎么配合
|
||||
|
||||
1. WMS 页面上点运单号旁的按钮 → 插件**直接用 `yuncang://open?code=<运单号>` 唤起本机软件**并定位到该单号
|
||||
(浏览器会先问一次「要打开吗」);也可以把插件的目标模板配成 `http://<站点>/local?code=<运单号>` 先开网页;
|
||||
1. WMS 页面上点运单号旁的按钮 → 插件按「打开方式」处理:默认**直接用 `yuncang://open?code=<运单号>` 唤起本机软件**并定位到该单号
|
||||
(浏览器会先问一次「要打开吗」);把打开方式改成「独立小窗 / 新标签页」则改为打开网页;
|
||||
2. `/local` 页只发一个请求 `GET /api/query/{code}`:
|
||||
- **连不上** → 提示「服务暂不可用 / 本地打印服务未启动,请下载安装后再试」+ 下载按钮;
|
||||
点「已安装,启动本机软件」会走 `yuncang://open?code=...`,然后每秒重试同一个查询接口;
|
||||
@ -226,8 +226,12 @@ reg query "HKCU\Software\Classes\yuncang\shell\open\command"
|
||||
- **在网页中查看** → 打开插件设置里的「唤不起时的兜底页」(默认 `http://localhost:7301/local?code={code}`,
|
||||
该页面里有完整的下载安装引导);
|
||||
- **下载安装** → 打开插件设置里的「软件下载地址」(留空则不显示这个按钮)。
|
||||
3. 插件设置页有三个相关配置:目标地址模板(默认 `yuncang://open?code={code}`)、
|
||||
唤不起时的兜底页、软件下载地址。老配置里如果是旧的 http 默认模板,升级时会自动换成协议模板。
|
||||
3. 插件设置页的相关配置:
|
||||
- **打开方式**:`直接唤起本机软件(协议)`(默认)/ `独立小窗(网页)` / `新标签页(网页)`;
|
||||
- **协议模板**(仅「直接唤起」时生效):默认 `yuncang://open?code={code}`;
|
||||
- **网页地址模板**(仅小窗/标签页时生效):默认 `http://localhost:7301/local?code={code}`;
|
||||
- **唤不起时的兜底页**、**软件下载地址**(留空则不显示「下载安装」按钮)。
|
||||
老配置升级时会自动迁移(v3 把协议写在网页模板里的,会改成「打开方式 = 直接唤起 + 网页模板还原」),行为不变。
|
||||
|
||||
> 兜底只能靠「失焦」猜,不是 100% 准确(软件在后台启动、没抢焦点时会误报一次)。
|
||||
> 想更稳就把目标模板配成 `/local?code={code}`:网页里有真实的查询结果,连不上就是真的没起来。
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user