天天看点

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

1. 前言

距离上次发《​​MAUI初体验:爽​​》一文已经过去2个月了,本计划是下半年或者明年再研究MAUI的,现在计划提前啦,因为我觉得MAUI Blazor挺有意思的:在Android、iOS、macOS、Windows之间共享UI,一处UI增加或者修改,就能得到一致的UI体验。

看看这篇文章《Blazor Hybrid/MAUI 简介和实战》对MAUI Blazor的说明:

MAUI

.NET 多平台应用程序 UI (.NET MAUI) 是一个跨平台框架,用于使用 C# 和 XAML 创建本机移动和桌面应用程序, 使用 .net MAUI,可以开发可在 Android、iOS、macOS 上运行的应用,Windows 以及从单个共享代码库运行的应用。

Blazor Hybrid 应用和 .NET MAUI

Blazor Hybrid 支持内置于 .NET 多平台应用 UI (.NET MAUI) 框架。 .NET MAUI 包含 BlazorWebView 控件,该控件运行将 Razor 组件呈现到嵌入式 Web View 中。 通过结合使用 .NET MAUI 和 Blazor,可以跨移动设备、桌面设备和 Web 重复使用一组 Web UI 组件。

今天就分享如何在Blazor Server、Blazor Wasm、MAUI Blazor之间共享UI的实验,这一步完成,后面开发应用时就方便多了(只针对UI修改)。

2. 先来体验下各端最终效果

  • Blazor Server:​​http://server.dotnet9.com/​​
  • Blazor Wasm:​​http://wasm.dotnet9.com/​​
  • MAUI(Android\Windows\macOS):​​https://github.com/dotnet9/Dotnet9/tree/develop/src/Dotnet9.MAUI(源码自行编译)​​

Windows桌面、Blazor Server(在线)、Blazor Wasm(在线)、Android效果

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

iPad Air、iOS、macOS桌面效果

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

MAUI各端未做发布文件体验(需要做相应平台的发布签名等操作),大家可以按下面介绍的方法创建项目编译体验一下。

iOS和macOS效果感谢​​青城同学​​提供的图片素材,站长mbp安装了最新的macOS,xCode也是最新的,可能因为预览版macOS原因,xCode无法打开,间接影响了maui编译?

macOS版本和xCode版本

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

xCode为不可用状态

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

VS编译出错,后面再解决

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

用mbp的同学建议不要安装预览版操作系统,不要当勇士....

3. 新建项目

关于MAUI的环境搭建可参考这篇文章《​​在MAUI中使用Masa Blazor​​》,本文不再介绍环境搭建,直接使用VS 2022最新预览版项目模板创建项目。

3.1 创建Blazor Server项目:Dotnet9.Server

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

3.2 创建Blazor WebAssembly项目:Dotnet9.Wasm

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

3.3 创建MAUI Blazor项目:Dotnet9.MAUI

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

3.4 查找共同点

在3个项目的上一层目录,打开PowerShell,输入​

​tree /f​

​查看详细的目录文件组织结构:

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

仔细查看三个模板项目文件结构,我们找出共同的文件查看:

文件夹 PATH 列表
卷序列号为 76F5-AF62
C:.
│  Dotnet9.sln
│
├─Dotnet9.MAUI
【1 这里省略数个文件】
│  │
│  ├─Data
│  │      WeatherForecast.cs
│  │      WeatherForecastService.cs
│  │
│  ├─Pages
│  │      Counter.razor
│  │      FetchData.razor
│  │      Index.razor
【2 这里省略数个文件】
│  │
│  ├─Shared
│  │      MainLayout.razor
│  │      MainLayout.razor.css
│  │      NavMenu.razor
│  │      NavMenu.razor.css
│  │      SurveyPrompt.razor
【3 这里省略数个文件】
│
├─Dotnet9.Server
│  │  App.razor
【4 这里省略数个文件】
│  │
│  ├─Data
│  │      WeatherForecast.cs
│  │      WeatherForecastService.cs
│  │
│  ├─Pages
│  │      Counter.razor
│  │      Error.cshtml
│  │      Error.cshtml.cs
│  │      FetchData.razor
│  │      Index.razor
│  │      _Host.cshtml
│  │      _Layout.cshtml
│  │
│  ├─Properties
│  │      launchSettings.json
│  │
│  ├─Shared
│  │      MainLayout.razor
│  │      MainLayout.razor.css
│  │      NavMenu.razor
│  │      NavMenu.razor.css
│  │      SurveyPrompt.razor
【5 这里省略数个文件】
│
└─Dotnet9.Wasm
【6 这里省略数个文件】
    │
    ├─Pages
    │      Counter.razor
    │      FetchData.razor
    │      Index.razor
    │
    ├─Properties
    │      launchSettings.json
    │
    ├─Shared
    │      MainLayout.razor
    │      MainLayout.razor.css
    │      NavMenu.razor
    │      NavMenu.razor.css
    │      SurveyPrompt.razor
