Rokae+ 相关 Skill
Rokae+ 提供三份 Skill,供 AI Agent 协助完成插件工程的初始化、编译和打包。三份 Skill 相互独立,每份只完成自己范围内的工作。
| Skill(目录名) | 作用 |
|---|---|
preparing-client-plugin | 创建最简客户端插件工程;将已有页面挂载到示教器 |
compiling-rokae-plugin | 按目标平台编译客户端插件或控制器插件 |
packaging-rokae-plugin | 把已编译的插件打成可导入的插件包 |
使用前准备
- 安装 Skill:三份 Skill 位于 客户端插件二次开发包 的
.skills目录下。 - 准备开发包:创建或编译插件前,请按插件类型下载对应的二次开发包:客户端开发包、控制器开发包。
缺少插件名、开发包或编译环境时,AI Agent 会先问清,再写入工程或开始编译、打包。
客户端插件最简工程初始化与界面挂载 Skill
目录名: preparing-client-plugin
用于创建最简客户端插件工程,或将已有页面挂载到示教器。
| 需要提供 | 得到 |
|---|---|
| 插件名、开发包 | 最简工程(.pro 工程配置文件与 src/ 源代码目录) |
| 需要挂载的页面类、示教器上的目标位置 | 在 init() 中调用相应挂载函数进行挂载 |
支持的挂载位置
| 位置 | 函数 |
|---|---|
| 工艺包页面、中心页 | CreateCenterWidget |
| 底部状态栏 | CreateStatusBar |
| 右侧扩展窗 | CreateRightExpandWidgte |
| 物理按键、示教器侧键 | CreatePhyButtonList |
范围: 本 Skill 不编译、不打包、不编写具体业务逻辑。
界面挂载函数及示例见 UI 接口。
客户端和控制器插件一键编译 Skill
目录名: compiling-rokae-plugin
用于按目标平台编译已有的客户端或控制器插件工程。
| 需要提供 | 得到 |
|---|---|
| 已有插件工程、目标平台及对应的编译环境 | 编译好的插件库及其绝对路径 |
支持的平台与产物
| 插件 | 系统 | 架构 | 产物 |
|---|---|---|---|
| 客户端插件 | Windows | x86_64 | .dll |
| 客户端插件 | Linux(示教器) | aarch64 | .so |
| 控制器插件 | Linux | x86_64 | .so |
| 控制器插件 | Linux | aarch64 | .so |
客户端插件需要 Qt 5.12 及以上的 5.x 版本及其 qmake,控制器插件不需要 Qt。编译 aarch64 版本时,通常在 Linux x86_64 上使用交叉编译工具链,环境准备见 交叉编译说明。
范围: 本 Skill 不制作插件包,也不新建客户端插件工程。
客户端和控制器插件一键打包 Skill
目录名: packaging-rokae-plugin
用于将已编译的客户端插件、控制器插件,或两者一起,打成可导入的插件包。
| 需要提供 | 得到 |
|---|---|
| 已编译的插件库、打包所需的配置和资源 | 可导入的插件包及其绝对路径 |
插件包组成
HMI 导入的是插件包,其中可包含以下数据包:
| 数据包 | 内容 |
|---|---|
client.zip | 客户端插件 |
controller.zip | 控制器插件 |
两个数据包可以都有,也可以只有其中一个。客户端插件与控制器插件没有强制依赖。
范围: 本 Skill 不编译,也不新建客户端插件工程。
目录结构、配置文件和授权字段见 插件包制作。