AtomUI 发行版 - Gitee.com

v6.1.3

2026-08-09 19:01 v6.1.3 eb63f15

- 破坏性变更
  - Theme：自定义主题和控件包需要从手工维护 Token/Theme 注册迁移到生成式控件包 descriptor 和 `Themes/**/*.axaml` 资源清单，并在主题 schema 冻结前通过 `Application.UseAtomUI(...)` 完成注册。主题 builder、attribute、descriptor 和状态中的字符串算法 ID 需要改为 `ThemeAlgorithm` 枚举值。
  - Localization：已移除 `LanguageCode`、`LanguageVariant`、语言 Provider/Pool 和 ThemeManager 语言注册 API，请迁移到 `LanguageTag`、Catalog enum、XLIFF 2.1 资源、`UseLanguages()` 和生成式模块注册。Catalog enum 成员名和 XLIFF unit ID 现在是契约 identity（`ContractVersion = 2`）；应用与静态语言包必须一起重新构建，不能混用原数字 ID Catalog 与新 Key Catalog。
  - Upload：移除 `Upload.IsOpenFileDialogOnClick`，改用 `UploadDropZone.IsOpenFileDialogOnClick` 和 `SourceKind`；以 `AllowedFileTypes` 替代 `Upload.Accepts`；移除旧 drop 事件和仅 URI 文件契约；自定义集成需迁移到强类型 source、input batch、admission 和 completion 契约，并以 `Files` 作为唯一状态所有者。
  - Timeline：新增水平 `Orientation`，以逻辑方向 `Start` / `End` 替代 `TimelineMode.Left` / `Right`，并将 `IndicatorLeftModeMargin` / `IndicatorRightModeMargin` 重命名为 `IndicatorStartModeMargin` / `IndicatorEndModeMargin`。
  - Tag：以 `TagVariant`（`Filled`、`Solid` 或 `Outlined`）替代 `IsBordered`；可选择标签场景请使用新的 `CheckableTag` / `CheckableTagGroup` 选择 API。
  - Separator：`SizeType` 从 `SizeType` 改为 `CustomizableSizeType`，并实现 `ICustomizableSizeTypeAware`；`Custom` 间距由控件实例或其所在样式负责。迁移写法见 [6.1.3 API 变更示例](docs/release-notes/6.1.3-api-changes.zh-CN.md)。
- Calendar 和 DatePicker
  - 新增 Calendar 控件，支持日期、月份和年份视图、Mini/Fullscreen 密度、自定义 Header 和 Cell、周数显示、日程通知、范围条、禁用日期组合、键盘导航及自动化访问。
  - DatePicker 新增可切换 picker 模式以及 `MinDate` / `MaxDate` 范围约束。
- Localization、Generator 和 Build
  - 以生成式 XLIFF 2.1 Catalog、强类型资源扩展、应用 bootstrap 和不可变语言快照替代运行时语言 Provider，同时保留现有 `{atom:XxxLangResource Key}` XAML 用法。
  - 新增静态语言包构建契约、active/dormant 模块生成式注册、verified/deferred 包 manifest、局部覆盖和 Catalog 校验；注册流程不依赖运行时程序集扫描或 XLIFF 解析，并保持 NativeAOT 兼容。
  - 为 AtomUI 各模块新增官方葡萄牙语（巴西）`pt-BR` 语言包，并在 Gallery 中支持语言切换。
- Theme
  - 将主题定义和生成式控件主题 manifest 编译为完整、不可变的根级与局部快照，原子发布主题变化，并按规范化内容 digest 复用等价主题缓存。
  - 对齐 Ant Design Token 语义、完整控件 Token 快照和组合输入控件状态，包括生成式 exact control identity、资源 key 以及 Effective Global/Own Token 访问。
- Upload
  - 将文件选择、目录选择、拖放和程序化输入统一到跨平台准入管线，使用强类型文件 source 所有权、串行批次和确定性终态。
  - 新增目录策略、遍历限制、数量溢出策略和快照错误报告，并统一 picker 与 drop 输入的 `IsMultipleEnabled` 行为。
  - 加固替换、取消、清理和上传进度收尾；已接收 source 会保留到执行退出，任务进入终态后不再更新进度。
