跳到主要内容

Rokae+ 相关 Skill

Rokae+ 提供三份 Skill,供 AI Agent 协助完成插件工程的初始化、编译和打包。三份 Skill 相互独立,每份只完成自己范围内的工作。

Skill(目录名)作用
preparing-client-plugin创建最简客户端插件工程;将已有页面挂载到示教器
compiling-rokae-plugin按目标平台编译客户端插件或控制器插件
packaging-rokae-plugin把已编译的插件打成可导入的插件包

使用前准备​

  1. 安装 Skill:三份 Skill 位于 客户端插件二次开发包 的 .skills 目录下。
  2. 准备开发包:创建或编译插件前,请按插件类型下载对应的二次开发包:客户端开发包、控制器开发包。

缺少插件名、开发包或编译环境时,AI Agent 会先问清,再写入工程或开始编译、打包。

客户端插件最简工程初始化与界面挂载 Skill​

目录名: preparing-client-plugin

用于创建最简客户端插件工程,或将已有页面挂载到示教器。

需要提供得到
插件名、开发包最简工程(.pro 工程配置文件与 src/ 源代码目录)
需要挂载的页面类、示教器上的目标位置在 init() 中调用相应挂载函数进行挂载

支持的挂载位置

位置函数
工艺包页面、中心页CreateCenterWidget
底部状态栏CreateStatusBar
右侧扩展窗CreateRightExpandWidgte
物理按键、示教器侧键CreatePhyButtonList

范围: 本 Skill 不编译、不打包、不编写具体业务逻辑。

界面挂载函数及示例见 UI 接口。

客户端和控制器插件一键编译 Skill​

目录名: compiling-rokae-plugin

用于按目标平台编译已有的客户端或控制器插件工程。

需要提供得到
已有插件工程、目标平台及对应的编译环境编译好的插件库及其绝对路径

支持的平台与产物

插件系统架构产物
客户端插件Windowsx86_64.dll
客户端插件Linux(示教器)aarch64.so
控制器插件Linuxx86_64.so
控制器插件Linuxaarch64.so

客户端插件需要 Qt 5.12 及以上的 5.x 版本及其 qmake,控制器插件不需要 Qt。编译 aarch64 版本时,通常在 Linux x86_64 上使用交叉编译工具链,环境准备见 交叉编译说明。

范围: 本 Skill 不制作插件包,也不新建客户端插件工程。

客户端和控制器插件一键打包 Skill​

目录名: packaging-rokae-plugin

用于将已编译的客户端插件、控制器插件,或两者一起,打成可导入的插件包。

需要提供得到
已编译的插件库、打包所需的配置和资源可导入的插件包及其绝对路径

插件包组成

HMI 导入的是插件包,其中可包含以下数据包:

数据包内容
client.zip客户端插件
controller.zip控制器插件

两个数据包可以都有,也可以只有其中一个。客户端插件与控制器插件没有强制依赖。

范围: 本 Skill 不编译,也不新建客户端插件工程。

目录结构、配置文件和授权字段见 插件包制作。