插件依赖项页面允许您定义在安装插件(或其中特定文件)之前必须满足的条件。如果某项检查失败,受影响的范围(整个软件包或单个文件)将在安装过程中被跳过。

使用页面顶部的按钮来管理条目:
Add(添加):创建一个具有默认值的新依赖项行。点击该行中的每个单元格即可进行配置。
Remove(移除):删除当前选中的行。请先点击某行以选中它。
每个依赖项行包含五列。以斜体灰色显示的字段表示未设置或可选的值。
Package(软件包):如果检查失败,整个插件将不会被安装。当插件在该条件未满足时完全无法运行时,请使用此选项。
Asset(资源):如果检查失败,仅跳过“标识符/文件名”列中指定的那一个文件,插件的其余部分将正常安装。
对于范围为 Asset(资源)的依赖项,Name(名称)列具有特殊作用:它定义了一个依赖项分组。多行使用相同的名称时,会针对同一个资源文件依次进行评估。
当某个文件需要在不同条件下安装时,这非常有用——例如,为 Windows 提供一个版本的文件,为 Linux 提供另一个版本。整个分组作为一个整体进行评估;只要分组中有一行检查通过,该资源就会被包含在内。
如何输入 Value(值)取决于依赖项的类型:
Version Check(版本检查):使用数学区间表示法(参阅版本范围)。
File Created / File Modified(文件创建/文件修改):从三种日期/时间模式中选择(参阅日期和时间值)。
其他所有类型: Value(值)字段在编辑时会提供一个下拉菜单,包含两个选项:
Exact value(精确值):如果系统值与您输入的内容匹配,则检查通过(比较不区分大小写)。
Regular expression(正则表达式):如果系统值匹配您提供的模式,则检查通过。
版本值使用标准的数学区间表示法:
方括号 [ 或 ] 表示边界版本包含在范围内。
圆括号 ( 或 ) 表示边界版本不包含在范围内。
省略上限或下限表示该方向没有限制。
文件的日期/时间检查不使用区间表示法。
而是需要从以下三种模式中选择其一:
Exact(精确):文件的时间戳必须与指定的日期/时间完全匹配。
Before(早于):文件的时间戳必须早于指定的日期/时间。
After(晚于):文件的时间戳必须晚于指定的日期/时间。
类型 | 描述 |
None(无) | 不执行任何检查——该依赖项始终视为已满足。可用作占位符。 |
Version Check(版本检查) | 检查所选软件组件的版本是否落在指定范围内。 标识符:选择要检查的软件:RoboDK、Add-in Manager、Qt Framework 或操作系统。 值:使用区间表示法的版本范围(参阅版本范围)。 |
CPU Architecture(CPU 架构) | 检查系统处理器架构是否与预期值匹配。 值:预期的 CPU 架构字符串,例如 x86_64、arm64 或 i386。支持精确匹配或正则表达式。 |
Build Architecture(构建架构) | 检查正在运行的构建版本的完整应用程序二进制接口(ABI)字符串。这比 CPU 架构更详细,包含编译器、数据模型和字节序信息。 值:例如 x86_64-little_endian-lp64。支持精确匹配或正则表达式。 |
Kernel Type(内核类型) | 检查底层操作系统内核标识符。 值:例如 winnt(Windows)、linux、darwin(macOS)。支持精确匹配或正则表达式。 |
System Check(系统检查) | 检查操作系统自身报告的产品名称。 值:例如 windows、ubuntu。支持精确匹配或正则表达式。 |
File Version(文件版本,仅限 Windows) | 读取嵌入在 Windows 可执行文件或库(.exe 或 .dll)中的版本资源,并使用值或表达式进行比较。 值:例如 1.4.3.3123,支持精确匹配或正则表达式。 |
File Created(文件创建时间) | 检查指定文件的创建时间戳。 标识符/文件名:要检查的文件路径。 值:带模式的日期/时间:Exact(精确)、Before(早于)或 After(晚于)(参阅日期和时间值)。 |
File Modified(文件修改时间) | 检查指定文件的最后修改时间戳。 标识符/文件名:要检查的文件路径。 值:带模式的日期/时间:Exact(精确)、Before(早于)或 After(晚于)(参阅日期和时间值)。 |