- 导航和选择控件
  - Menu 新增 `IsScrollEnabled`，支持可滚动的弹出菜单。
  - NavMenu 新增层级条目组合、可折叠侧边栏 Header，改进内联折叠显示，并在 Items 替换时清理过期选择。
  - Segmented 新增垂直和圆角变体、键盘导航及动态选项加载。
  - OptionButtonGroup 新增垂直布局；Timeline 新增水平布局和逻辑 Start/End/Alternate 放置模式。
- 数据录入、数据展示和通用控件
  - Tag 新增 Filled/Solid/Outlined 变体、预设/状态/自定义颜色处理、CheckableTag 以及支持单选和多选的 CheckableTagGroup。
  - Slider 新增多 Handle 值和单个 Handle 禁用状态。
  - Button 新增 `IconWidth` 和 `IconHeight`；Steps 新增 `ItemHeaderForeground`、`ItemSubHeaderForeground` 和 `ItemRailBackground` 语义样式属性。
  - TextBox 和 TextArea 使用文本 viewport metrics 改进 OverflowTip 判断，恢复 Separator 预设间距，并新增 Gallery Drawer 表单示例。
  - 新增 LunarCalendar，支持农历日期换算、节气、传统节日、节假日/调休标记和可配置的周末高亮。
- Window、DataGrid、Gallery 和依赖
  - 新增 Window 标题栏 add-on facade，并修复 ImagePreviewer 从客户端装饰 overlay 路由工具栏请求的行为。
  - 修复 DataGrid 行重排重置崩溃、集合移动和重排生命周期问题，并减少重排路径中的内存分配。
  - 补充打包版本 Gallery Developer Tools 所需的运行时依赖。
  - Avalonia 从 `12.1.0` 升级到 `12.1.1`；该补丁依赖升级不要求 AtomUI 源码迁移。

最后提交信息为： feat(SearchPanel): implement custom theme for GalleryCodeViewer sea...

v6.1.0

2026-07-20 22:46 v6.1.0 ab2b99f

- 破坏性变更
  - Dialog 和 MessageBox：围绕异步 Session 重建静态展示和宿主生命周期。直接引用 `IDialogHost`、`IDialogHostProvider`、`IDialogActionResult` 或 `IMessageBoxActionResult`，或依赖 callback 式宿主关闭 API 的自定义代码，应迁移到 `ShowDialogAsync`、`ShowDialogModalAsync`、`ShowMessageBoxAsync`、`ShowMessageBoxModalAsync`、`Dialog.OpenAsync`、`Dialog.BeforeCloseAsync` 和返回的 `Task<object?>`。迁移示例见 [6.1.0 API 变更示例](docs/release-notes/6.1.0-api-changes.md)。
  - Steps：将基于 Selection 的契约替换为受控步骤状态。请将 `CurrentStep` 迁移到 `Current`，`InitialStep` 迁移到 `Initial`，`CurrentStepStatus` / `StepsItemStatus` 迁移到 `Status` / `StepsStatus`，`Style` / `ItemIndicatorType` 迁移到 `Type`，`LabelPlacement` 迁移到 `TitlePlacement`，`ProgressValue` / `IsShowItemProgress` 迁移到可空 `Percent`；步骤项描述从 `Description` / `DescriptionTemplate` 迁移到 `Content` / `ContentTemplate`，可点击步骤变更改为处理 `CurrentChangeRequested`，不再依赖 Selection 直接变更。迁移示例见 [6.1.0 API 变更示例](docs/release-notes/6.1.0-api-changes.md)。
- Theme
  - 新增基于 resolver 的主题定义加载能力，支持内置资源、应用资源和显式启用的用户主题目录，并统一使用 XML 主题定义格式。
  - 新增 `IThemeDefinitionResolver`、`IThemeManager.AvailableThemes`、`IThemeManager.CurrentTheme`、`ThemeCatalogDiagnostics`、`ThemeCatalogChanged` 和 `ReloadThemesAsync`，应用可以发现、切换并原子刷新主题 Catalog。
  - 新增 `WithApplicationId`、`UseUserThemeDirectory()` 和 `UseUserThemeDirectory(string directory)`；显式启用时，默认用户主题目录为应用数据目录下的 `{ApplicationId}/Themes`。
  - 重建主题解析、绑定、Catalog 编译、Snapshot 缓存和 Token 资源发布流程，让根主题和局部主题都发布完整 Snapshot，并在解析或编译失败时保留上一版状态。
  - 生成 AXAML 共享控件 Token 资源元数据，并隔离控件 Token 作用域，使 primary、link 和 text button 状态随当前主题稳定变化。
- Gallery 主题
  - 新增 Daybreak Blue、Polar Green、Sunset Orange、Golden Purple 和 Magenta 等内置主题定义，并通过带色块的主题设置子菜单暴露。
  - Gallery 通过 Theme manager 完成主题切换，并为桌面 Gallery 启用用户主题目录加载。
- Window 和 Native
  - 将 Avalonia 依赖升级到 `12.1.0`，并新增原生 Wayland 支持。
  - 稳定 Windows 和 Linux 绘制装饰，包括 Windows 10 CSD frame 渲染、深色主题标题栏、caption 按钮、实时 resize、Wayland 圆角 CSD 裁剪和 Linux client-frame 视觉层。
  - 为 Dialog 和 Drawer overlay 分离完整窗口 mask、可见 frame bounds 和阴影范围，让 mask 覆盖绘制标题栏，同时 placement 保持在可见 frame 内。
- Dialog、Drawer 和 MessageBox
  - 将 Dialog 和 MessageBox 统一到同一套 Session、Presenter 和 Surface 生命周期，覆盖 UI Dispatcher 构造、异步打开/关闭、关闭拦截、owner close 和确定性 teardown。
  - 优化 overlay 与 window presenter 的尺寸、拖动、resize、最大化、mask 路由、焦点恢复、取消和重入行为。
  - 降低 overlay dialog transition 开销。
- 导航和选择控件
  - Steps：新增 `OutlineDot`、受控导航请求事件、确定性的步骤编号/status/connector 语义、pointer click wave 行为，以及用于水平、垂直和导航布局的新 layout panel。
  - Cascader：支持键盘候选导航，并稳定展开、过滤、选中 option 同步和 popup 状态。
  - Menu 和 NavMenu：新增子菜单 hover intent，支持 detached title bar 中的 popup，新增生命周期安全的节点命令，并修复 pointer 或布局变化导致的子菜单状态跳变。
  - Collapse 和 Expander：优化 separator、accordion、内容可见性和 motion cleanup 行为。
- 数据录入、数据显示和通用控件
  - 为 CascaderView、ListView 和 ListBox 新增自定义 EmptyIndicator 支持。
  - 为 TransferItemDecorator 新增 list 和 tree transfer 视图的 item count 处理。
  - 修复 AddOnDecoratedBox 仅模板提供 add-on 内容、模板拥有的 EmbeddedTextBox 输入框、embedded 输入 padding、DatePicker 和 TimePicker 输入尺寸，以及 NumericUpDown 默认输入 padding 覆盖。
  - 移除 ColorPicker spectrum 颜色名称 tooltip，并稳定 ImagePreviewer 搜索和主题资源。
  - 修复 Row/Splitter 布局恢复和精确 grid line 换行问题。
- 反馈和浮层控件
  - Notification：普通通知默认不显示 type icon，对齐关闭按钮 hover/pressed 状态，使用 primary 色生成进度条渐变，将默认自动关闭时长设为 4.5 秒，并缩小内部卡片间距。
  - Tour：修正目标 placement，并为高亮区域添加动画。
- Icons、Gallery、Generator 和文档
  - 新增面向 AI、应用和社交/服务场景的 SVG 图标。
  - 为 Gallery 新增 Windows 渲染 fallback，并刷新 Gallery baseline、生成文档和主题设计文档。
  - 新增 XML 主题绑定、Token 发布和可选控件包使用的生成式主题 schema 与控件 Token 资源元数据。
  - 将包元数据更新到 `6.1.0`。

最后提交信息为： release: add 6.1.0 migration notes and README versions

v6.0.6

2026-06-24 21:02 v6.0.6 c1cb582

## 兼容性说明

多个尺寸感知控件现在使用可自定义尺寸模型，除内置尺寸类型外，也支持 `Custom` 尺寸行为。直接依赖旧尺寸类型契约的项目应检查源码兼容性。

## 新增

- 为 Button 系列、DropdownButton、NumericUpDown、Mentions、Select、TreeSelect、ToggleSwitch、SpinIndicator 及相关尺寸感知控件添加自定义尺寸支持。
- 添加可配置的 Button 图标位置。
- 添加 Slider 桌面控件，并补充文档和 Gallery 展示。
- 添加 `Col.Flex` 支持，并改进 Row/Grid 响应式布局行为。
- 添加可编辑 ComboBox 过滤、候选项键盘导航、Enter/Escape 行为和空结果反馈。
- 添加 NavMenu 键盘导航、激活项反馈和内联折叠模式。
- 添加初始主题算法配置，使应用首帧即可按深色主题渲染。
- 添加可绑定的 TreeView/Cascader 节点或选项支持，面向绑定驱动的数据场景。
- 添加可复用的 GalleryBase 工具包，并集成 Gallery Shell 和路由基础能力。

## 变更

- 改进 Button、SplitButton、LineEdit、SearchEdit、DatePicker、TimePicker、ColorPicker、Select、TreeSelect 等控件的自定义尺寸布局和 Gallery 展示。
- 改进 Form 验证流程，避免提交导向的验证过早显示错误。
- 改进 Collapse 手风琴状态处理、内边距计算和内容可见性行为。
- 改进 Expander 指示器间距、内容可见性和布局行为。
- 改进 Descriptions、Segmented、Steps、ProgressBar、Skeleton、Card、AvatarGroup、Transfer、Upload、Pagination 和 Breadcrumb 的实现结构与正确性。
- 改进 SpinIndicator 动画处理、默认对齐方式和自定义尺寸渲染。
- 改进 RibbonBadge 定位和 Adorner 可见性行为。
- 改进 CompactSpace 内部协作和布局处理。
- 将 Avalonia 依赖从 `12.0.4` 升级到 `12.0.5`。

## 修复

- 修复 DatePicker 和 TimePicker 首选输入宽度计算问题。
- 修复 ListBox/ListView 过滤项状态处理问题。
- 修复 NavMenu 在内联折叠模式下的选中状态保留问题。
- 修复 Gallery AppImage 安装器资源路径。
- 修复 Gallery macOS DMG 工作流，避免使用未使用的 Homebrew taps。
- 修复 Breadcrumb 生成项状态清理和 `IBreadcrumbItemData.Content` 映射问题。

## 文档

- 新增或完善 LineEdit、SearchEdit、ListView、NumericUpDown、Select、Slider、ToggleSwitch、TreeSelect、Descriptions、Expander、Segmented、ProgressBar、Card、Cascader、Form 等桌面控件文档。
- 添加控件优化技能文档，包括 API 布局、文件拆分、生命周期和根因优化规则。
- 更新 Gallery 展示示例，覆盖自定义尺寸、键盘导航和新增文档控件场景。

最后提交信息为： chore(release): update changelog and README for version 6.0.6

v6.0.5

2026-06-19 15:47 v6.0.5 5f67547

- 破坏性变更
  - 响应式布局 API 统一到 `AtomUI.Controls.Shared.MediaQuery`。
  - 新增共享的 `ResponsiveInt`、`ResponsiveDouble`、`ResponsiveGutter` 和 `ResponsiveValueMap` 模型。
  - 新增 `xxxl` 断点以及对应的 `ScreenXXXL` Token 支持。
  - Grid、Descriptions 和 Masonry 现在共用同一套 mobile-first 响应式解析与 fallback 规则。
  - 依赖旧版单控件响应式解析逻辑的自定义代码，尤其是依赖 `DescriptionsMediaBreakInfo` 的代码，需要迁移到共享响应式值类型。
- Gallery
  - 重新设计 Gallery 外壳和 Showcase 页面结构。
  - 新增粘性 Showcase 标签、Showcase 延迟加载、场景诊断和快照标记标准化。
  - 为大部分已迁移的 Showcase 页面新增本地化 API 表格和 Design Token 表格。
  - 将 Browser Gallery 的路由和导航与共享桌面 Gallery 组件对齐。
  - 新增 Gallery 版本展示和社区 Telegram 区块。
- 新控件与布局
  - 新增 BorderBeam，包含几何、色标、Token、Gallery、文档和测试支持。
  - 新增 Masonry，支持响应式列、gutter、加载骨架屏、图片示例、Gallery 覆盖和布局测试。
  - 为 Grid、Descriptions 和 Masonry 新增共享响应式布局支持。
- 桌面控件
  - Button：新增 `Color`、`Variant` 和 `CustomBackground` 支持，包括渐变背景以及更新后的 Gallery/API 文档。
  - NumericUpDown：新增内联 spinner 模式，并改进操作柄样式。
  - ButtonSpinner：改进禁用状态处理，并新增样式变体支持。
  - NavMenu：新增 `ClearSelection`、`IsItemBackgroundEnabled`，并改进选择协调、内联间距和背景行为。
  - TextArea：改进尺寸调整行为。
  - GroupBox：修复背景透明时边框不可见的问题。
  - Pagination：改进分页大小校验，并支持自定义分页大小选项。
  - Dialog 和 Menu：避免关闭/打开流程中的 Dialog 重入，并改进 Menu 关闭行为。
  - HyperLinkButton：使图标颜色跟随前景色。
