通过插件创建工具,您可以轻松创建和修改 RoboDK 的插件包。插件创建工具是插件管理器的一部分。
选择 "工具-插件管理器",然后单击插件管理器底部的 "创建插件 "按钮,即可打开插件创建器。
打开插件创建向导后,您可以选择以下选项:
● 从头开始创建新插件:这将产生一个新的 RoboDK 包(RDKP 文件)。
● 从文件夹或传统应用程序中创建新插件:在这种情况下,您可以指定插件文件所在文件夹的路径。不创建包选项允许您直接在插件所在文件夹中编辑插件,而无需创建 RoboDK 包(RDKP 文件)。
● 修改现有插件:打开现有 RoboDK 包,修改并创建新版本。
只需输入类型、名称、作者信息等基本信息,即可轻松创建新插件。
在 "插件创建器 "窗口中,您会发现必填字段以粗体显示。一共有五个:
1.类型:插件类型,如应用程序、机器人驱动器、语言等。
2.名称:插件名称。
3.唯一标识符:属于此特定插件的唯一标识符。该字段旁的复选框允许您激活编辑模式并设置任意标识符,标识符可包含拉丁字母、数字和其他字符,如减号、点、下划线。
注意:我们建议使用以domain.company.type.name
格式书写的唯一标识符。虽然也可以使用其他形式的标识符,但我们建议使用建议的格式。
4.版本:版本应采用语义版本格式(major.minor.patch
)。
5.修订:插件的修改次数,取1 及以上的数值。
其余字段为可选字段,但允许您对插件进行更精确的描述:
6.作者:作者:作者的姓和名,或贵公司或团队的名称(如果有多个作者)。
7.公司:公司名称。
8.语言:插件使用的语言。列出了IETF BCP 47 标准中的所有语言。
9.内容状态:插件状态,如最终版、内部测试版、测试版等。
10. 描述:插件简介。
11. 修改者:当有人修改了另一位作者的插件,并希望作为修改作者被提及时,可以使用此字段。
12. 创建:插件第一个版本的创建日期(自动填写)。
13. 已修改:插件修改日期(自动填写)。
14. 电子邮件:用于销售、支持或反馈的电子邮件地址。
15. 网站:贵公司(插件开发商)的网站。
16. 文档链接:指向插件文档的链接。
17. 版本库链接:对于开源插件,指向插件所在的 GitHub 代码库或其他公共代码库的链接。
18. 关键字:关键字(标签)列表,用于简化在插件市场中搜索插件的过程。
插件应包含一个或多个资产。资产可以是定义插件操作的脚本和图标。
插件资产 "页面分为三个功能区:
1.包装图标选择区。
2.文件树区域。
3.文件内容预览区
本页按钮和复选框的用途:
● TargetPath:目标路径按钮会打开当前图标文件的属性窗口,并允许您设置目标属性(请参阅软件包内部的相应章节)。
● 更改图标...按钮允许您用新图标替换当前软件包图标。
● 删除图标 "按钮会删除当前软件包的图标,并设置与正在创建的软件包类型相对应的默认图标。
● 新建文件夹按钮可在选定的文件树分支中创建一个新的子文件夹。
● 添加资产...按钮可将新文件添加到文件树的选定分支中。
● 删除按钮可从文件树中删除所选项目,锁定的项目除外。
● Make Python Package 复选框可将 __init__.py 文件添加到项目中,这样 Python 解释器就能将项目文件作为外部可加载模块使用。
注意:该选项仅在创建应用程序类型的插件时显示。
可以对 Python 脚本进行标记,以便稍后编译成扩展名为 .pyc 的文件。编译过程将显示在向导的下一页。
目标路径 "字段允许你为每个文件设置目标属性。您可以手动输入所需的路径和变量名,也可以在单击目标上的齿轮按钮时调用属性窗口:
文件属性对话框允许您设置目标属性值,并提供可用变量的便捷列表。此外,还可以定义部署文件的目标平台参数(操作系统类型和版本、CPU 型号)。
如果在添加插件资产时选择了至少一个 Python 脚本,则将打开 Python 编译页面。
编译将由所有可用的 Python 解释器执行。可用和已用解释器列表可在插件管理器设置窗口中编辑。编译过程本身不需要用户干预,页面会显示详细的编译日志以发现潜在问题。
重要:通过编译脚本,您可以轻松地混淆应用程序的源代码。但是,如果您担心要适当保护知识产权,就应该探索使用其他编译方法,如 Cython,从 Python 脚本创建 pyd 或可执行文件。您还可以使用自定义可执行文件作为操作。
应用程序配置页面允许您自定义从 RoboDK 用户界面(菜单和工具栏)链接您的操作或脚本的方式。如果您创建的是 App 类型的插件,则会看到 App 配置窗口。
本页中的参数定义了 AppConfig.ini 文件的内容。本页列出了可能的键和值。在 RoboDK 中,每个应用程序都有自己的菜单和工具栏。菜单项和工具栏上的按钮在 App 术语中称为 "操作"。您可以定义显示操作的条件、它们在菜单中的顺序,并为它们分配热键。
基本参数集包括
● 菜单名称:RoboDK 主菜单条目名称。
● 可见:取消选中该复选框,可防止菜单显示在 RoboDK 的主菜单中。
● 父菜单:选择将为其创建App 子菜单的主菜单项,或选择主菜单创建新的主菜单项。
● 优先级:设置优先级,决定本应用程序菜单与其他应用程序菜单的显示顺序(低者优先)。
● 工具栏区域:应用程序工具栏在 RoboDK 主窗口上的位置(侧面)。
● 工具栏比例:工具栏图标与当前 RoboDK 工具栏图标大小的比例。
● 命令:激活插件时将执行的 RoboDK API 命令。
为与 AppConfig.ini 文件位于同一文件夹中的每个 Python 脚本创建一个动作。如果脚本是辅助性质的,则可使用可见属性抑制该操作。
操作属性如下表所示:
● 名称:菜单和工具栏中显示的操作名称。
● 描述:当鼠标指针悬停在菜单项或工具栏按钮上时的工具提示文本。
● 优先级:与本应用程序其他操作相比,该操作的显示顺序(低者优先)。
● 快捷方式
● 可见
● 仅开发者模式:只有当 RoboDK 切换到开发者模式(Ctrl+Alt+Shift+G
)时,才会显示此操作。
● 在菜单中显示
● 在工具栏中显示
● 可检查:创建一个可检查的操作,可检查操作也可按数字分组。
● 上下文菜单筛选器:定义将此操作添加到上下文菜单的 RoboDK 树元素类型。
● 双击过滤器:定义双击时将调用此操作的 RoboDK 树元素类型。
将 RoboDK 包构建为 RDKP 文件,即完成了插件的创建。这是创建插件的最后一步。
在最后阶段,也就是创建软件包之前,可以使用以下选项:
● 加密包:对文件进行加密,使其可以轻松通过电子邮件发送,绕过威胁检测系统(谷歌邮件服务直接禁止在附件中传输可执行文件和 Python 脚本)。
● 构建后安装:让插件管理器安装新创建的软件包。
● 打开包含的文件夹:打开创建软件包的文件夹。