Radiance 8.0.0 发布：现代化UI框架的重大升级与色彩系统革新

项目背景

Radiance 是一个现代化的 Java Swing 外观与感觉(Look and Feel)框架，前身为著名的 Substance 项目。它提供了丰富的 UI 组件、主题系统和视觉增强功能，帮助开发者构建美观且专业的桌面应用程序。2025年5月发布的 8.0.0 版本恰逢项目20周年纪念，带来了多项重要改进。

革命性的色彩系统

8.0.0 版本最显著的改进是引入了全新的色彩系统架构，代号"Project Chroma"。这一系统彻底重构了框架的色彩管理方式：

1. 色彩标记(Color Tokens)：采用语义化的命名方式定义颜色，如"background.fill"或"text.primary"，而非传统的RGB值，使主题定义更加直观

2. 色彩关联类型(Color Token Association Kinds)：明确定义了颜色在不同状态下的关联方式，如悬停、按下、禁用等状态的颜色变化规则

3. 色彩标记包(Color Tokens Bundles)：将相关颜色组织成逻辑组，便于管理和维护

4. Ephemeral Chroma 集成：底层依赖新的色彩处理库，提供更强大的色彩操作能力

这一变革使得主题定制更加灵活和系统化，同时也意味着开发者需要按照迁移指南调整现有代码以适应新的API。

主题系统增强

在视觉呈现方面，8.0.0版本进行了多项优化：

• 窗口操作术语标准化，使用"最小化"替代了之前的"图标化"表述
• 改进了多显示器环境下的窗口移动行为，消除了跳跃现象
• 修复了JTree组件字体设置的异常问题
• 统一处理了列表、表格、树等基于渲染器的组件在禁用状态下的选择高亮
• 滚动条视觉优化，确保内容可滚动时始终显示滚动滑块
• 修复了打印时滑块轨道和滑块的显示问题
• 改进了使用哑光装饰绘制器的皮肤下内部框架标题区域的视觉效果

组件功能改进

Radiance的组件系统也获得了多项增强：

• 流式功能区带现在支持接受BaseProjection作为组件，提高了布局灵活性
• 修复了最小化功能区内容中组合框的用户交互问题
• 改进了图标过滤策略在功能区应用菜单命令中的应用
• 修复了二级菜单命令的覆盖传递问题
• 解决了功能区带从折叠状态开始时可能导致的崩溃问题
• 优化了禁用命令按钮的活动悬停/按下状态视觉效果
• 确保在二级内容模型更新时命令按钮能正确更新
• 修复了弹出窗口中折叠功能区带的键提示显示问题

技术栈升级

8.0.0版本同步更新了多项依赖：

• Kotlin从2.0.0升级到2.1.20
• Kotlin协程从1.8.1升级到1.10.2
• Dokka文档工具从1.9.20升级到2.0.0
• Batik SVG处理库从1.17升级到1.19
• Retrofit网络库从2.11.0升级到3.0.0
• Gradle构建工具从8.8升级到8.14

总结

Radiance 8.0.0作为项目20周年的里程碑版本，通过全新的色彩系统架构和多项功能改进，为Java Swing应用程序开发带来了更现代化、更专业的UI解决方案。虽然新版本引入了一些不兼容的API变更，但配套的迁移指南和显著提升的功能性使其成为值得升级的选择。对于追求高质量用户界面的Java桌面应用开发者而言，Radiance 8.0.0提供了更强大的工具和更优美的视觉效果。