Uno Platform 跨平台 UI 框架技术调研

Uno Platform 让 .NET 开发者用 WinUI 3 / XAML 语法编写 UI，编译到 iOS、Android、WebAssembly、Windows、macOS 和 Linux。它是 「一套 XAML，多端原生或 WASM」 路线，特别适合已有 UWP/WinUI 资产或微软技术栈的企业。2026 年活跃迭代，与 MAUI 互补：MAUI 偏移动端原生，Uno 偏 WinUI API 复用与 Skia 渲染一致性。

一、 基本信息

二、 技术定位与简介

Uno 在非 Windows 平台通过 Skia 或原生桥接实现 WinUI 控件树，在浏览器端编译为 .NET WebAssembly。与 .NET MAUI 的关键差异：

Uno 也提供 Uno.Extensions、Uno.Toolkit 与 Uno Platform Studio 可视化工具。

三、 快速上手安装说明

# 安装模板
dotnet new install Uno.Templates
 
# 创建多目标应用
dotnet new unoapp -o MyUnoApp
cd MyUnoApp
 
# 运行 Windows 头
dotnet run --framework net9.0-desktop
 
# 运行 WASM（需浏览器）
dotnet build -t:Run -f net9.0-browserwasm

XAML 示例

<Page x:Class="MyUnoApp.MainPage"
      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
  <StackPanel Padding="20" Spacing="8">
    <TextBlock Text="Hello Uno" FontSize="24" />
    <Button Content="Click" Click="OnClick" />
  </StackPanel>
</Page>

四、 核心特性

1. WinUI API 跨平台

Grid、NavigationView、InfoBar 等控件跨端行为一致化。

2. WebAssembly 端

同一套 XAML 编译为 WASM，无需 WebView 套壳即可浏览器运行。

3. Skia 渲染后端

非 Windows 平台像素级一致，减少原生控件差异。

4. 单项目多 Head

Desktop、Mobile、Web 共享 Shared 项目，Head 项目仅平台入口。

5. Hot Reload

XAML 与 C# 热重载加速 UI 迭代（平台支持矩阵见文档）。

6. 第三方图表/地图

SkiaSharp、Mapsui、LiveCharts2 与 Uno 集成成熟。

7. Material Design 主题

Uno.Material 提供 Material 3 控件样式，弥补非 Windows 平台设计规范。

8. 多窗口与折叠屏

WinUI 3.1+ 多窗口 API 在 Uno Desktop 逐步对齐，适合平板与折叠设备。

五、 适用场景

适合：UWP/WinUI 迁移 Web+桌面+移动、企业内部工具需浏览器交付、像素级 UI 一致、C# 团队不愿学 Flutter。

不适合：纯前端 React 团队、极致移动端手势体验（选 Flutter/RN）、不需要 Windows/Web 的纯移动 App（MAUI 更轻）。

六、 技术亮点

1. WinUI 资产复用——Windows 商店应用可扩到 Web/移动。
2. 真 WASM——非 WebView，适合内网零安装部署。
3. Skia 一致渲染——设计稿跨端偏差小。
4. 活跃开源——GitHub 周迭代，Uno Platform 5/6 持续演进。
5. Studio 工具——Figma → XAML、预览器降低设计落地成本。

七、 核心概念与架构

digraph Uno_Arch {
  rankdir=TB
  node [shape=box, style="rounded,filled", fillcolor="#f0f9ff"]
  XAML [label="XAML + C#\n(Shared Project)", fillcolor="#bae6fd"]
  Uno [label="Uno.UI Runtime"]
  Skia [label="Skia Renderer"]
  Win [label="Windows WinUI"]
  WASM [label="WebAssembly"]
  Mobile [label="iOS / Android"]
 
  XAML -> Uno
  Uno -> Skia
  Uno -> Win
  Skia -> WASM
  Skia -> Mobile
}

关键概念：App 生命周期、Frame 导航、DependencyProperty、<x:Bind> 编译绑定、#if __WASM__ 条件编译。

八、 技术局限与边界

1. 包体积（WASM）：.NET WASM 首次加载较大，需 AOT/裁剪与懒加载优化。
2. 移动端生态：插件数量少于 MAUI；App Store 审核需验证 Skia 渲染性能。
3. 学习曲线：需理解 WinUI 布局（Grid 行列）、视觉状态管理器。
4. 原生能力：相机、蓝牙等常需 Android/iOS 特定项目或社区插件。
5. 调试复杂度：五端矩阵 CI 成本高。
6. 与 MAUI 重叠：微软官方主推 MAUI 移动，Uno 社区支持为主。

九、 生态地图

• 官方：Uno.Toolkit UI、Uno.Extensions（导航、Hosting、Reactive）。
• 图表：LiveCharts2、OxyPlot.Skia。
• MVVM：CommunityToolkit.Mvvm、Prism（社区）。
• 设计：Uno Platform Studio、Figma 插件。
• 商业：Uno Platform Enterprise 支持合同。
• 测试：Uno.UITest、WinAppDriver（Windows）、Appium（移动）。
• 部署：WASM 可托管 Azure Static Web Apps；移动走商店标准流程。

十、 生态集成

十一、 开发与工程化

• 使用 dotnet new unoapp 默认结构，勿手动混用 MAUI 与 Uno 控件。
• UnoCheck 工具验证开发环境完整性。
• WASM 开启 Interpreter vs AOT 权衡构建时间与运行时性能。
• 资源图片放 Assets 并按密度提供 scale-200 等多倍图。
• 建立 net9.0-* 条件编译常量文档，避免魔法字符串。

十二、 性能与安全

• WASM：启用 <WasmShellILLinker> 裁剪；懒加载 Assembly 分包。
• 移动端：列表用 ItemsRepeater 虚拟化；避免过深视觉树。
• 敏感配置不进 XAML 资源；WASM 注意任何密钥对前端可见。
• CSP 与 cross-origin 配置保护 WASM 静态托管。
• 使用 Uno.UI.Runtime.WebAssembly 性能分析工具定位布局耗时。

十三、 技术对比

十四、 最佳实践

1. UWP 迁移先跑 Uno Migration Guide。
2. 设计系统用 ResourceDictionary 与 ThemeResource，禁止硬编码颜色。
3. WASM 首屏设加载进度与 <link rel=preload> .NET 运行时。
4. 移动端手势与返回键行为单独测试，Skia 路径与原生导航栏交互。
5. 关注 Uno Platform 与 WinUI 3 版本对齐表，避免 API 不存在。

十五、 学习与社区资源

• 官方文档：https://platform.uno/docs/
• GitHub 示例：https://github.com/unoplatform/Uno.Samples
• Uno Platform Studio：https://platform.uno/uno-platform-studio/
• Discord 社区：https://platform.uno/discord
• Uno Blog：https://platform.uno/blog/