AtomUI 跨平台深度解析Windows、macOS、Linux 原生集成的秘密【免费下载链接】AtomUIAn enhancement and extension library for Avalonia, bringing the Ant Design design language, modern controls, theming, native integrations, and cross-platform UI capabilities to .NET desktop apps.项目地址: https://gitcode.com/gh_mirrors/at/AtomUIAtomUI 是一个基于 Avalonia 构建的跨平台桌面 UI 控件库将 Ant Design 设计语言带入 .NET 世界让你用一套代码同时发布到 Windows、macOS 与 Linux 三大桌面平台。它不只是能跑在三个系统上这么简单——AtomUI 为每个平台都做了深度的原生集成Windows 的 DWM 暗色标题栏、macOS 的红绿灯按钮精确重排、Linux 的 X11 窗口几何与阴影点击穿透全部由底层原生 API 直接驱动。本文将带你拆解这套跨平台原生集成的完整思路。一套代码三条原生路径AtomUI 的跨平台架构AtomUI 的跨平台能力建立在 Avalonia 之上而它的真正杀手锏是位于 src/AtomUI.Native/ 的原生桥接层。这个模块按平台严格分目录组织Windows/Win32 APIP/InvokeMacOS/Objective-C Runtime直接操作 Cocoa 窗口对象Linux/XCB / X11 与 Wayland 协议支持上层代码从不关心现在跑在哪个系统。所有能力统一收口在 WindowExtensions.cs 中——它根据运行时操作系统自动路由到对应的平台实现。架构细节可参考 docs/architecture/foundations/runtime-platforms.md。Windows 原生集成DWM 暗色模式与 DPI 精准适配 ✦Windows 平台的实现在 WindowUtils.Windows.cs亮点有三个DWM 标题栏暗色模式调用DwmSetWindowAttribute让系统标题栏跟随 AtomUI 的深色主题自动变暗并根据 Windows 版本自动选择正确的属性常量新旧系统全兼容DPI 感知的边框度量Windows 11 直接读取 DWM 可见边框厚度旧系统回退到 DPI 感知的系统指标高分屏上自定义标题栏依然像素级对齐鼠标事件穿透通过WS_EX_TRANSPARENT窗口扩展样式让窗口的透明阴影区域看穿鼠标点击直接落到下层窗口。Windows 平台的 Gallery 还配有完整的 WiX 安装向导体验macOS 原生集成直接编排红绿灯按钮macOS 的实现WindowUtils.MacOS.cs走 Objective-C Runtime 路线能直接拿到NSWindow对象并操作它的标准窗口按钮精确测量读取 close / miniaturize / zoom 三个按钮的 frame自动算出按钮总宽度和自定义标题栏内容应有的左侧偏移保证标题栏文字永不与按钮重叠智能重排把三个按钮按 AppKit 原生 20pt 间距重新布局并可垂直居中到你自定义的扩展标题栏中真实标题栏高度用窗口总高度减去contentLayoutRect内容区域高度得到精确的系统标题栏尺寸缩放指示控制按设计需要显隐右下角的 resize 手柄。macOS 端同样提供官方 DMG 安装包拖拽即装支持 macOS 11Big Sur及以上版本Linux 原生集成X11 几何控制与 Wayland 并行Linux 的实现WindowUtils.Linux.cs解决的是 Linux 窗口管理最棘手的几个问题初始窗口几何通过 X11 的XSizeHints一次性下发位置、尺寸与最小/最大约束避免启动时的尺寸抖动CSD 装饰范围上报写入_GTK_FRAME_EXTENTS属性让 MutterGNOME与 KWinKDE在窗口吸附、最大化时正确扣除客户端自绘边框实现贴边不留缝阴影点击穿透基于 XCB SHAPE 扩展裁剪输入区域视觉上柔和的窗口阴影不再挡住下层窗口的鼠标Wayland 兼容WaylandWindowUtils.cs 单独提供 Wayland 环境下的窗口能力适配。三平台 Native AOT 发布连运行时都编译成原生代码 跨平台的最后一块拼图是发布。AtomUI Gallery 演示应用在三个平台都支持.NET Native AOT——把整个托管代码直接编译为机器码产物里没有coreclr.dll冷启动更快、内存更省。平台发布 RID工具链要求产物形态Windowswin-x64.NET SDK Visual Studio C workload约 59 MB 单个 exeLinuxlinux-x64.NET SDK clang/gcc zlib约 57 MB ELF 可执行文件macOSosx-x64/arm64.NET SDK 平台链接器原生可执行文件Windows 与 Linux 的完整发布流程、常见报错与排障清单分别在 windows-native-aot-publish.md 和 linux-native-aot-publish.md 中有详细的维护手册平台总览见 docs/engineering/platforms/overview.md。新手起步三步跑通 AtomUI 跨平台应用引入控件包在你的 Avalonia 项目中引用AtomUI.Desktop.Controls调用UseDesktopControls()完成注册自由编排像使用 Ant Design 一样使用 Button、Table、DatePicker、Modal 等控件主题系统自动适配三大平台一键发布切换-r目标win-x64/osx-arm64/linux-x64同一份代码库即可产出三个平台的原生安装包。总结AtomUI 的跨平台深度在于它没有停留在画布相同的层面而是深入到每个操作系统的窗口子系统Windows 的 DWM、macOS 的 Cocoa、Linux 的 X11/Wayland 都获得了专门的原生桥接再叠加三平台 Native AOT 发布能力真正做到一套代码、原生体验。如果你正在寻找一个既能快速搭建现代桌面界面、又不牺牲平台原生质感的 .NET UI 控件库AtomUI 值得一试。【免费下载链接】AtomUIAn enhancement and extension library for Avalonia, bringing the Ant Design design language, modern controls, theming, native integrations, and cross-platform UI capabilities to .NET desktop apps.项目地址: https://gitcode.com/gh_mirrors/at/AtomUI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AtomUI 跨平台深度解析：Windows、macOS、Linux 原生集成的秘密
AtomUI 跨平台深度解析Windows、macOS、Linux 原生集成的秘密【免费下载链接】AtomUIAn enhancement and extension library for Avalonia, bringing the Ant Design design language, modern controls, theming, native integrations, and cross-platform UI capabilities to .NET desktop apps.项目地址: https://gitcode.com/gh_mirrors/at/AtomUIAtomUI 是一个基于 Avalonia 构建的跨平台桌面 UI 控件库将 Ant Design 设计语言带入 .NET 世界让你用一套代码同时发布到 Windows、macOS 与 Linux 三大桌面平台。它不只是能跑在三个系统上这么简单——AtomUI 为每个平台都做了深度的原生集成Windows 的 DWM 暗色标题栏、macOS 的红绿灯按钮精确重排、Linux 的 X11 窗口几何与阴影点击穿透全部由底层原生 API 直接驱动。本文将带你拆解这套跨平台原生集成的完整思路。一套代码三条原生路径AtomUI 的跨平台架构AtomUI 的跨平台能力建立在 Avalonia 之上而它的真正杀手锏是位于 src/AtomUI.Native/ 的原生桥接层。这个模块按平台严格分目录组织Windows/Win32 APIP/InvokeMacOS/Objective-C Runtime直接操作 Cocoa 窗口对象Linux/XCB / X11 与 Wayland 协议支持上层代码从不关心现在跑在哪个系统。所有能力统一收口在 WindowExtensions.cs 中——它根据运行时操作系统自动路由到对应的平台实现。架构细节可参考 docs/architecture/foundations/runtime-platforms.md。Windows 原生集成DWM 暗色模式与 DPI 精准适配 ✦Windows 平台的实现在 WindowUtils.Windows.cs亮点有三个DWM 标题栏暗色模式调用DwmSetWindowAttribute让系统标题栏跟随 AtomUI 的深色主题自动变暗并根据 Windows 版本自动选择正确的属性常量新旧系统全兼容DPI 感知的边框度量Windows 11 直接读取 DWM 可见边框厚度旧系统回退到 DPI 感知的系统指标高分屏上自定义标题栏依然像素级对齐鼠标事件穿透通过WS_EX_TRANSPARENT窗口扩展样式让窗口的透明阴影区域看穿鼠标点击直接落到下层窗口。Windows 平台的 Gallery 还配有完整的 WiX 安装向导体验macOS 原生集成直接编排红绿灯按钮macOS 的实现WindowUtils.MacOS.cs走 Objective-C Runtime 路线能直接拿到NSWindow对象并操作它的标准窗口按钮精确测量读取 close / miniaturize / zoom 三个按钮的 frame自动算出按钮总宽度和自定义标题栏内容应有的左侧偏移保证标题栏文字永不与按钮重叠智能重排把三个按钮按 AppKit 原生 20pt 间距重新布局并可垂直居中到你自定义的扩展标题栏中真实标题栏高度用窗口总高度减去contentLayoutRect内容区域高度得到精确的系统标题栏尺寸缩放指示控制按设计需要显隐右下角的 resize 手柄。macOS 端同样提供官方 DMG 安装包拖拽即装支持 macOS 11Big Sur及以上版本Linux 原生集成X11 几何控制与 Wayland 并行Linux 的实现WindowUtils.Linux.cs解决的是 Linux 窗口管理最棘手的几个问题初始窗口几何通过 X11 的XSizeHints一次性下发位置、尺寸与最小/最大约束避免启动时的尺寸抖动CSD 装饰范围上报写入_GTK_FRAME_EXTENTS属性让 MutterGNOME与 KWinKDE在窗口吸附、最大化时正确扣除客户端自绘边框实现贴边不留缝阴影点击穿透基于 XCB SHAPE 扩展裁剪输入区域视觉上柔和的窗口阴影不再挡住下层窗口的鼠标Wayland 兼容WaylandWindowUtils.cs 单独提供 Wayland 环境下的窗口能力适配。三平台 Native AOT 发布连运行时都编译成原生代码 跨平台的最后一块拼图是发布。AtomUI Gallery 演示应用在三个平台都支持.NET Native AOT——把整个托管代码直接编译为机器码产物里没有coreclr.dll冷启动更快、内存更省。平台发布 RID工具链要求产物形态Windowswin-x64.NET SDK Visual Studio C workload约 59 MB 单个 exeLinuxlinux-x64.NET SDK clang/gcc zlib约 57 MB ELF 可执行文件macOSosx-x64/arm64.NET SDK 平台链接器原生可执行文件Windows 与 Linux 的完整发布流程、常见报错与排障清单分别在 windows-native-aot-publish.md 和 linux-native-aot-publish.md 中有详细的维护手册平台总览见 docs/engineering/platforms/overview.md。新手起步三步跑通 AtomUI 跨平台应用引入控件包在你的 Avalonia 项目中引用AtomUI.Desktop.Controls调用UseDesktopControls()完成注册自由编排像使用 Ant Design 一样使用 Button、Table、DatePicker、Modal 等控件主题系统自动适配三大平台一键发布切换-r目标win-x64/osx-arm64/linux-x64同一份代码库即可产出三个平台的原生安装包。总结AtomUI 的跨平台深度在于它没有停留在画布相同的层面而是深入到每个操作系统的窗口子系统Windows 的 DWM、macOS 的 Cocoa、Linux 的 X11/Wayland 都获得了专门的原生桥接再叠加三平台 Native AOT 发布能力真正做到一套代码、原生体验。如果你正在寻找一个既能快速搭建现代桌面界面、又不牺牲平台原生质感的 .NET UI 控件库AtomUI 值得一试。【免费下载链接】AtomUIAn enhancement and extension library for Avalonia, bringing the Ant Design design language, modern controls, theming, native integrations, and cross-platform UI capabilities to .NET desktop apps.项目地址: https://gitcode.com/gh_mirrors/at/AtomUI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考