插件必须先通过正常 .otplugin 流程安装并在宿主完整重启后成为活动插件。开发命令不导入包、不创建活动状态,也不让宿主从源码工程或额外快照目录加载。
在插件仓库根目录复制 plugin-development.example.json 为 Git 忽略的 plugin-development.json:
{
"runtimeDirectory": "../opentest/.runtime/app"
}runtimeDirectory 指向宿主运行根,可以是绝对路径;相对路径固定按配置文件所在的插件仓库根解析。该配置是唯一目标来源,环境变量不会覆盖它。两个开发命令缺少配置时都会在构建前失败。
# 构建并投递完整插件;不传名称时逐个处理已正式安装生效的源码插件
pnpm dev fft-tools
# 只监听、构建和投递前端与语言资源;不传名称时采用相同的自动跳过规则
pnpm dev:watch fft-tools开发命令不执行前端或后端单元测试;需要验证测试时使用根目录 pnpm test 或对应插件的测试命令。
不传插件名时,dev 与 dev:watch 只自动发现包含 plugin.json 的插件目录;已移除插件留下的 backend/target、.runtime 等无清单残留目录会被忽略。显式指定缺少清单的目录仍报错,已有清单的格式错误或读取错误也不会被当作缓存目录跳过。
活动安装按完整 pluginId 匹配。旧 org.opentest.* 安装不会匹配新 com.opentest.* 源码;新身份插件需要先通过正常安装及完整重启生效。自动模式会提示并跳过未安装插件,跳过不代表已经完成构建或投递。
如果 pnpm dev fft-tools 在 Maven 编译阶段提示找不到 MeasurementEditor、ResultDescription、DigitalFilterValidation 或 PersistWaveformSinkProcessor,先核对匹配宿主源码中是否存在这些 API,以及插件实际解析到的 Maven JAR 是否包含它们。源码存在而 JAR 缺失时,需要更新本地宿主依赖。
当前插件后端通过 Maven 解析宿主公开依赖,默认使用 Maven settings 指定的本地仓库;它不会直接读取相邻宿主的源码或 target/classes。宿主 pnpm dev / pnpm dev:backend 每次执行 mvn clean package -DskipTests,成功后运行可执行 JAR,不会将新制品安装到 Maven 本地仓库。因此,即使双方依赖仍声明 2.5.0,插件也可能使用缺少新 API 的旧 JAR。
先停止源码宿主后端,在匹配版本的宿主仓库根目录执行:
pnpm prepare:backend-deps该命令执行宿主全后端的 mvn clean install -DskipTests,编译主代码和测试代码、跳过测试执行,并更新本地 Maven 制品。成功后回到插件仓库根目录执行 pnpm dev fft-tools。两次命令须使用相同的 Maven settings / 本地仓库;如设置了 OPENTEST_PLUGIN_MAVEN_REPOSITORY,还须确认插件使用的覆盖仓库确实有匹配制品。
不要通过删除新 API 调用、跳过测试编译或修改 SDK 摘要来规避依赖过期。若更新依赖后仍失败,应继续检查宿主与插件源码版本是否匹配。投递成功后,按下文要求手动重启宿主后端并完整刷新页面。
完整命令从 active-plugins.json 取得安装身份并定位唯一的活动安装目录,然后投递声明的后端 JAR、frontend/、locales/、contracts/ 和实际 plugin.json。它不改写活动状态或原始 files.sha256。前端、语言和契约使用受限镜像同步;其他包内容不会被清理。不传插件名时,仓库中尚未正式安装生效的插件会被提示并跳过;显式指定这类插件仍然报错。多插件处理中其他单个插件失败不阻塞其余插件,但最终命令返回非零并逐项报告。
活动状态中的插件标识、安装版本和包摘要是安装身份,只用于定位目录;源码 plugin.json 是实际运行清单,其版本可以与安装版本不同。宿主开发候选和登记报告中的 version 表示实际运行版本,packageDigest 仍是原正式安装摘要。开发投递不会把运行清单写回活动状态,也不能用这组混合字段推导另一个目录。
投递原地执行,没有 staging、备份或自动回滚。JAR 覆盖失败时仍尝试独立的前端和语言投递;任一步骤失败都不能视为完整成功。修复后重新运行命令,成功前不要启动后端或刷新页面。
宿主通过 pnpm dev 或 pnpm dev:backend 显式使用可变已安装内容策略。后端、清单或契约变化后,重新运行完整插件命令并手动重启宿主后端。监听命令不处理这些变化。前端投递成功后手动完整刷新页面;不存在 revision 通知、插件级卸载/重新激活或自动刷新。
待升级、禁用或卸载不会阻止当前活动目录的投递,但命令会警告下次完整重启可能替换或删除本次内容。插件管理仍可正常提交这些操作。
正式 pnpm start 和安装应用保持严格校验,被开发覆盖的目录会被拒绝。没有专用修复命令;返回严格运行前,使用正常插件管理卸载并重新安装正式 .otplugin。
纯后端插件不需要 Vite。完整命令仍投递后端、根语言资源、契约和清单;监听命令只同步语言资源。