- NativeAOT、诊断与 DataGrid
  - 强化 NativeAOT 场景下生成的数据成员访问器。
  - 新增 AOT 数据成员路径分析器和编译器诊断规范。
  - 修复 DataGrid 排序路径解析，并新增排序回归测试。
  - 修复 Gallery 设计 Token 表格空状态。
  - 为非可视化 `AvaloniaObject` 使用场景实现作用域化资源宿主和主题宿主，避免动态资源保留导致的内存泄漏。
- 原生窗口与平台稳定性
  - 改进 Linux 窗口初始化、缩放、frame extents、窗口 chrome 管理、popup 支持和标题栏菜单关闭行为。
  - 改进 macOS 标题栏 Logo 可见性。
  - 改进 Windows Win32 composition 选项，提升性能和稳定性。
  - 修正 popup、dialog、标题栏和 Gallery 文案问题。
- 构建与发布
  - 恢复桌面诊断，并稳定生成源码的换行格式。
  - 改进 NativeAOT Gallery 发布流程和验证。
  - 更新 `PublishToLocal.ps1` 的版本提取逻辑，改为使用 `AtomUIVersion`。
  - 更新 AtomUI 6.0 发布定位相关的包元数据。

最后提交信息为： feat(ResponsiveValueParser): refactor parsing methods to use delega...

v5.1.3-build.3

2025-12-16 18:44 v5.1.3-build.3 93c428c

## 更新内容
* Update release gallery script
* Fix PopupBuddyLayer layer offset for macOS
* Fix Select close bug
* Fixed the issue of NavMenu repeatedly applying the default selection.
* Fix NavMenu open and close method bug
* Merge pull request #185 from yaobiao131/release/5.0
* fix: 修复navmenu关闭报错 #162
* Fix List horizontal content default alignment
* Fix TimeLine Label aligment bug
* Fixed an issue where TimeLineItem would freeze after setting IsVisible="False".
* Fix ContextMenu Shadow render bug
* Fix DropdownButton Arrow Bug
* Optimize TabControl Card style
* Fix Window Content CornerRadius bug
* Merge pull request #175 from tuskermanshu/TabUI
* Merge branch 'feature/Image' into release/5.0
* Fix TitleBar Verticel Alignment Bug
* Fix Preview Toobar bug for Windows
* Add ImageGroupPreviewer
* Add Previus and Next nav support
* Fixing progress bar drawing ghosting
* Finish basic image preview control
* Merge pull request #180 from j7-dev/chore/readme
* Doc: 修正 README 体验所有控件 的指令
* refactor HandleScaleDownRequest and HandleScaleUpRequest
* Merge pull request #173 from tuskermanshu/release/5.0
* Finish ImageViewer
* fix(tab): 修复选中后border样式异常问题
* fix(tab-scroll): 统一水平/垂直滚动
* Refactor IconButton
* Fix Window TitleBar double click bug
* Add ImagePreviewer

**完整的更新日志**: https://gitee.com/atomui/atomui/compare/v5.1.3-build.2...v5.1.3-build.3

最后提交信息为： Update release gallery script

v5.1.3-build.2

2025-12-08 16:05 v5.1.3-build.2 16a2d68

最后提交信息为： Fix DataGrid row header bug

v5.1.2

2025-12-04 09:17 v5.1.2 20c0ad6

本次更新主要是完善 Icon 基础设施和 Bug 修复

**新特性**

1. 新增 AtomUI.Icons.Material 图标库
2. 新增 AtomUI.Icons.IconPark 图标库

> [!IMPORTANT]
> 如果要使用 Material 和 IconPark 图标扩展包，请使用 v5.1.2 版本的 AtomUI.Desktop.Controls

