Uno Platform项目实战：从零创建支持UWP和WASM的跨平台解决方案

Uno Platform项目实战：从零创建支持UWP和WASM的跨平台解决方案

uno 项目地址: https://gitcode.com/gh_mirrors/uno/Uno

前言

在现代化应用开发中，跨平台能力已成为刚需。Uno Platform作为一款强大的跨平台框架，允许开发者使用单一代码库构建可在Windows、WebAssembly(WASM)、Android、iOS等多平台运行的应用程序。本文将详细介绍如何从零开始创建一个支持UWP和WASM的Uno Platform解决方案。

环境准备

在开始之前，请确保已安装以下工具：

• .NET SDK（建议使用最新稳定版）
• Visual Studio 2022（推荐安装Uno Platform工作负载）
• Node.js（用于WASM开发）

创建Uno解决方案

1. 安装Uno模板

首先需要通过.NET CLI安装Uno Platform的项目模板：

dotnet new -i Uno.Templates

这个命令会安装Uno Platform提供的各种项目模板，包括基础应用模板、类库模板等。

2. 生成解决方案

接下来，我们可以创建一个仅包含UWP和WASM平台支持的基础解决方案：

dotnet new unoapp -o TimeEntryUno -android=false -macos=false -ios=false --skia-wpf=false --skia-gtk=false --skia-tizen=false

参数说明：

• -o TimeEntryUno：指定解决方案名称
• -android=false等参数：禁用不需要的平台支持

这个命令会生成一个包含以下项目的解决方案：

1. 共享代码项目（包含通用业务逻辑和UI）
2. UWP平台特定项目
3. WASM平台特定项目

项目结构解析

生成的解决方案包含几个关键项目：

1. 共享项目：包含应用的核心逻辑和UI定义

   • 使用XAML定义用户界面
   • 包含ViewModel和业务逻辑
   • 可跨所有平台共享

2. UWP项目：Windows平台特定实现

   • 处理平台特定功能
   • 包含应用清单和启动配置

3. WASM项目：WebAssembly平台特定实现

   • 包含Web启动配置
   • 处理Web平台特定逻辑

更新NuGet包

为确保项目稳定性和功能完整性，建议更新以下关键NuGet包到最新稳定版：

1. 在Visual Studio中打开解决方案
2. 右键解决方案 → 选择"管理解决方案的NuGet包"
3. 在更新选项卡中，选择以下包进行更新：
   • Uno.Core
   • Uno.WinUI（或Uno.UI）
   • Uno.WinUI.DevServer
   • Uno.WinUI.WebAssembly
   • Uno.Wasm.Bootstrap
   • Uno.Wasm.Bootstrap.DevServer

重要提示：不要更新Microsoft.Extensions.Logging.Console和Microsoft.Extensions.Logging.Filter包，因为这些包的最新版本可能不兼容WebAssembly平台。

集成WinUI 2.5

WinUI是微软提供的现代化UI框架，Uno Platform对其有良好的支持。以下是集成步骤：

1. 添加NuGet包

为UWP项目添加Microsoft.UI.XamlNuGet包（至少2.5版本）：

1. 右键UWP项目 → 管理NuGet包
2. 搜索并安装Microsoft.UI.Xaml

2. 配置资源字典

在App.xaml或AppResources.xaml中添加WinUI资源：

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls" />
            <!-- 其他合并的资源字典 -->
        </ResourceDictionary.MergedDictionaries>
        <!-- 其他应用资源 -->
    </ResourceDictionary>
</Application.Resources>

3. 更新目标平台版本

将UWP项目的目标版本和最低版本至少设置为Windows 10 1903（10.0; Build 19041）：

1. 右键UWP项目 → 属性
2. 在"应用程序"选项卡中更新目标版本

如果下拉列表中看不到所需版本，需要通过Visual Studio安装器安装对应的Windows SDK。

开发建议

1. 共享代码最大化：尽可能将代码放在共享项目中
2. 平台特定代码隔离：使用条件编译或依赖注入处理平台差异
3. 渐进式迁移：如果是从现有项目迁移，建议逐步替换模块
4. UI适配：注意不同平台的UI/UX差异，确保一致的用户体验

下一步

完成基础解决方案创建后，接下来需要考虑应用导航架构的设计。合理的导航设计对于构建可维护的跨平台应用至关重要，特别是在从Silverlight等传统技术迁移时。

通过以上步骤，您已经成功创建了一个支持UWP和WASM平台的Uno Platform解决方案基础架构，为后续的功能开发和迁移工作打下了坚实基础。

uno 项目地址: https://gitcode.com/gh_mirrors/uno/Uno