【7 这里省略数个文件】      

发现都有​

​Data​

​​目录和​

​Pages​

​​目录(其中Wasm项目没有Data目录,使用的示例类是直接写在​

​FetchData.razor​

​​文件​

​@code{}​

​中的),那把这部分文件直接提取到类库中就可以了,那就做吧。

4. 提取UI到Razor类库

创建Razor类库:Dotnet9.WebApp

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

下面开始UI的提取

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

如上图,将​

​Dotnet9.MAUI​

​​项目的​

​Data​

​​、​

​Pages​

​​、​

​Shared​

​​三个目录外加​

​Main.razor​

​​文件剪切到​

​Dotnet9.WebApp​

​​项目中,然后修改剪切后相应文件的命名空间​

​Dotnet9.MAUI[xxx]​

​​为​

​Dotnet9.WebApp[xxx]​

​​,打开​

​Dotnet9.WebApp​

​​项目的​

​_Import.razor​

​​文件,参考​

​Dotnet9.MAUI​

​​项目的​

​_Import.razor​

​文件部分命名空间,修改如下:

@using System.Net.Http
@using Microsoft.AspNetCore.Authorization
@using Microsoft.AspNetCore.Components.Forms
@using Microsoft.AspNetCore.Components.Routing
@using Microsoft.AspNetCore.Components.Web
@using Microsoft.AspNetCore.Components.Web.Virtualization
@using Microsoft.JSInterop
@using Dotnet9.WebApp
@using Dotnet9.WebApp.Shared      

上面部分命名空间可以删除(未尝试),编译​

​Dotnet9.WebApp​

​项目,检查是否正确编译。

5. 各端项目修改

5.1 MAUI项目

  1. 添加​

    ​Dotnet9.WebApp​

    ​项目引用
  2. ​Program.cs​

    ​​中​

    ​using Dotnet9.MAUI.Data;​

    ​​改为​

    ​using Dotnet9.WebApp.Data​

  3. 删除​

    ​Data​

    ​​、​

    ​Pages​

    ​​、​

    ​Shared​

    ​​三个目录外加​

    ​Main.razor​

    ​文件,上一步是剪切的话这步省略
  4. 修改​

    ​_Imports.razor​

    ​​文件,主要是添加​

    ​Dotnet9.WebApp​

    ​项目命名空间引用
@using System.Net.Http
@using Microsoft.AspNetCore.Components.Forms
@using Microsoft.AspNetCore.Components.Routing
@using Microsoft.AspNetCore.Components.Web
@using Microsoft.AspNetCore.Components.Web.Virtualization
@using Microsoft.JSInterop
@using Dotnet9.MAUI
@using Dotnet9.WebApp
@using Dotnet9.WebApp.Shared      
  1. ​MauiProgram.cs​

    ​​修改引用的命名空间:​

    ​using Dotnet9.MAUI.Data;​

    ​​ =>​

    ​using Dotnet9.WebApp.Data;​

  2. 打开​

    ​MainPage.xaml​

    ​,对路由组件命名空间的引用修改

添加命名空间​

​xmlns:webApp="clr-namespace:Dotnet9.WebApp;assembly=Dotnet9.WebApp"​

​,修改代码如下:

修改前:

<RootComponent Selector="#app" ComponentType="{x:Type local:Main}" />      

修改后:

<RootComponent Selector="#app" ComponentType="{x:Type webApp:Main}" />      

修改完毕,编译运行​

