概述
HiPOS 5.0/5.1 可以在【应用配置】中实现云端统一批量下发文件至HiPOS客户端,是系统运维必不可少的一个工具。
-
- 资源文件下发,包括:字体包、音频文件、图片和配置文件等(10M以下)
- 应用场景有:模版中需更换图片、logo、字体等;叫号或收银机音频文件;新增功能需下发config配置文件等
一、下发Json代码
1、批量下发文件至同一存在路径json代码如下 (非覆盖式,group模式)
注解:
- 该代码只支持批量下发文件至指定存在路径(路径不存在也无法下发),下方示例代码路径为“assets/fonts/”
- 该下发模式为非覆盖模式,即下发文件存在相同名字文件, HIPOS不会下载(优点: 不会重复下载,缺点:文件名相同不会替换该文件)
- “urls”为链接数组,其中存放着需要下发的文件链接,示例代码中链接为OSS服务器生成,其他可生成下载链接的软件也可
- 该group模式只能使用一次
{ "items":[ { "directory":"assets/fonts/", "format":"group", "urls":[ "http://next-file.oss-cn-shanghai.aliyuncs.com/hex/fonts/PuHuiTi/Alibaba-PuHuiTi-Bold.ttf", "https://next-file.oss-cn-shanghai.aliyuncs.com/hex/fonts/PuHuiTi/Alibaba-PuHuiTi-Regular.ttf" ] } ] }
2、批量下发文件至指定存在路径(单一文件多次下发,single模式)
注解:
- 该代码只支持下发单一文件至指定存在路径(路径不存在也无法下发),下方示例代码路径为“ assets/ ”和“config”
- 该下发模式中“forceNew”控制是否为替换文件(true为替换,false为替换)
- “ url ”为链接,其中存放着需要下发的文件链接,示例代码中链接为 OSS服务器 生成,其他可生成下载链接的软件也可
- "fullPath"为文件下发路径,路径设置到文件名字,示例:"assets/xdxlogo.png",
- 优点:可多次使用,可随意控制下发路径和是否替换,缺点:同一路径下多个文件下发需要调用多次
{ "items":[ { "forceNew":true, "format":"single", "fullPath":"assets/xdxlogo.png", "url":"https://next-file.oss-cn-shanghai.aliyuncs.com/hex/image/xdxlogo.png" }, { "forceNew":true, "format":"single", "fullPath":"config/uprint.yaml", "url":"http://next-file.oss-cn-shanghai.aliyuncs.com/hex/config/uprint.yaml" } ] }
3、组合使用
注意事项:
- group模式只能使用一次
{ "items":[ { "directory":"assets/fonts/", "format":"group", "urls":[ "http://next-file.oss-cn-shanghai.aliyuncs.com/hex/fonts/PuHuiTi/Alibaba-PuHuiTi-Bold.ttf", "https://next-file.oss-cn-shanghai.aliyuncs.com/hex/fonts/PuHuiTi/Alibaba-PuHuiTi-Regular.ttf" ] }, { "forceNew":true, "format":"single", "fullPath":"assets/xdxlogo.png", "url":"https://next-file.oss-cn-shanghai.aliyuncs.com/hex/image/xdxlogo.png" }, { "forceNew":true, "format":"single", "fullPath":"config/uprint.yaml", "url":"http://next-file.oss-cn-shanghai.aliyuncs.com/hex/config/uprint.yaml" } ] }
2、配置下发
将正确的Json填入“资源配置”中,并保存
路径:HiPOS全渠道中台->终端管理->应用配置->HIPOS->资源配置
二、下发资源和配置文件验证
验证方式分为两种,一种为实际观察式,一种为文件对比式
1、实际观察式示例
- 下发图片验证:观察应用该图片的地方显示是否正确
- 下发字体验证:观察小票和杯贴中应用该下发字体的部分是否为该字体样式
- 下发音频验证:到使用该音频功能地方验证声音是否正确
- 下发配置文件验证:配置文件目前只有两个文件需要下发:config.yaml、uprint.yaml,值得注意的是config.yaml下发格式错误则会导致无法启动,uprint.yaml格式错误会导致所有配置字体无法使用
2、文件对比式示例
- 下发后,重启POS,在对应目录查看下发是否正确
- 在HIPOS全渠道中台->HIPOS在线管理,搜素对应下发门店,右方POS目录访问中下载对应下发文件验证是否正常
三、注意事项
网络不稳定时可能会导致下发文件失败,下发Config.yaml 配置文件请注意,该文件下发失败会导致HiPOS 5.0/5.1无法启动。
Replies have been locked on this page!