插件依赖项

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

Add ins - 图片 14

使用页面顶部的按钮来管理条目:

Add(添加):创建一个具有默认值的新依赖项行。点击该行中的每个单元格即可进行配置。

Remove(移除):删除当前选中的行。请先点击某行以选中它。

每个依赖项行包含五列。以斜体灰色显示的字段表示未设置或可选的值。

范围:软件包 vs 资源

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(晚于)(参阅日期和时间值)。