​Dotnet9.MAUI​

​​项目吧,接下来修改​

​Dotnet9.Server​

​项目。

5.2 Blazor Server项目

  1. 添加​

    ​Dotnet9.WebApp​

    ​项目引用
  2. ​Program.cs​

    ​​中​

    ​using Dotnet9.Server.Data;​

    ​​改为​

    ​using Dotnet9.WebApp.Data;​

  3. 删除​

    ​Data​

    ​目录
  4. 删除​

    ​Pages​

    ​​目录中的​

    ​Counter.razor​

    ​​、​

    ​FetchData.razor​

    ​​、​

    ​Index.razor​

    ​​三个文件(包括同名的​

    ​.cs​

    ​​、​

    ​.css​

    ​文件)
  5. 删除​

    ​Shared​

    ​目录
  6. 修改​

    ​_Imports.razor​

    ​​文件,主要是添加​

    ​Dotnet9.WebApp​

    ​项目命名空间引用
@using System.Net.Http
@using Microsoft.AspNetCore.Authorization
@using Microsoft.AspNetCore.Components.Authorization
@using Microsoft.AspNetCore.Components.Forms
@using Microsoft.AspNetCore.Components.Routing
@using Microsoft.AspNetCore.Components.Web
@using Microsoft.AspNetCore.Components.Web.Virtualization
@using Microsoft.JSInterop
@using Dotnet9.Server
@using Dotnet9.WebApp
@using Dotnet9.WebApp.Shared      
  1. 打开​

    ​./Pages/_Host.cshtml​

    ​​文件,添加命名空间引用​

    ​@using Dotnet9.WebApp​

    ​,修改代码如下:

修改前:

<component type="typeof(App)" render-mode="ServerPrerendered" />      

修改后:

<component type="typeof(Main)" render-mode="ServerPrerendered" />      

修改完毕,编译运行​

​Dotnet9.Server​

​​项目吧,接下来修改​

​Dotnet9.Wasm​

​项目。

5.3 Blazor Wasm项目

  1. 添加​

    ​Dotnet9.WebApp​

    ​项目引用
  2. 删除​

    ​Pages​

    ​​、​

    ​Shared​

    ​​目录外加​

    ​App.razor​

    ​文件
  3. ​Program.cs​

    ​​中​

    ​using Dotnet9.Wasm;​

    ​​改为​

    ​using Dotnet9.WebApp;​

    ​,同时修改代码

修改前

builder.RootComponents.Add<App>("#app");      

修改后

builder.RootComponents.Add<Main>("#app");      
  1. 修改​

    ​_Imports.razor​

    ​​文件,主要是添加​

    ​Dotnet9.WebApp​

    ​项目命名空间引用
@using System.Net.Http
@using Microsoft.AspNetCore.Authorization
@using Microsoft.AspNetCore.Components.Authorization
@using Microsoft.AspNetCore.Components.Forms
@using Microsoft.AspNetCore.Components.Routing
@using Microsoft.AspNetCore.Components.Web
@using Microsoft.AspNetCore.Components.Web.Virtualization
@using Microsoft.JSInterop
@using Dotnet9.Server
@using Dotnet9.WebApp
@using Dotnet9.WebApp.Shared      

修改完毕,编译运行​

​Dotnet9.Wasm​

​项目,至此三种项目模板已经修改完成,最终解决方案如下图:

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI

6 总结

总结就是下图:

MAUI与Blazor共享一套UI,媲美Flutter,实现Windows、macOS、Android、iOS、Web通用UI
  • Dotnet9.WebApp:blazor组件相关的代码、路由组件等放在这个工程,供其他项目引用
  • Dotnet9.Server:Blazor Server模板项目
  • Dotnet9.Wasm:Blazor WebAssembly项目
  • Dotnet9.MAUI:MAUI Blazor项目
  • 本文代码地址:​​https://github.com/dotnet9/Dotnet9​​
  1. ​​ASP.NET Community Standup - Native client apps with Blazor Hybrid​​
  2. ​​Blazor一份代码在Blazor WebAssembly和Blazor Server之间任意切换​​
  3. ​​微软MAUI文档​​
  4. ​​微软Blazor文档​​
  5. ​​学Blazor​​