自定义管理

自定义管理提供自定义小部件和自定义通信协议的功能，允许用户根据需求创建和配置特定的小部件，并定义与硬件设备交互的通信协议，从而实现应用程序的个性化开发和集成

自定义小部件

允许用户根据自己的需求创建和配置特定的小部件，以实现应用程序的个性化开发和定制。

创建自定义小部件

（1）点击左侧列表的【自定义小部件】，再点击右上角的【创建小部件】按钮，进行创建

image-20250507202507970

（2）下载模板文件，点击【下载模板文件】按钮，在模板工程中编写自定义小部件的代码

image-20250510161503678

注意：开发前请阅读模板工程下的README.md文档

（3）小部件上传，开发完成后填写对应的自定义小部件表单信息，完成上传

名称说明
小部件名称在低代码平台左侧小部件面板显示的名称
小部件图片在低代码平台左侧小部件面板显示的小部件图片
小部件类型用与区分平台内部的小部件，以custom_开头
小部件类名通过该类名调用小部件
是否需要传入子组件该小部件自身是否允许其它小部件拖入
项目入参调用该小部件需要传递的参数
代码块最终调试完成的代码，即小部件所在位置的文件

（4）信息上传后，等待系统构建成功后即可使用该小部件，构建时间在一分钟左右。

image-20250510162844732

查看自定义小部件

（1）在左侧列表点击【自定义小部件】，右侧会显示已经上传的自定义小部件列表

image-20250510163914915

（2）自定义小部件右上角的状态分为 已构建、构建中、构建失败三种

  • 如果构建失败，点击自定义小部件图标进入到编辑界面，重新填写表单信息并提交即可

使用自定义小部件

（1）点击左侧的【小部件面板】，在【我的小部件】分组中可以看到已经构建好的自定义小部件

image-20250510201152445

（2）拖拽自定义小部件至操作界面，此时右侧的属性编辑器中会展示对应的内容

image-20250510201257253

（3）在右侧的属性编辑器中修改属性（属性信息在自定义小部件上传时录入），实现我们想要的效果

自定义通信协议

在某些环境下，例如山区、农业地区等，网络是受到限制的。

自定义通信协议能够实现与硬件设备的精确集成和高效通信，满足特定业务需求，提高我们的开发效率。

创建自定义通信协议

（1）点击左侧列表的【自定义通信协议】，再点击右上角的【创建通信协议】按钮，进行创建

image-20250510202006686

通信协议主要有以下几种，在下拉框中选择对应的通信协议类型

image-20250510202315348

（2）配置通信协议，在弹出的面板中进行配置

不同的通信协议需要填写的额外信息

类型额外填写信息
HID需要跟硬件工程师沟通以下信息
VID
PID
串口需要跟硬件工程师沟通以下信息
VID
PID
波特率
数据位
校验位
停止位
蓝牙需要跟硬件工程师沟通以下信息
蓝牙名称
蓝牙服务UUID
蓝牙读UUID
蓝牙写UUID
升级状态蓝牙名称

如下是共用的通信协议模板

image-20250510202504452

（3）点击【添加控制字解析】添加，顾名思义根据控制字进行解析，只有当接收数据内容的控制字符合该值时走该控制字解析内容

image-20250510203721681

image-20250510204225098

image-20250510204632639

名称说明
控制字控制字的值，16进制格式
标题该控制字解析的标题，主要用来区分不同的控制字解析
数据模拟模拟设备发送数据的值，16进制格式
开始模拟点击开始模拟，等待一段时间后显示各个变量的值
添加协议解析点击【添加协议解析】添加，输入 局部变量名称和表达式 跟协议内的数据关联起来
数据计算器主要用来定义表达式，协议变量就是我们定义的变量，其中有三个内置的变量
_protocolArr_16 硬件设备发送的数据，16进制格式数组
_protocolArr_10 硬件设备发送的数据，10进制格式数组
_protocolArr_8 硬件设备发送的数据，8进制格式数组

使用自定义通信协议

（1）创建项目并打开，在左侧的【小部件面板】中选择【按钮】拖入到上下布局中

image-20250510205422583

（2）在操作流程编辑器中添加事件和动作节点，动作类型 -- 【硬件动作】，硬件类型 -- 【串口】，操作类型 -- 【接收数据】

image-20250510205717289

（3）在协议配置中选中已添加的协议，如果没有，在此界面也可以添加通信协议

上次更新: