Backstage 后端动态插件服务的完整版本演进解析backstage/backend-dynamic-feature-service 从 0.0.1 到 0.8.7【免费下载链接】backstageBackstage is an open framework for building developer portals项目地址: https://gitcode.com/GitHub_Trending/ba/backstage本文以 packages/backend-dynamic-feature-service/CHANGELOG.md 为主线系统梳理 Backstage 动态特性服务包backstage/backend-dynamic-feature-service自 0.1.0 诞生至当前 0.8.7 的全部版本史每个里程碑引入了什么能力、哪些版本包含破坏性变更、插件加载入口契约如何演进并结合仓库源码验证这些变更记录背后的真实实现帮助你在升级该包时准确判断迁移成本与行为差异。一、包定位与当前版本基线该包为 Backstage 提供实验性的动态后端特性插件与模块支持允许从独立目录在运行时加载后端插件而不必将其写入主应用的 package.json 依赖中。其价值在于插件独立分发、免整体重建热更新、依赖隔离与按环境差异化部署详见 README.md。从当前 package.json 可以确认几个与版本史直接相关的事实当前版本为0.8.7-next.2backstage.role为node-library运行时依赖包含chokidar目录监听对应 0.6.0 中 scanner 的变更跟踪修复、module-federation/sdk固定为~2.8.2印证了 0.8.2/0.8.7 中 Module Federation 依赖升级记录、express与express-promise-router0.7.7 将 express 从 4.21.2 升到 4.22.0 的来源、winston根 logger 实现以及大量workspace:^内部依赖——这正是 changelog 中每个版本都出现大段 “Updated dependencies” 的原因Backstage 采用 monorepo 协同发布兄弟包升级会连带本包产生 patch 版本。服务本身只有一个必需配置项定义在 config.d.tsexport interface Config { dynamicPlugins?: { /** The local path, relative to the backstage root, that contains dynamic plugins. */ rootDirectory: string; }; }对应的app-config.yaml写法dynamicPlugins: rootDirectory: dynamic-plugins-root在 src/features/features.ts 中可以看到该配置键是启用整个功能的开关feature loader 内部通过config.has(configKey)判断是否加载动态插件相关特性因此未配置dynamicPlugins.rootDirectory时该服务不会扫描任何目录。二、版本史总览从诞生到 0.8.x 的六个阶段CHANGELOG 全文按版本倒序排列稳定版与-next.N预发布版交替出现。预发布版如0.8.7-next.1内容通常与最终稳定版一致但更早合入稳定版条目是其“最终确认”。以下按时间正序分阶段解读。2.1 0.0.1 → 0.1.0包诞生与动态插件发现能力0.0.1 / 0.0.2 / 0.0.3 / 0.0.4均为纯依赖同步版本“Updated dependencies”无自身功能变更说明包在 0.1.0 前以实验性骨架形式快速迭代。0.1.0eb81f42正式确立包的使命——“Newbackend-dynamic-feature-servicepackage, for the discovery of dynamic frontend and backend plugins (and modules) and the loading of the backend ones inside the backend application”即发现动态前后端插件、并在后端应用内加载后端插件。这正是今天 src/ 下scanner/扫描发现与manager/加载管理两个目录的职责来源。2.2 0.2.x配置 schema 发现、alpha 包修复与扫描健壮性0.2.0d7adbbfMinor实现动态插件的独立配置 schema 发现并提供两处配套一个考虑动态插件 schema 的根 logger 服务替代实现对应 src/schemas/rootLogger.ts 与 src/schemas/schemas.ts以及 App 后端插件的全局配置 schema 扩展。同期还修复了alpha子包支持问题8723c5a新后端体系下动态插件加载不应强制要求alpha子包存在并将fs-extra升到^11.2.0。0.2.45247909向LegacyPluginEnvironment增加events: EventsService动态插件由此获得事件总线访问能力。0.2.982ff03e显式使用PackageRole类型。0.2.10b611fd0PluginScanner的scanRoot方法改为显式忽略lostfound目录Unix 文件恢复目录避免扫描产生无谓错误d229dc4路径工具从backend-common迁移到backend-plugin-api包。2.3 0.3.0剥离即将删除的 backend-tasks0.3.0fc24d9eMinor停止使用backstage/backend-tasks因其将被删除——动态插件加载不再依赖任务调度子系统。同期还有内部导入更新b63d378与废弃的 url-reader 相关导入修正389f5a4。2.4 0.4.x加载器 API 重构重要破坏性变更与 all-in-one 入口这是 API 形态变化最集中的阶段也是升级者最需要关注的部分。0.4.0Minor9080f57BREAKINGdynamicPluginsServiceFactory不再可以作为函数直接调用需要传自定义选项时应改用dynamicPluginsSchemasServiceFactoryWithOptions。cd38da8废弃dynamicPluginsServiceRef、dynamicPluginsServiceFactory、dynamicPluginsServiceFactoryWithOptions推荐使用dynamicPluginsFeatureDiscoveryLoader在新后端体系中做动态特性发现。changelog 内直接给出了用法示例import { createBackend } from backstage/backend-defaults; import { dynamicPluginsFeatureDiscoveryLoader } from backstage/backend-dynamic-feature-service; const backend createBackend(); backend.add(dynamicPluginsFeatureDiscoveryLoader); backend.start();以及传入自定义模块加载器的变体import { myCustomModuleLoader } from ./myCustomModuleLoader; const backend createBackend(); backend.add( dynamicPluginsFeatureDiscoveryLoader({ moduleLoader: myCustomModuleLoader, }), ); backend.start();e27f889放宽插件默认导出的类型检查——除对象外也接受函数形式定义的BackendFeature。d425fc4模块、插件、服务从此是BackendFeature本身而不再是“返回 feature 的函数”。0.4.2d18d494Patch大幅简化启用方式引入了至今仍在使用的一体化加载器恢复实现了DynamicPluginsProvider的动态插件服务插件依赖它获取已加载动态插件的详情含加载错误可在 UI 中展示新增 all-in-one 的dynamicPluginsFeatureLoader一行代码同时启用动态特性与配套服务根 logger schema、前端 schema 等此前的服务工厂/特性加载器被标记废弃e6c0550增强DynamicPluginProvider服务 API新增getScannedPackage()返回插件加载来源的ScannedPluginPackage列表方法新增includeFailed可选参数默认false是否包含加载失败的插件4c89e47允许在DynamicPluginsFeatureLoaderOptions中传入异步模块加载器。当前 src/features/features.ts 中的实现与这段历史完全对应dynamicPluginsFeatureLoaderWithOptions通过createBackendFeatureLoader先无条件yielddynamicPluginsSchemasServiceFactory与dynamicPluginsServiceFactory再在dynamicPluginsEnabled即配置了dynamicPlugins.rootDirectory时追加dynamicPluginsRootLoggerServiceFactory、dynamicPluginsFrontendSchemas、frontendRemotesServerService和dynamicPluginsFeatureDiscoveryLoader。注意它同时是“可直接backend.add(dynamicPluginsFeatureLoader)的已构造实例”和“可传参的工厂函数”源码末尾Object.assign双形态导出支持moduleLoader、schemaLocator与logger三类选项。2.5 0.5.0logger 选项收敛与 resolvePackagePath 支持0.5.0e939cd7BREAKINGdynamicPluginsFeatureLoader的根 logger 相关选项原先分散的transports、level、format收敛为单一logger选项——一个接收可选Config参数、返回 logger 选项对象的函数。changelog 说明了动机logger 配置可能需要读取当前Config且未来引入根审计服务时auditor 也需要名称相近的独立选项。这与当前类型定义DynamicPluginsFeatureLoaderOptions中的logger?: (config?: Config) DynamicPluginsRootLoggerFactoryOptions一致。同版本两条关键补丁1aeec12增强 src/loader/CommonJSModuleLoader.ts支持来自动态后端插件的resolvePackagePath调用可自定义包解析并将CommonJSModuleLoader提升为公开 API。changelog 特别指出其对使用数据库的动态插件至关重要——因为数据库迁移脚本会系统性地使用resolvePackagePath8593dfa改进 alpha 包支持——从 alphapackage.json加载的动态后端插件其ScannedPluginPackage描述符现在同时包含主包 manifest 与 alpha manifest此前只包含几乎为空的 alphapackage.json内容便于展示/使用主 manifest 中的元数据。测试夹具目录 src/features/fixtures/dynamic-plugins-root-for-alpha/ 即为该场景而设。2.6 0.6.x清理废弃工厂、扫描稳定性与前端资源服务器0.6.0Minor92a56f6BREAKING移除已废弃的dynamicPluginsFeatureDiscoveryServiceFactory96c20cd确保变更被成功跟踪后再启动 scanner修复目录监听chokidar启动时序问题。0.6.23bee3c3本包职责扩展的重要节点——新增frontend-dynamic-features-loader前端特性加载器配套包同时本包内新增前端插件 Module Federation remotes 的 HTTP 服务通过 HTTP 向前端分发动态前端插件的 JS/CSS/manifest。对应源码为 src/server/frontendRemotesServer.ts 与 src/server/router.ts其 HTTP 契约由 src/schema/openapi.yaml 定义并生成 OpenAPI 客户端代码src/schema/openapi/generated/。README 中 “Frontend Asset Server” 组件即源于此版本。2.7 0.7.x与遗留后端的彻底切割及工程化加固0.7.010f693cBREAKING移除对 legacy backend 的支持要求迁移到新后端体系——动态插件服务自此只服务createBackend()新世界。同期72d019d修复拼写错误FrontendRemoteResolver的getAdditionaRemoteInfo被废弃改用正确拼写的getAdditionalRemoteInfo。0.7.23507fcd3d61c36继续清理循环依赖并修复“启用动态插件时因错误导入导致模块初始化失败”的问题——这类问题通常表现为后端启动时整个模块图初始化异常。0.7.605f60e1将构造器参数属性constructor parameter properties重构为显式属性声明以兼容 TypeScript 的erasableSyntaxOnly设置功能保持不变。0.7.7de96a60express从 4.21.2 升至 4.22.0。0.7.97455dae原生导入统一加node:前缀fdbd404将module-federation/enhanced、module-federation/runtime、module-federation/sdk从^0.9.0升到^0.21.69b4c414更新 README即今日包含 “Packaging Approaches” 三套打包方案的文档。2.8 0.8.xOpenAPI 3.1、捆绑插件解析修复与 alpha 回退机制当前主线0.8.0Minor0fbcf23OpenAPI schema 迁移到 3.1对应 src/schema/openapi.yaml 及其生成产物4074a22修复捆绑动态插件的resolvePackagePath解析——当插件在自身node_modules里捆绑了一份backstage/backend-plugin-api时CommonJSModuleLoader的回退逻辑现可按名称正确解析该插件的package.json。此前回退只对“解析源自宿主应用”的情况生效而现在对“源自捆绑依赖”的情况即backstage-cli package bundle命令产物同样生效。这与 src/features/fixtures/dynamic-plugins-root-for-bundled/ 测试夹具相互印证70fc178从已废弃的findPaths迁移到backstage/cli-common的targetPaths与findOwnPaths。0.8.241070b8将三个module-federation/*依赖从^0.21.6升到^2.3.3修复已知安全漏洞。0.8.37005478修复动态后端插件加载的 alpha 回退逻辑——当存在 alphapackage.json但其入口未提供插件入口点时回退到主包导出。修复前仅暴露补充性 API如权限相关的 alpha 导出会导致插件即使主导出完全有效也无法加载修复后加载器先尝试 alpha 入口只有当 alpha 模块未导出BackendFeature、BackendFeatureFactory或dynamicPluginInstaller时才使用主导出。测试夹具 src/features/fixtures/dynamic-plugins-root-for-alpha-fallback/ 即覆盖此场景。0.8.6bb98419配置密钥脱敏secret redaction设置过程中发现的 TypeScript 配置 schema 警告现通过 Backstage logger 上报不再静默丢失。0.8.7-next.2064c2de当前 HEAD再次更新 Module Federation 依赖至可规避已知安全漏洞的版本0.8.7-next.0/next.1为纯依赖同步版本。三、源码印证插件加载入口契约CHANGELOG 中 0.4.0d425fc4/e27f889、0.5.08593dfa与 0.8.37005478反复触及的“插件模块应导出什么”这一问题在 src/manager/plugin-manager.ts 中有最终答案。加载失败时的错误信息第 229 行明确了三种合法入口the module should either export a BackendFeature or BackendFeatureFactory as default export, or export a const dynamicPluginInstaller: BackendDynamicPluginInstaller field as dynamic loading entrypoint.即模块默认导出BackendFeature或BackendFeatureFactory源码通过$$type backstage/BackendFeatureFactory标记识别工厂见 plugin-manager.ts 的isBackendFeatureFactory或者显式导出dynamicPluginInstaller字段作为动态加载入口点。plugin-manager.test.ts 用exports.dynamicPluginInstaller{ kind: new, install: () [] }等桩模块对这三条路径及非法形态做了逐条断言。alpha 包的双 manifest 描述与回退加载逻辑同样由该文件及其测试夹具支撑。四、CommonJSModuleLoader跨 0.5.0 与 0.8.0 的两次关键增强src/loader/CommonJSModuleLoader.ts 是动态插件与宿主应用依赖边界的核心changelog 中两次修改都落在它身上0.5.01aeec12支持来自动态插件内部的resolvePackagePath调用并支持自定义包解析——数据库迁移脚本场景的刚需0.8.04074a22把“按名称解析插件package.json”的回退扩展到了解析源自捆绑依赖的场景直接服务于backstage-cli package bundle生成的自包含插件包README 中第 3 种打包方式。该 loader 自 0.5.0 起为公开 API用户可在dynamicPluginsFeatureLoader({ moduleLoader: myCustomModuleLoader })中整体替换加载策略0.4.2 的4c89e47同时允许传入异步加载器。五、升级与阅读建议破坏性变更清单升级跨版本时逐条核对0.4.0factory 不再可直接调用、BackendFeature契约变化、0.5.0logger 选项收敛为函数式logger选项、0.6.0移除dynamicPluginsFeatureDiscoveryServiceFactory、0.7.0移除 legacy backend 支持安全相关依赖升级0.7.9module-federation/*0.9.0→0.21.6、0.7.7express 4.21.2→4.22.0、0.8.2module-federation/*0.21.6→2.3.3、0.8.7-next.2MF 依赖再升级版本命名约定x.y.z为稳定版x.y.z-next.N为同周期预发布版内容先行于稳定版落地绝大多数 “Updated dependencies” 条目是 monorepo 协同发布产生的版本联动无自身行为变化启用该服务的最小可运行配置是backend.add(dynamicPluginsFeatureLoader)app-config.yaml中配置dynamicPlugins.rootDirectory插件包须满足 README 所述的package.json必需字段name、version、main、backstage.role为backend-plugin或backend-plugin-module。六、延伸阅读仓库内路径CHANGELOG.md本文全部版本条目的原始出处README.md使用方式、打包方案yarn pack/ 手动安装依赖 /backstage-cli package bundleconfig.d.tsdynamicPlugins.rootDirectory配置契约src/features/features.tsdynamicPluginsFeatureLoader一体化入口实现src/manager/plugin-manager.ts 与 src/manager/plugin-manager.test.ts插件入口契约及其测试src/loader/CommonJSModuleLoader.ts动态插件 CJS 模块加载与包解析src/server/frontendRemotesServer.ts前端动态插件资源 HTTP 服务src/schema/openapi.yaml该 HTTP 服务的 OpenAPI 契约0.8.0 起为 3.1。【免费下载链接】backstageBackstage is an open framework for building developer portals项目地址: https://gitcode.com/GitHub_Trending/ba/backstage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Backstage 后端动态插件服务的完整版本演进解析：@backstage/backend-dynamic-feature-service 从 0.0.1 到 0.8.7
Backstage 后端动态插件服务的完整版本演进解析backstage/backend-dynamic-feature-service 从 0.0.1 到 0.8.7【免费下载链接】backstageBackstage is an open framework for building developer portals项目地址: https://gitcode.com/GitHub_Trending/ba/backstage本文以 packages/backend-dynamic-feature-service/CHANGELOG.md 为主线系统梳理 Backstage 动态特性服务包backstage/backend-dynamic-feature-service自 0.1.0 诞生至当前 0.8.7 的全部版本史每个里程碑引入了什么能力、哪些版本包含破坏性变更、插件加载入口契约如何演进并结合仓库源码验证这些变更记录背后的真实实现帮助你在升级该包时准确判断迁移成本与行为差异。一、包定位与当前版本基线该包为 Backstage 提供实验性的动态后端特性插件与模块支持允许从独立目录在运行时加载后端插件而不必将其写入主应用的 package.json 依赖中。其价值在于插件独立分发、免整体重建热更新、依赖隔离与按环境差异化部署详见 README.md。从当前 package.json 可以确认几个与版本史直接相关的事实当前版本为0.8.7-next.2backstage.role为node-library运行时依赖包含chokidar目录监听对应 0.6.0 中 scanner 的变更跟踪修复、module-federation/sdk固定为~2.8.2印证了 0.8.2/0.8.7 中 Module Federation 依赖升级记录、express与express-promise-router0.7.7 将 express 从 4.21.2 升到 4.22.0 的来源、winston根 logger 实现以及大量workspace:^内部依赖——这正是 changelog 中每个版本都出现大段 “Updated dependencies” 的原因Backstage 采用 monorepo 协同发布兄弟包升级会连带本包产生 patch 版本。服务本身只有一个必需配置项定义在 config.d.tsexport interface Config { dynamicPlugins?: { /** The local path, relative to the backstage root, that contains dynamic plugins. */ rootDirectory: string; }; }对应的app-config.yaml写法dynamicPlugins: rootDirectory: dynamic-plugins-root在 src/features/features.ts 中可以看到该配置键是启用整个功能的开关feature loader 内部通过config.has(configKey)判断是否加载动态插件相关特性因此未配置dynamicPlugins.rootDirectory时该服务不会扫描任何目录。二、版本史总览从诞生到 0.8.x 的六个阶段CHANGELOG 全文按版本倒序排列稳定版与-next.N预发布版交替出现。预发布版如0.8.7-next.1内容通常与最终稳定版一致但更早合入稳定版条目是其“最终确认”。以下按时间正序分阶段解读。2.1 0.0.1 → 0.1.0包诞生与动态插件发现能力0.0.1 / 0.0.2 / 0.0.3 / 0.0.4均为纯依赖同步版本“Updated dependencies”无自身功能变更说明包在 0.1.0 前以实验性骨架形式快速迭代。0.1.0eb81f42正式确立包的使命——“Newbackend-dynamic-feature-servicepackage, for the discovery of dynamic frontend and backend plugins (and modules) and the loading of the backend ones inside the backend application”即发现动态前后端插件、并在后端应用内加载后端插件。这正是今天 src/ 下scanner/扫描发现与manager/加载管理两个目录的职责来源。2.2 0.2.x配置 schema 发现、alpha 包修复与扫描健壮性0.2.0d7adbbfMinor实现动态插件的独立配置 schema 发现并提供两处配套一个考虑动态插件 schema 的根 logger 服务替代实现对应 src/schemas/rootLogger.ts 与 src/schemas/schemas.ts以及 App 后端插件的全局配置 schema 扩展。同期还修复了alpha子包支持问题8723c5a新后端体系下动态插件加载不应强制要求alpha子包存在并将fs-extra升到^11.2.0。0.2.45247909向LegacyPluginEnvironment增加events: EventsService动态插件由此获得事件总线访问能力。0.2.982ff03e显式使用PackageRole类型。0.2.10b611fd0PluginScanner的scanRoot方法改为显式忽略lostfound目录Unix 文件恢复目录避免扫描产生无谓错误d229dc4路径工具从backend-common迁移到backend-plugin-api包。2.3 0.3.0剥离即将删除的 backend-tasks0.3.0fc24d9eMinor停止使用backstage/backend-tasks因其将被删除——动态插件加载不再依赖任务调度子系统。同期还有内部导入更新b63d378与废弃的 url-reader 相关导入修正389f5a4。2.4 0.4.x加载器 API 重构重要破坏性变更与 all-in-one 入口这是 API 形态变化最集中的阶段也是升级者最需要关注的部分。0.4.0Minor9080f57BREAKINGdynamicPluginsServiceFactory不再可以作为函数直接调用需要传自定义选项时应改用dynamicPluginsSchemasServiceFactoryWithOptions。cd38da8废弃dynamicPluginsServiceRef、dynamicPluginsServiceFactory、dynamicPluginsServiceFactoryWithOptions推荐使用dynamicPluginsFeatureDiscoveryLoader在新后端体系中做动态特性发现。changelog 内直接给出了用法示例import { createBackend } from backstage/backend-defaults; import { dynamicPluginsFeatureDiscoveryLoader } from backstage/backend-dynamic-feature-service; const backend createBackend(); backend.add(dynamicPluginsFeatureDiscoveryLoader); backend.start();以及传入自定义模块加载器的变体import { myCustomModuleLoader } from ./myCustomModuleLoader; const backend createBackend(); backend.add( dynamicPluginsFeatureDiscoveryLoader({ moduleLoader: myCustomModuleLoader, }), ); backend.start();e27f889放宽插件默认导出的类型检查——除对象外也接受函数形式定义的BackendFeature。d425fc4模块、插件、服务从此是BackendFeature本身而不再是“返回 feature 的函数”。0.4.2d18d494Patch大幅简化启用方式引入了至今仍在使用的一体化加载器恢复实现了DynamicPluginsProvider的动态插件服务插件依赖它获取已加载动态插件的详情含加载错误可在 UI 中展示新增 all-in-one 的dynamicPluginsFeatureLoader一行代码同时启用动态特性与配套服务根 logger schema、前端 schema 等此前的服务工厂/特性加载器被标记废弃e6c0550增强DynamicPluginProvider服务 API新增getScannedPackage()返回插件加载来源的ScannedPluginPackage列表方法新增includeFailed可选参数默认false是否包含加载失败的插件4c89e47允许在DynamicPluginsFeatureLoaderOptions中传入异步模块加载器。当前 src/features/features.ts 中的实现与这段历史完全对应dynamicPluginsFeatureLoaderWithOptions通过createBackendFeatureLoader先无条件yielddynamicPluginsSchemasServiceFactory与dynamicPluginsServiceFactory再在dynamicPluginsEnabled即配置了dynamicPlugins.rootDirectory时追加dynamicPluginsRootLoggerServiceFactory、dynamicPluginsFrontendSchemas、frontendRemotesServerService和dynamicPluginsFeatureDiscoveryLoader。注意它同时是“可直接backend.add(dynamicPluginsFeatureLoader)的已构造实例”和“可传参的工厂函数”源码末尾Object.assign双形态导出支持moduleLoader、schemaLocator与logger三类选项。2.5 0.5.0logger 选项收敛与 resolvePackagePath 支持0.5.0e939cd7BREAKINGdynamicPluginsFeatureLoader的根 logger 相关选项原先分散的transports、level、format收敛为单一logger选项——一个接收可选Config参数、返回 logger 选项对象的函数。changelog 说明了动机logger 配置可能需要读取当前Config且未来引入根审计服务时auditor 也需要名称相近的独立选项。这与当前类型定义DynamicPluginsFeatureLoaderOptions中的logger?: (config?: Config) DynamicPluginsRootLoggerFactoryOptions一致。同版本两条关键补丁1aeec12增强 src/loader/CommonJSModuleLoader.ts支持来自动态后端插件的resolvePackagePath调用可自定义包解析并将CommonJSModuleLoader提升为公开 API。changelog 特别指出其对使用数据库的动态插件至关重要——因为数据库迁移脚本会系统性地使用resolvePackagePath8593dfa改进 alpha 包支持——从 alphapackage.json加载的动态后端插件其ScannedPluginPackage描述符现在同时包含主包 manifest 与 alpha manifest此前只包含几乎为空的 alphapackage.json内容便于展示/使用主 manifest 中的元数据。测试夹具目录 src/features/fixtures/dynamic-plugins-root-for-alpha/ 即为该场景而设。2.6 0.6.x清理废弃工厂、扫描稳定性与前端资源服务器0.6.0Minor92a56f6BREAKING移除已废弃的dynamicPluginsFeatureDiscoveryServiceFactory96c20cd确保变更被成功跟踪后再启动 scanner修复目录监听chokidar启动时序问题。0.6.23bee3c3本包职责扩展的重要节点——新增frontend-dynamic-features-loader前端特性加载器配套包同时本包内新增前端插件 Module Federation remotes 的 HTTP 服务通过 HTTP 向前端分发动态前端插件的 JS/CSS/manifest。对应源码为 src/server/frontendRemotesServer.ts 与 src/server/router.ts其 HTTP 契约由 src/schema/openapi.yaml 定义并生成 OpenAPI 客户端代码src/schema/openapi/generated/。README 中 “Frontend Asset Server” 组件即源于此版本。2.7 0.7.x与遗留后端的彻底切割及工程化加固0.7.010f693cBREAKING移除对 legacy backend 的支持要求迁移到新后端体系——动态插件服务自此只服务createBackend()新世界。同期72d019d修复拼写错误FrontendRemoteResolver的getAdditionaRemoteInfo被废弃改用正确拼写的getAdditionalRemoteInfo。0.7.23507fcd3d61c36继续清理循环依赖并修复“启用动态插件时因错误导入导致模块初始化失败”的问题——这类问题通常表现为后端启动时整个模块图初始化异常。0.7.605f60e1将构造器参数属性constructor parameter properties重构为显式属性声明以兼容 TypeScript 的erasableSyntaxOnly设置功能保持不变。0.7.7de96a60express从 4.21.2 升至 4.22.0。0.7.97455dae原生导入统一加node:前缀fdbd404将module-federation/enhanced、module-federation/runtime、module-federation/sdk从^0.9.0升到^0.21.69b4c414更新 README即今日包含 “Packaging Approaches” 三套打包方案的文档。2.8 0.8.xOpenAPI 3.1、捆绑插件解析修复与 alpha 回退机制当前主线0.8.0Minor0fbcf23OpenAPI schema 迁移到 3.1对应 src/schema/openapi.yaml 及其生成产物4074a22修复捆绑动态插件的resolvePackagePath解析——当插件在自身node_modules里捆绑了一份backstage/backend-plugin-api时CommonJSModuleLoader的回退逻辑现可按名称正确解析该插件的package.json。此前回退只对“解析源自宿主应用”的情况生效而现在对“源自捆绑依赖”的情况即backstage-cli package bundle命令产物同样生效。这与 src/features/fixtures/dynamic-plugins-root-for-bundled/ 测试夹具相互印证70fc178从已废弃的findPaths迁移到backstage/cli-common的targetPaths与findOwnPaths。0.8.241070b8将三个module-federation/*依赖从^0.21.6升到^2.3.3修复已知安全漏洞。0.8.37005478修复动态后端插件加载的 alpha 回退逻辑——当存在 alphapackage.json但其入口未提供插件入口点时回退到主包导出。修复前仅暴露补充性 API如权限相关的 alpha 导出会导致插件即使主导出完全有效也无法加载修复后加载器先尝试 alpha 入口只有当 alpha 模块未导出BackendFeature、BackendFeatureFactory或dynamicPluginInstaller时才使用主导出。测试夹具 src/features/fixtures/dynamic-plugins-root-for-alpha-fallback/ 即覆盖此场景。0.8.6bb98419配置密钥脱敏secret redaction设置过程中发现的 TypeScript 配置 schema 警告现通过 Backstage logger 上报不再静默丢失。0.8.7-next.2064c2de当前 HEAD再次更新 Module Federation 依赖至可规避已知安全漏洞的版本0.8.7-next.0/next.1为纯依赖同步版本。三、源码印证插件加载入口契约CHANGELOG 中 0.4.0d425fc4/e27f889、0.5.08593dfa与 0.8.37005478反复触及的“插件模块应导出什么”这一问题在 src/manager/plugin-manager.ts 中有最终答案。加载失败时的错误信息第 229 行明确了三种合法入口the module should either export a BackendFeature or BackendFeatureFactory as default export, or export a const dynamicPluginInstaller: BackendDynamicPluginInstaller field as dynamic loading entrypoint.即模块默认导出BackendFeature或BackendFeatureFactory源码通过$$type backstage/BackendFeatureFactory标记识别工厂见 plugin-manager.ts 的isBackendFeatureFactory或者显式导出dynamicPluginInstaller字段作为动态加载入口点。plugin-manager.test.ts 用exports.dynamicPluginInstaller{ kind: new, install: () [] }等桩模块对这三条路径及非法形态做了逐条断言。alpha 包的双 manifest 描述与回退加载逻辑同样由该文件及其测试夹具支撑。四、CommonJSModuleLoader跨 0.5.0 与 0.8.0 的两次关键增强src/loader/CommonJSModuleLoader.ts 是动态插件与宿主应用依赖边界的核心changelog 中两次修改都落在它身上0.5.01aeec12支持来自动态插件内部的resolvePackagePath调用并支持自定义包解析——数据库迁移脚本场景的刚需0.8.04074a22把“按名称解析插件package.json”的回退扩展到了解析源自捆绑依赖的场景直接服务于backstage-cli package bundle生成的自包含插件包README 中第 3 种打包方式。该 loader 自 0.5.0 起为公开 API用户可在dynamicPluginsFeatureLoader({ moduleLoader: myCustomModuleLoader })中整体替换加载策略0.4.2 的4c89e47同时允许传入异步加载器。五、升级与阅读建议破坏性变更清单升级跨版本时逐条核对0.4.0factory 不再可直接调用、BackendFeature契约变化、0.5.0logger 选项收敛为函数式logger选项、0.6.0移除dynamicPluginsFeatureDiscoveryServiceFactory、0.7.0移除 legacy backend 支持安全相关依赖升级0.7.9module-federation/*0.9.0→0.21.6、0.7.7express 4.21.2→4.22.0、0.8.2module-federation/*0.21.6→2.3.3、0.8.7-next.2MF 依赖再升级版本命名约定x.y.z为稳定版x.y.z-next.N为同周期预发布版内容先行于稳定版落地绝大多数 “Updated dependencies” 条目是 monorepo 协同发布产生的版本联动无自身行为变化启用该服务的最小可运行配置是backend.add(dynamicPluginsFeatureLoader)app-config.yaml中配置dynamicPlugins.rootDirectory插件包须满足 README 所述的package.json必需字段name、version、main、backstage.role为backend-plugin或backend-plugin-module。六、延伸阅读仓库内路径CHANGELOG.md本文全部版本条目的原始出处README.md使用方式、打包方案yarn pack/ 手动安装依赖 /backstage-cli package bundleconfig.d.tsdynamicPlugins.rootDirectory配置契约src/features/features.tsdynamicPluginsFeatureLoader一体化入口实现src/manager/plugin-manager.ts 与 src/manager/plugin-manager.test.ts插件入口契约及其测试src/loader/CommonJSModuleLoader.ts动态插件 CJS 模块加载与包解析src/server/frontendRemotesServer.ts前端动态插件资源 HTTP 服务src/schema/openapi.yaml该 HTTP 服务的 OpenAPI 契约0.8.0 起为 3.1。【免费下载链接】backstageBackstage is an open framework for building developer portals项目地址: https://gitcode.com/GitHub_Trending/ba/backstage创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考