1. 概述
1.1 版本
| 报表服务器版本 | JAR 包 |
|---|---|
| 10.0.13 | 2021-01-25 |
1.2 应用场景
每个插件，在插件管理界面、帆软市场插件界面、对应的插件介绍文档中都会注明 JAR 包要求。如下图所示：
当插件版本和 JAR 包版本不匹配时，会影响插件的使用，严重的话会影响整个工程的运行，所以建议用户在使用插件时，要保证插件版本和 JAR 包版本一致。
用户在安装、更新插件时或更新工程后，可能会出现插件版本和 JAR 包版本不匹配的情况，在此种情况下，若无提醒或限制，工程就会有一个隐藏的风险。2021-01-25 及以后的 JAR 包，在插件版本和工程 JAR 包版本不匹配时会自动禁用插件并进行提醒。如下图所示：
2. 提示和禁用
在「插件管理」处安装、更新、升级，启用插件或更新工程后启动工程时，系统会自动检测插件版本和 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 包版本信息，即不匹配时不会弹窗提醒。
3. 插件更新与删除
当插件与 JAR 包不匹配时需要进行插件的更新或删除，详情如下：
3.1 插件删除
服务器插件删除请参考：服务器插件管理-删除插件
设计器插件删除请参考：设计器插件管理-删除插件
3.2 插件更新
服务器插件更新请参考：服务器插件管理-更新插件
设计器插件更新请参考：设计器插件管理-更新插件