插件與 JAR 包不匹配問題

1

版本說明。

2

應用場景。

1. 每個插件，在插件管理介面、帆軟市場插件介面、對應的插件介紹文件中都會註明 JAR 包要求。 如下圖1所示。

2. 當插件版本和 JAR 包版本不匹配時，會影響插件的使用，嚴重的話會影響整個工程的執行，所以建議使用者在使用插件時，要保證插件版本和 JAR 包版本一致。

3. 使用者在安裝、更新插件時或更新工程後，可能會出現插件版本和 JAR 包版本不匹配的情況，在此種情況下，若無提醒或限制，工程就會有一個隱藏的風險。 2021-01-25 及以後的 JAR 包，在插件版本和工程 JAR 包版本不匹配時會自動禁用插件並進行提醒。 如下圖2所示。

1. 在插件管理處安裝、更新、升級，啟用插件或更新工程後啟動工程時，系統會自動檢測插件版本和 JAR 包是否匹配。 當版本匹配時，顯示正常，否則彈窗提示和禁用插件。

2. 檢測點為大版本之間是否匹配，即9.0、10.0是否跨版本；當前工程JAR包版本是否適應插件說明中要求的最低JAR包版本。

1

操作插件时。

1. 設計器線上或本地安裝、更新、啟用插件時，插件版本匹配，可正常操作，顯示操作成功的提醒。 若是因為插件版本不一致導致的安裝失敗，則會彈窗提示版本不匹配。 如下圖所示。

2. 插件版本高於 JAR 包要求的版本時，提示：【***插件版本過高，請升級 JAR 包或安裝低版本插件】。

3. 插件版本低於 JAR 包要求的版本時，提示：【***插件版本過低，請安裝高版本插件】。

4. 出現此情況後，使用者需檢查安裝的插件版本和 JAR 包版本，調整為一致後即不會有出錯警告。

2

啟動工程時。

1. 更新工程後，工程啟動時，當插件版本和 JAR 包要求的版本不匹配時，工程會禁用插件，管理員登入平台，平台會彈窗顯示版本不匹配。 如下圖1所示。

2. 插件版本高於 JAR 包要求的版本時，平台訊息通知：【插件 xxx 版本過高，已被系統禁用，請升級 JAR 包或安裝低版本插件】。

3. 插件版本低於 JAR 包要求的版本時，平台訊息通知：【插件 xxx 版本過低，已被系統禁用，請更新插件】。

4. 點選訊息內容，即可跳轉至【插件管理】頁面做相應處理，或在平台【系統訊息】處，通知內容後有【處理】跳轉連結，點選後可直接跳轉至【插件管理】頁面，管理員可對控制元件做相應的處理，使得插件可用。 如下圖2所示。

注：叢集環境下，多個節點都會進行匹配檢測。 若基準節點先完成啟動，提醒時只使用基準節點的檢測結果，只進行一次提醒；若基準節點還未完成啟動，已有其他節點先完成啟動，則會進行多次提醒。

3

使用設計時。

1. 若插件版本和本地設計器 JAR 包版本不匹配，開啟設計器時，設計器會彈窗提醒：以【下插件與 JAR 包版本不匹配，已被禁用】。

2. 彈窗中詳細列舉了不匹配的插件，點選【立即處理】即可跳轉至【插件管理】頁面對插件做相應處理。 如下圖所示。

3. 設計器切換本地其他目錄時，也會檢測插件和工程 JAR 包是否匹配，不匹配會彈窗提醒。

注：遠程設計時，不檢測插件版本和工程 JAR 包版本資訊，即不匹配時不會彈窗提醒。

1. 當插件與 JAR 包不匹配時需要進行插件的更新或刪除，詳情如下。

1

伺服器插件更新與刪除。

1. 伺服器插件更新與刪除請參考：A11-18 伺服器-插件管理。