- A+
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(AndroidWindowsmacOS):https://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共享。
- 本文代码地址:https://github.com/dotnet9/Dotnet9
- 原文:https://dotnet9.com/2022/06/Share-razor-library-between-maui-and-blazor-server-or-client
参考