MAUI與Blazor共享一套UI，媲美Flutter，實現Windows、macOS、Android、iOS、Web通用UI

2022 年 6 月 21 日
筆記
Blazor, Blazor Client, Blazor Server, blazor wasm, c#, maui, MAUI Blazor, 前端

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：//server.dotnet9.com/
Blazor Wasm：//wasm.dotnet9.com/
MAUI(Android\Windows\macOS)：//github.com/dotnet9/Dotnet9/tree/develop/src/Dotnet9.MAUI（源碼自行編譯）

Windows桌面、Blazor Server(在線）、Blazor Wasm(在線）、Android效果

iPad Air、iOS、macOS桌面效果

MAUI各端未做發佈文件體驗（需要做相應平台的發佈簽名等操作），大家可以按下面介紹的方法創建項目編譯體驗一下。

iOS和macOS效果感謝青城同學提供的圖片素材，站長mbp安裝了最新的macOS，xCode也是最新的，可能因為預覽版macOS原因，xCode無法打開，間接影響了maui編譯？

macOS版本和xCode版本

xCode為不可用狀態

VS編譯出錯，後面再解決

用mbp的同學建議不要安裝預覽版操作系統，不要當勇士….

3. 新建項目

關於MAUI的環境搭建可參考這篇文章《在MAUI中使用Masa Blazor》，本文不再介紹環境搭建，直接使用VS 2022最新預覽版項目模板創建項目。

3.1 創建Blazor Server項目：Dotnet9.Server

3.2 創建Blazor WebAssembly項目：Dotnet9.Wasm

3.3 創建MAUI Blazor項目：Dotnet9.MAUI

3.4 查找共同點

在3個項目的上一層目錄，打開PowerShell，輸入tree /f查看詳細的目錄文件組織結構：

仔細查看三個模板項目文件結構，我們找出共同的文件查看：

文件夾 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

下面開始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項目

添加Dotnet9.WebApp項目引用
Program.cs中using Dotnet9.MAUI.Data;改為using Dotnet9.WebApp.Data
刪除Data、Pages、Shared三個目錄外加Main.razor文件，上一步是剪切的話這步省略
修改_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

MauiProgram.cs修改引用的命名空間：using Dotnet9.MAUI.Data; => using Dotnet9.WebApp.Data;
打開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項目

添加Dotnet9.WebApp項目引用
Program.cs中using Dotnet9.Server.Data;改為using Dotnet9.WebApp.Data;
刪除Data目錄
刪除Pages目錄中的Counter.razor、FetchData.razor、Index.razor三個文件（包括同名的.cs、.css文件）
刪除Shared目錄
修改_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

打開./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項目

添加Dotnet9.WebApp項目引用
刪除Pages、Shared目錄外加App.razor文件
Program.cs中using Dotnet9.Wasm;改為using Dotnet9.WebApp;，同時修改代碼

修改前

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

修改後

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

修改_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項目，至此三種項目模板已經修改完成，最終解決方案如下圖：

6 總結

總結就是下圖：

Dotnet9.WebApp：blazor組件相關的代碼、路由組件等放在這個工程，供其他項目引用
Dotnet9.Server：Blazor Server模板項目
Dotnet9.Wasm：Blazor WebAssembly項目
Dotnet9.MAUI：MAUI Blazor項目

一句話：將UI封裝到Razor類庫Dotnet9.WebApp，其他終端工程(Dotnet9.Server、Dotnet9.MAUI、Dotnet9.Wasm)引用此工程即可實現UI共享。

本文代碼地址：//github.com/dotnet9/Dotnet9
原文：//dotnet9.com/2022/06/Share-razor-library-between-maui-and-blazor-server-or-client

參考

Tags: Blazor Blazor Client Blazor Server blazor wasm c# maui MAUI Blazor 前端