2025 年 2 月 20 日
今天标志着 Keycloak JS 发展的重大里程碑,版本 26.2.0
正式发布。这个新版本代表了 JavaScript 适配器如何与 Keycloak 生态系统一同开发和演进的转变。虽然这个新版本没有引入任何功能性更改到适配器,但它确实包含了一些组织结构上的变化。
最值得注意的变化是 Keycloak JS 现在脱离了主 Keycloak 项目的发布周期。正如今年早些时候宣布的那样,JavaScript 适配器将遵循其独立的开发路径。与主项目分离允许更频繁地发布功能、错误修复,并提高对社区反馈的响应速度。JavaScript 适配器将继续向后兼容所有 Keycloak 服务器的活跃支持版本,偏离这一点将被视为重大更改。
选择使用比主项目本身更高的版本号是故意的,目的是向用户表明与 Keycloak 发布周期的分离。然而,我们将继续致力于使用语义化版本控制,仅在进行向后不兼容的更改时才提升主版本号,这在 NPM 生态系统中是惯例。维护更新将继续在 26.1.x
系列中发布,因为它与当前 Keycloak 服务器的稳定版本相关联,但我们鼓励用户根据需要升级到新版本。
另一个重大变化是将代码库迁移到其自己的专用仓库。这种结构调整不仅仅是行政上的——它代表着向着更好可维护性的战略举措。通过将 JavaScript 适配器与主 Keycloak 仓库分离,开发团队在管理代码库和处理社区贡献方面获得了更大的灵活性。如果您希望提供贡献或报告问题,请将您的精力转移到这里。
展望未来,我们将专注于 Keycloak JS 的下一步发展。当它最初发布时,只有少数用于客户端 JavaScript 的 OpenID Connect 适配器,因此我们需要制作我们自己的适配器。然而,现在的景象已大不相同,并且有许多成熟的解决方案可用。Keycloak JS 的代码需要现代化,并且由于日益增长的复杂性而变得难以维护。我们将继续评估继续重构 Keycloak JS、整合一些我们可以协作的成熟的第三方库,甚至用完善的社区解决方案替换它是否合理。
在升级之前,请参阅迁移指南,以获取完整的更改列表。