HWS HiPOS 5.0/5.1 资源和配置文件同步

HiPOS logo概述

HiPOS 5.0/5.1 可以在【应用配置】中实现云端统一批量下发文件至HiPOS客户端,是系统运维必不可少的一个工具。

    • 资源文件下发,包括:字体包、音频文件、图片和配置文件等(10M以下)
    • 应用场景有:模版中需更换图片、logo、字体等;叫号或收银机音频文件;新增功能需下发config配置文件等

一、下发Json代码

1、批量下发文件至同一存在路径json代码如下 (非覆盖式,group模式)

注解:

  1. 该代码只支持批量下发文件至指定存在路径(路径不存在也无法下发),下方示例代码路径为“assets/fonts/
  2. 该下发模式为非覆盖模式,即下发文件存在相同名字文件, HIPOS不会下载(优点: 不会重复下载,缺点:文件名相同不会替换该文件)
  3. urls”为链接数组,其中存放着需要下发的文件链接,示例代码中链接为OSS服务器生成,其他可生成下载链接的软件也可
  4. 该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模式)

注解:

  1. 该代码只支持下发单一文件至指定存在路径(路径不存在也无法下发),下方示例代码路径为“ assets/ ”和“config
  2. 该下发模式中“forceNew”控制是否为替换文件(true为替换,false为替换)
  3. “ url ”为链接,其中存放着需要下发的文件链接,示例代码中链接为 OSS服务器 生成,其他可生成下载链接的软件也可
  4. "fullPath"为文件下发路径,路径设置到文件名字,示例:"assets/xdxlogo.png",
  5. 优点:可多次使用,可随意控制下发路径和是否替换,缺点:同一路径下多个文件下发需要调用多次
{
    "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、实际观察式示例

  1. 下发图片验证:观察应用该图片的地方显示是否正确
  2. 下发字体验证:观察小票和杯贴中应用该下发字体的部分是否为该字体样式
  3. 下发音频验证:到使用该音频功能地方验证声音是否正确
  4. 下发配置文件验证:配置文件目前只有两个文件需要下发:config.yaml、uprint.yaml,值得注意的是config.yaml下发格式错误则会导致无法启动,uprint.yaml格式错误会导致所有配置字体无法使用

2、文件对比式示例

  • 下发后,重启POS,在对应目录查看下发是否正确
  • 在HIPOS全渠道中台->HIPOS在线管理,搜素对应下发门店,右方POS目录访问中下载对应下发文件验证是否正常

三、注意事项

网络不稳定时可能会导致下发文件失败,下发Config.yaml 配置文件请注意,该文件下发失败会导致HiPOS 5.0/5.1无法启动。

Is this article helpful?
2 1 1
发表评论
 
附上文件