插件与JAR包不匹配问题

  • 文档创建者:RosieY
  • 编辑次数:3次
  • 最近更新:RosieY 于 2021-01-26
  • 1. 概述

    1.1 版本

    报表服务器版本JAR 包
    10.0.132021-01-25

    1.2 应用场景

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

    image.png

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

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

    企业微信截图_b22965d4-2967-46cb-8940-754ffad423c5.png

    2. 提示和禁用

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

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

    2.1 操作插件时

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

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

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

    image.png

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

    2.2 启动工程时

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

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

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

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

    image.png

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

    image.png

    2.3 使用设计器时

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

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

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

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

    企业微信截图_b22965d4-2967-46cb-8940-754ffad423c5.png

    附件列表


    主题: 设计器简介
    • 有帮助
    • 没帮助
    • 只是浏览
    • 评价文档,奖励 1 ~ 100 随机 F 豆!

    售前咨询电话

    400-811-8890转1

    在线技术支持

    在线QQ:800049425

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526