1.1 版本

1.2 应用场景

每个插件，在插件管理界面、帆软市场插件界面、对应的插件介绍文档中都会注明 JAR 包要求。如下图所示：

当插件版本和 JAR 包版本不匹配时，会影响插件的使用，严重的话会影响整个工程的运行，所以建议用户在使用插件时，要保证插件版本和 JAR 包版本一致。

用户在安装、更新插件时或更新工程后，可能会出现插件版本和 JAR 包版本不匹配的情况，在此种情况下，若无提醒或限制，工程就会有一个隐藏的风险。2021-01-25 及以后的 JAR 包，在插件版本和工程 JAR 包版本不匹配时会自动禁用插件并进行提醒。如下图所示：

在「插件管理」处安装、更新、升级，启用插件或更新工程后启动工程时，系统会自动检测插件版本和 JAR 包是否匹配。当版本匹配时，显示正常，否则弹窗提示和禁用插件。

检测点为大版本之间是否匹配，即 9.0、10.0 是否跨版本；当前工程 JAR 包版本是否适应插件说明中要求的最低 JAR 包版本。

2.1 操作插件时

设计器在线或本地安装、更新、启用插件时，插件版本匹配，可正常操作，显示操作成功的提醒。若是因为插件版本不一致导致的安装失败，则会弹窗提示版本不匹配。如下图所示：

• 插件版本高于 JAR 包要求的版本时，提示：***插件版本过高，请升级 JAR 包或安装低版本插件。

• 插件版本低于 JAR 包要求的版本时，提示：***插件版本过低，请安装高版本插件。

出现此情况后，用户需检查安装的插件版本和 JAR 包版本，调整为一致后即不会有出错警告。

2.2 启动工程时

更新工程后，工程启动时，当插件版本和 JAR 包要求的版本不匹配时，工程会禁用插件，管理员登录平台，平台会弹窗显示版本不匹配。如下图所示：

注：集群环境下，多个节点都会进行匹配检测。若基准节点先启动完成，提醒时只使用基准节点的检测结果，只进行一次提醒；若基准节点还未启动完成，已有其他先启动完成，则会进行多次提醒。

• 插件版本高于 JAR 包要求的版本时，平台消息通知：插件 xxx 版本过高，已被系统禁用，请升级 JAR 包或安装低版本插件。

• 插件版本低于 JAR 包要求的版本时，平台消息通知：插件 xxx 版本过低，已被系统禁用，请更新插件。

点击消息内容，即可跳转至「插件管理」页面做相应处理，或在平台「系统消息」处，通知内容后有「处理」跳转链接，点击后可直接跳转至「插件管理」页面，管理员可对控件做相应的处理，使得插件可用。如下图所示：

2.3 使用设计器时

若插件版本和本地设计器 JAR 包版本不匹配，打开设计器时，设计器会弹窗提醒：以下插件与 JAR 包版本不匹配已被禁用

弹窗中详细列举了不匹配的插件，点击「立即处理」即可跳转至「插件管理」页面对插件做相应处理。如下图所示：

设计器切换本地其他目录时，也会检测插件和工程 JAR 包是否匹配，不匹配会弹窗提醒。

注：远程设计时，不检测插件版本和工程 JAR 包版本信息，即不匹配时不会弹窗提醒。