![输入图片说明](https://foruda.gitee.com/images/1764811150515491760/4548f06f_10457681.png "")
![输入图片说明](https://foruda.gitee.com/images/1764811164295366574/46103c16_10457681.png "")

用法如下
```xaml
<atom:Window xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:atom="https://atomui.net"
             xmlns:material="https://atomui.net/icons/material"
             xmlns:iconpark="https://atomui.net/icons/iconpark"
             xmlns:antdesign="https://atomui.net/icons/antdesign"
             xmlns:local="using:AtomUIProgressApp"
             x:Class="AtomUIProgressApp.MainWindow"
             Title="AtomUIProgressApp"
             Width="800"
             Height="600"
             x:DataType="local:MainWindow"
             WindowState="Normal"
             WindowStartupLocation="CenterScreen">
    <Panel>
        <StackPanel Orientation="Vertical" Spacing="10" HorizontalAlignment="Center" VerticalAlignment="Center">
            <atom:GroupBox HeaderTitle="Icons" HorizontalAlignment="Center" Padding="20">
                <StackPanel Spacing="10" Orientation="Horizontal">
                    <antdesign:WechatFilled Width="32" Height="32"/>
                    <material:DeviceBluetoothSearchingFilled Width="32" Height="32"/>
                    <iconpark:Cpu IconTheme="Filled" Width="32" Height="32"/>
                </StackPanel>
            </atom:GroupBox>
        </StackPanel>
    </Panel>
</atom:Window>
```

**Bug 修复**
1. 修复 GroupBox 内容间距不正确的问题

**完整的更新日志**: https://gitee.com/chinware/atomui/compare/v5.1.1...v5.1.2

最后提交信息为： Fix GroupBox ContentPadding bug

v5.1.1

2025-11-25 11:13 v5.1.1 a122f7a

最后提交信息为： Fix DatePicker range init state bug

v5.1.0

2025-11-21 08:08 v5.1.0 1b5f1d3

## 更新内容

随着 .NET 10 LTS 的发布和 Avalonia 12 的即将到来，.NET 在移动设备上的性能持续提升，AtomUI 作为跨平台 UI 控件库也需要为此做好准备。经过一次重构，AtomUI OSS 现已为移动端支持扫清了障碍。

我们将为开发者提供移动设备控件开发套件，敬请期待。此外，为了向 Avalonia 和 .NET 致敬，AtomUI Mobile OSS 将继续采用完全免费的商业使用许可。

# 包级别调整

## 包重命名
- `AtomUI` 重构为 `AtomUI.Desktop.Controls`
- `AtomUI.Controls.DataGrid` 重构为 `AtomUI.Desktop.Controls.DataGrid`
- `AtomUI.Controls.ColorPicker` 重构为 `AtomUI.Desktop.Controls.ColorPicker`
- `AtomUI.IconPkg.Generator` 重构为 `AtomUI.Icons.Generator`

## 新引入的包
- 引入 `AtomUI.Core` 作为核心基础包
- 引入 `AtomUI.Fonts.AlibabaSans` 作为默认字体包
- 引入 `AtomUI.Icons.AntDesign` 作为默认图标包

## 包移除与合并
- 移除 `AtomUI.Theme` 包，相关代码合并到 `AtomUI.Core` 包中
- 引入 `AtomUI.Controls.Shared` 作为共享控件包

## 迁移说明
旧的 `AtomUI OSS` 入口包已被弃用。开发者需要引入我们的新包。由于我们目前仅支持桌面平台，当前桌面系列包如下：

- `AtomUI.Desktop.Controls`（主包）
- `AtomUI.Desktop.Controls.DataGrid`（数据表格）
- `AtomUI.Desktop.Controls.ColorPicker`（颜色选择器）

开发者可以根据自己的需求按需引用这些包。

# 初始化调整

为了更好地支持未来手机版本的引入，我们对初始化方法也做了相应的调整。

- `builder.UseOSSControls()` 变更为 `builder.UseDesktopControls()`
- `builder.UseOSSDataGrid()` 变更为 `builder.UseDesktopDataGrid()`
- `builder.UseColorPicker()` 变更为 `builder.UseDesktopColorPicker()`

## 调整后调用例子如下：

```csharp
// 配置 AtomUI 桌面控件
builder.UseDesktopControls();
builder.UseDesktopDataGrid();
builder.UseDesktopColorPicker();
```
<img width="1080" height="641" alt="image" src="https://github.com/user-attachments/assets/7045fa0f-e708-4679-bcac-6a7150c2a7cd" />

# Icon 系统的优化

在我们的开发者社区中，开发者对 Icon 系统的优化呼声是很高的，这次我们一并进行的升级改造。

## 智能补全支持

在老的 Icon 系统使用的时候，开发者在使用的时候没有办法在 IDE 中智能补全，非常不方便，本次重构我们放弃了字符串描述 Icon 种类的落后方式，改造成枚举方式，这样就能智能提示了，大大提升了开发效率。

## 支持第三方 Icon 库

在重构前 AtomUI 的 Icon 基类是直接继承自 Control，所以对于第三方 Icon 集成是非常不方便的，本次优化之后，基类调整为 Avalonia 内置的 PathIcon，理论上只要第三方库也基于 PathIcon 制作图标库，那么是可以在 AtomUI 项目中直接使用的。但是目前 AtomUI OSS 相关控件的 Icon 属性的类型还没有调整为 PathIcon，我们将在后续版本进行统一调整。

**完整的更新日志**: https://gitee.com/chinware/atomui/compare/v5.0.2...v5.1.0

最后提交信息为： Fix Icon Hover bug

v5.0.2

2025-11-17 15:25 v5.0.2 ee17b47

最后提交信息为： Fix unused ref

v5.0.2-build.1

2025-11-07 10:53 v5.0.2-build.1 1fcdddd

最后提交信息为： Release v5.0.2-build.1

v5.0.1

2025-11-03 23:04 v5.0.1 26155cc

最后提交信息为： release v5.0.1

v5.0.1-build.2

2025-10-18 22:28 v5.0.1-build.2 50a995c

最后提交信息为： Release v5.0.1-build.2

v5.0.1-build.1

2025-10-16 21:01 v5.0.1-build.1 1d391bb

最后提交信息为： Release 5.0.1-build.1

v5.0.0

2025-10-15 20:57 v5.0.0 a9a1a84

# AtomUI OSS 5.0.0 发布公告

很高兴宣布 AtomUI OSS 5.0.0 版本正式发布！本次更新为开发者带来了全新的 Steps 控件，优化了 Application 类的控制权，并修复了若干 BUG。

## ✨ 新特性

- **新增 Steps 控件** - 全新的步骤条组件
- **数据表格增强** - 新增操作提示器功能

## ⚡ 优化改进

- **NavMenu 控件重构** - 重写底层结构，支持数据源绑定方式生成导航菜单
- **应用主题管理** - 改用 `IThemeManager` 方式，更好支持 Prism 等框架整合
- **ComboBox 优化** - Popup 支持自定义显示条目数量
- **CircleProgress 增强** - 支持自定义成功和失败图标
- **SelectableTextBlock 优化** - 功能体验提升
- **LoadingIndicator 重构** - 重命名为 `Spin` 并彻底重写

## 🐛 Bug 修复

- 修复苹果系统下编译方法不存在的问题
- 修复点击 DataGrid 行标题报异常问题
- 修复系统字体干扰问题
- 修复 Button 设置斜体字体时部分字母显示不全
- 修复 ColorPicker 关闭后再次打开失效的问题
- 修复 `atom:Window` 的 `IsTitleBarVisible` 属性无效问题

## 🔄 版本说明

开发者可能对版本号从之前版本直接跳到 5.0.0 有所疑惑，这里进行说明：

AtomUI OSS 本质上是 **Ant Design 5.0** 设计语言的 Avalonia/.NET 实现。为了降低开发者的理解成本，从本版本开始 AtomUI OSS 将锚定 Ant Design 的主版本号。

**版本对应关系：**
- AtomUI OSS 5.0 → Ant Design 5.0
- AtomUI OSS 6.0 → Ant Design 6.0  
- AtomUI OSS 7.0 → Ant Design 7.0

以此类推，未来版本将保持与 Ant Design 的版本同步。

**完整的更新日志**: https://gitee.com/chinware/atomui/compare/v1.0.1...v5.0.0

最后提交信息为： fix macos compile bug

v1.0.1

2025-10-02 14:18 v1.0.1 131ea11

最后提交信息为： Release v1.0.1

v1.0.0

2025-09-25 11:37 v1.0.0 3173faf

最后提交信息为： Release v1.0.0

v1.0.0-alpha.4

2025-09-21 14:15 v1.0.0-alpha.4 d29d105

最后提交信息为： Release v1.0.0-alpha.4

v1.0.0-alpha.3

2025-09-17 18:59 v1.0.0-alpha.3 91715a2

## 更新内容
* upgrade to avalonia 11.3.6
* Sync TokenKey generated
* refactor gitattrs
* Merge remote-tracking branch 'origin/feature/modal' into feature/modal
* Optimize for dialog for linux
* Optimize for dialog for linux
* Optimize Window Template for linux
* Fixed TabControl overflow menu bug
* Add Open and Close motion support
* Add motion support for OverlayDialogMask
* Finish Dialog Demo
* Implement Dialog loading keel function
* Refactor Dialog
* Finish MessageBox StyleIcon
* Add DialogButtonBox event supported
* Refactor DialogButtonBox Add Button Text propertyes
* Add DialogButtonBox
* Added nested event loop support to Dialog
* Dialog Completed
* Stripping AtomUI.Native
* Finish OverlayDialog resize
* Finish OverlayDialogHost drag
* Finish Header Button Group
* Add OverlayDialog Maximizable
* Refactor ManagedDialogPositioner
* Reconstruct Demension and add four arithmetic operations
* Add Dimension
* Add ManagedDialogPositionerDialogImplHelper
* Add ManagedDialogPositionerDialogImplHelper
* Add DialogPositionRequest
* Add VisualLayerManager
* Complete the implementation of the Card control
* Add Extra Content support for TabControls
* Add CardGridItem
* Add CardGridContent
* Add Loading support for card
* Refactor TreeViewItem bindings
* Refactor SwitchKnob bindings
* Refactor MarqueeLabel bindings
* Refactor DragPreview bindings
* Refactor DataGrid bindings
* Refactor Collapse bindings
* Refactor CardTabStrip bindings
* Refactor Card bindings
* Refactor Calendar bindings
* Refactor ButtonSpinnerInnerBox bindings
* Refactor ButtonSpinnerHandle bindings
* Refactor Button bindings
* Refactor BaseTabStrip bindings
* Refactor BaseTabControl bindings

**完整的更新日志**: https://gitee.com/chinware/atomui/compare/v1.0.0-alpha.2...v1.0.0-alpha.3

最后提交信息为： upgrade to avalonia 11.3.6

v1.0.0-alpha.2

2025-09-04 00:49 v1.0.0-alpha.2 7f85950

## 更新内容
* Mark tag 1.0.0-alpha.2
* Fix DataGrid filter popup bug
* Merge remote-tracking branch 'origin/release/1.0' into release/1.0
* Fix menu close bug
* Fix ColorPicker ColorPickerPaletteGroup bug
* Fixed Link Button Disable style
* Add ColorPickerPaletteGroup
* Refactor Segmented
* Refactor Collapse
* Add HeaderPadding And ContentPadding for Expander
* Add HeaderPadding And ContentPadding for Collapse
* Refactor ColorPicker Flyout Helper
* Finish Gradient Picker
* Fix ColorPickerView scaling bug
* Add GradientColorSlider
* Add AbstractColorSlider
* Refactor TargetFrameworks config
* Refactor ColorPicker Project
* Add Clear Button for colorview
* Finish ColorPickerInput
* Add ButtonSpinner Handle animation
* Optimize ButtonSpinner Handle
* Optimize ComboBox
* Add EmptyColorMode ColorBlock
* Finish ColorSliderThumb
* Add ColorSliderThumb
* Fix datagrid menu filter bug
* Refactor TabStripItem
* Optimize Menu ContextMenu close
* Merge branch 'release/1.0' into develop
* Refactor DataGrid Bindings
* Refactor IconPresenter Bindings
* Refactor TimePicker Bindings
* Refactor TimePicker Bindings
* Refactor TabControl Bindings
* Refactor TabControl Bindings
* Refactor Segmented Bindings
* Refactor ProgressBar Bindings
* Refactor PopupConfirm Bindings
* Refactor PaginationNav Bindings
* Refactor OptionButtonGroup Bindings
* Refactor WindowNotificationManager Bindings
* Refactor NavMenu Bindings
* Refactor WindowMessageManager Bindings
* Refactor Menu Bindings
* Refactor LoadingMaskHost Bindings
* Refactor ListBox bindings
* Refactor SearchEditDecoratedBox Bindings
* Refactor Flyout Bindings
* Refactor Draw Bindings

**完整的更新日志**: https://gitee.com/chinware/atomui/compare/v1.0.0-alpha...v1.0.0-alpha.2

最后提交信息为： Mark tag 1.0.0-alpha.2

GVPAtomUI / AtomUI

搜索帮助

GVP AtomUI / AtomUI