Skip to content

docs: document ClassIsland 2.0.0.0+ host compatibility - #2

Open
PANDAJSR wants to merge 1 commit into
mainfrom
docs/host-2.0.0.0-compat
Open

docs: document ClassIsland 2.0.0.0+ host compatibility#2
PANDAJSR wants to merge 1 commit into
mainfrom
docs/host-2.0.0.0-compat

Conversation

@PANDAJSR

@PANDAJSR PANDAJSR commented Sep 4, 2026

Copy link
Copy Markdown
Collaborator

联动插件(本仓库)实际已在清单中声明 apiVersion: 2.0.0.0,即最低宿主版本本来就是 2.0.0.0;SecAgent 桌面端此前把安装门槛设成了 2.1.1.0(见 SECTL/SecAgent#9),属于过度收紧。本次在本仓库补充 README 说明,明确可运行的宿主版本范围。

兼容性依据(参考 ClassIsland 源码)

  1. 宿主 apiVersion 门槛:ClassIsland 2.0.0.0 起(ClassIsland/Services/PluginService.cs)只拒绝 apiVersion < new Version(2,0,0,0) 的插件,本插件 manifest.ymlapiVersion: 2.0.0.0 恰好满足;该检查在 2.0.0.0 → 2.1.1.1 各标签保持一致。
  2. 宿主 API 面:插件用到的 PluginBase.InitializeIAppHost.Host/GetService/TryGetServiceAppBase.AppVersion/Current/AppStoppingIProfileService.CurrentProfilePathIComponentsService.CurrentComponents/RefreshConfigsIExactTimeService.GetCurrentLocalDateTimeCommonDirectories.AppRootFolderPathSettingsWindowRegistryExtensions.AddSettingsPage<T>SettingsPageBase 等都在 ClassIsland 2.0.0.0 标签中存在。
  3. SDK 版本:插件 SDK 构建提交 27e93bb1.7.106.2)是 2.0.0.0 标签的祖先提交,且 csproj 对 SDK 使用 ExcludeAssets=runtime;native,运行时绑定宿主程序集,不存在版本超前问题。

结论:ClassIsland 2.0.0.0 及之后的 2.0.x/2.1.x 宿主均可加载并运行本插件;1.x 旧宿主使用旧版插件体系,不在支持范围(与 SECTL/SecAgent#9 中「2.0.0.0 以上都支持」的诉求一致)。

对应 SecAgent 端已把 MIN_CLASSISLAND_VERSION 从 2.1.1.0 下调为 2.0.0.0(见 SECTL/SecAgent 中本 issue 的修复 PR)。

The plugin manifest declares apiVersion 2.0.0.0 and every ClassIsland host
from 2.0.0.0 only rejects plugins below that API version, so the plugin runs
on all 2.0.0.0+ hosts (2.0.x/2.1.x). Records the verified floor for
SECTL/SecAgent#9 so users know the supported host range.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant