AtomUI

本文资源均来自互联网，仅供学习交流使用，请于24小时内删除

项目介绍

AtomUI 基于 Avalonia 强大的跨平台能力，实现了 Ant Design 在 .NET 体系下的设计系统，致力于将其精致的设计语言和高效的用户体验带入跨平台桌面应用开发领域。

项目详情

更新日志 · 提交Bug · 提交需求

文档语言: English | 简体中文

介绍

AtomUI 是面向 Avalonia/.NET 桌面应用的 Ant Design 6 组件体系，目标是把 Ant Design 的企业级交互模式、
视觉语言、设计 Token 和主题定制能力带到 Windows、macOS、Linux 原生跨平台应用中。

项目提供面向生产场景的桌面控件、图标包、字体包、原生窗口集成、DataGrid、ColorPicker，以及用于自定义控件、
Token 和本地化开发的源代码生成器。欢迎提交 Issue、PR 和改进建议。

特性

• 将 Ant Design 6 的交互体验和视觉体系适配到原生 Avalonia 桌面应用。
• 提供覆盖布局、导航、数据录入、反馈、数据展示等场景的开箱即用控件，并按需提供 DataGrid、ColorPicker 等高级包。
• 基于 Avalonia 样式与资源系统实现 Token 驱动的主题能力，便于在应用级统一定制视觉风格。
• 使用统一的 .NET/XAML 开发模型支持 Windows、macOS、Linux 跨平台桌面应用。
• 提供自定义控件、主题 Token、本地化相关的源代码生成能力，减少重复基础设施代码。

运行环境

.NET 8 及其以上（构建 AtomUI MSBuild 集成需要 .NET 10 SDK）
Avalonia 12.1.2
支持 Windows、macOS、Linux 跨平台

最新版本说明

AtomUI 6.2.1 将 Pagination 的可见页码窗口与快速跳页行为对齐 Ant Design，新增自定义 page-size changer 模板，
并修复 Menu 子菜单生命周期、反馈层叠、Steps 布局和 Gallery 预览。本版本把 Pagination 导航容器池从 11 个调整为
9 个；升级前请阅读 6.2.1 API 迁移指南和
更新日志。

感谢通明湖中心孵化 AtomUI OSS

感谢 Gitee 对 AtomUI 的认可

中文社区

目前我们提供 QQ 和微信开发者交流群，欢迎对 AtomUI 或 Avalonia 感兴趣的开发者扫码加入：

PS：扫码请注明来意，比如：学习 AtomUI 或 Avalonia 爱好者。

开始使用

AtomUI 推荐通过 NuGet 安装。先安装主桌面控件包，再根据应用需要按需添加 DataGrid、ColorPicker、Extras 等可选包。
下面示例使用当前项目最新版本。

目前我们已经发布的包如下：

dotnet add package AtomUI.Desktop.Controls --version 6.2.1
dotnet add package AtomUI.Desktop.Controls.DataGrid --version 6.2.1
dotnet add package AtomUI.Desktop.Controls.ColorPicker --version 6.2.1
dotnet add package AtomUI.Desktop.Controls.Extras --version 6.2.1

您也可以在 IDE 的 NuGet 包管理器中安装。以 Rider 为例，可以依次点击：

NuGet -> 软件包

搜索 AtomUI，即可找到可用包，并按项目需要安装。

安装前请查看包详情中的“框架”和“依赖”，确认目标框架与 Avalonia 版本兼容。

启用 AtomUI 库

配置项目文件

WinExe
net8.0
enable
enable
true
app.manifest

配置程序入口文件

using Avalonia;
using System;
using AtomUI;
using ReactiveUI.Avalonia;

namespace AtomUIProgressApp;

internal class Program
{
[STAThread]
public static void Main(string[] args) => BuildAvaloniaApp()
.StartWithClassicDesktopLifetime(args);

public static AppBuilder BuildAvaloniaApp()
{
return AppBuilder.Configure()
.UseReactiveUI()
.UseAtomUIPlatformDetect()
.WithAtomUIDefaultOptions()
.WithDeveloperTools()
.LogToTrace();
}
}

在 Application 类中启用 AtomUI

using AtomUI;
using AtomUI.Desktop.Controls;
using AtomUI.Localization;
using AtomUI.Theme;
using Avalonia;
using Avalonia.Markup.Xaml;

public partial class App : Application
{
public override void Initialize()
{
AvaloniaXamlLoader.Load(this);

this.UseAtomUI(builder =>
{
builder.UseLanguages(
LanguageTags.ZhCN,
[LanguageTags.EnUS, LanguageTags.ZhCN, LanguageTags.ZhTW]);
builder.WithDefaultTheme(IThemeManager.DEFAULT_THEME_ID);
builder.UseAlibabaSansFont();
builder.UseDesktopControls();
builder.UseDesktopColorPicker();   // 可选
builder.UseDesktopDataGrid();      // 可选
builder.UseDesktopExtras();        // 可选
});
}
}

开始使用 AtomUI

注册 AtomUI 后，可以直接在 XAML 中使用 AtomUI 控件和 Ant Design 图标。

开始使用
在 GitHub 上点赞

体验所有控件

您可以在本机启动 Gallery 项目，浏览 AtomUI 控件、典型用法、示例和生成文档。

git clone https://github.com/AtomUI/AtomUI.git
cd AtomUI
dotnet run --project controlgallery/AtomUIGallery.Desktop/AtomUIGallery.Desktop.csproj

小的示例项目

Gallery 项目覆盖面较完整。如果您希望先看更小的入门项目，可以前往：

AtomUI/AtomUI.Examples

这些示例展示了更紧凑的应用搭建方式，更适合作为新项目起点。

赞助商

SophNet 提供稳定高效的 AI 模型 API 平台，帮助开发者快速接入大模型能力。

火数云提供云服务器、高防与 GPU 算力服务，支持企业安全、可靠地完成业务上云。

致谢

Ant Design

Ant Design 是由蚂蚁集团推出的企业级 UI 设计语言和 React 组件库。它提供了一套高质量、统一的 React 组件，包含丰富的预设主题与国际化支持，致力于提升企业级应用的设计和开发效率。其优雅的设计和出色的开发体验，使其成为中后台项目中最流行的前端解决方案之一。

Avalonia OSS

Avalonia 是一个跨平台的 .NET UI 框架，使用 XAML 语言设计界面。它支持 Windows、macOS、Linux、iOS 和 Android 等多个平台，提供与 WPF 相似的开发体验。凭借其高性能的渲染引擎和丰富的控件库，Avalonia 能够帮助企业快速构建现代化的桌面和移动应用程序。

许可证说明

使用 AtomUI OSS 的项目需要遵循 LGPL v3 协议。商业应用，包括公司内部项目、个人商业项目和外包项目，
在使用已发布二进制包链接的情况下可以免费使用。如果基于源码定制 AtomUI，则需要按协议开放修改代码，
或购买商业授权。商业授权请联系：北京秦派软件科技有限公司。

🤝 贡献

欢迎各界人士贡献各种资源，如果您对贡献代码感兴趣，请随意查看我们的 GitHub 问题页面，让我们见识一下您的实力。

⬇️ 下载地址

下载后请先检查文件完整性，如有问题请在评论区反馈