总览

概述

  • 功能定位:SiFliGUIBuilderSDK 是思澈为客户提供的移动端表盘编辑SDK,它可以打开SifliGUIBuilder编辑产生的.sif表盘包在手机上预览,该SDK可以列出表盘中的可修改项目,主要是图片控件,实现背景图更换;用户在手机上选择图片,并编辑裁剪成符合表盘原始设计的尺寸进行替换;图片替换后,SiFliGUIBuilderSDK可以生成新的预览效果图,并呈现在客户手机App上;用户可以基于SiFliGUIBuilderSDK将图片修改项制作为资源补丁文件,并通过OTA V3 SDK推送到固件端,请参照 OTA V3 SDK

  • 平台支持:目前支持Android,iOS

  • 文档结构:包含iOS、Android、错误码体系三部分

实现流程

1. 表盘编辑设置

表盘的背景要支持手机端编辑,需要在GUIBuilder编辑期间,选中Image 控件的属性 用于页面背景 允许手机端编辑

  • 用于页面背景: 表示这张图是该表盘的背景图,一个样式/页面只能设置一个Image控件选中

  • 允许手机端编辑:勾选后,手机端的GuiBuilderSDK 才可以允许手机用户编辑并修改这个图片控件

2. 发布表盘包

SiFliGUIBuilder 2.5.19 以后的版本,发布后在publish目录会产生一个{APP_ID}.sif的表盘包文件。将它上传到服务器,并通过手机下载后,则可通过SiFliGUIBuilderSDK进行编辑。

3. 手机端编辑

客户可以在手机端根据产品设计开发自己的编辑UI,下图是一个demo,展示了SiFliGUIBuilderSDK 的编辑功能。 它可以在手机端预览表盘的设计效果,当用户编辑了允许编辑的图片组件时,预览图也会同步更新。上图中,下方的可编辑列表正是来自表盘编辑设置的选中项

  • Edit:选择图片,裁剪编辑,并替换表盘的原始图片

  • Send:将编辑效果制作为资源补丁,并发送给设备

  • Del:删除手机本地的修改。

了解更多细节,请阅读android,ios端的SiFliGUIBuilderSDK文档