Maui.Plugins.PageResolver使用教程

---

项目介绍

Maui.Plugins.PageResolver 是一个专为 .NET MAUI 设计的轻量级页面解析插件，旨在简化导航过程并支持依赖注入（DI），无需依赖完整的MVVM框架。本插件尤其适用于希望实现简单页面路由，或者正在采用MVU（Model-View-Update）模式的开发人员。通过调用 await Navigation.PushAsync<MyPage>()，即可轻松完成带有视图模型和依赖项的完全解析页面导航。

• 特性：
  • 简单易用的页面解析。
  • 支持依赖注入配置。
  • 参数化导航能力。
  • 自动服务注册源码生成器（.NET 8版本独有）。
  • 支持生命周期管理自定义。

项目快速启动

要迅速启动并运行Maui.Plugins.PageResolver，遵循以下步骤：

1. 安装插件： 在你的.NET MAUI项目中，通过NuGet包管理器安装Maui.Plugins.PageResolver。

   Install-Package Maui.Plugins.PageResolver
   

2. 配置依赖关系： 在你的应用程序启动时配置页面解析和服务依赖，通常在Main方法或MauiProgram.CreateMauiApp中。

   using Maui.Plugins.PageResolver;
   
   public static MauiApp CreateMauiApp()
   {
       var builder = MauiApp.CreateBuilder();
       builder
           .UseMauiApp<App>()
           .Services.AddTransient<MainPage>()
           .Services.AddTransient<MainViewModel>()
           .Services.AddSingleton<IDefaultScopedService, DefaultScopedService>()
           .Services.AddTransient<ICustomScopedService, CustomScopedService>()
           .UsePageResolver(new Dictionary<Type, Type>
           {
               { typeof(MainPage), typeof(MainViewModel) }
           });
   
       return builder.Build();
   }
   

3. 进行导航： 在你的代码中使用简洁的导航命令，例如从视图模型或页面事件中。

   await Navigation.PushAsync<YourTargetPage>();
   

如果需要参数化导航，可以这样做：

await Navigation.PushAsync<MyPage>(new MyPageParameter("paramValue"));

对于ViewModel参数（仅限.NET 8及以上版本）：

await Navigation.PushAsync<MyPage>(new MainViewModel { Parameter = "value" });

应用案例和最佳实践

示例应用结构

• 创建视图模型类（如MainViewModel）和对应的视图页面（如MainPage）。
• 在服务集合中注册这些类型，确保依赖注入生效。
• 使用源代码生成器自动处理依赖注册（.NET 8版特色）以减少手动配置。
• 在初始化阶段调用.UsePageResolver配置ViewModel到页面的映射。

最佳实践

• 清晰分离关注点：保持视图模型纯净，只处理业务逻辑。
• 利用依赖注入：确保所有依赖都是通过构造函数注入，便于测试和管理生命周期。
• 参数化导航：利用参数化导航提供灵活的数据传递方式，提升代码可读性和复用性。

典型生态项目

虽然本插件是专门为.NET MAUI设计的，但它在构建高度模块化且依赖注入友好的MAUI应用中扮演着关键角色。与其他依赖注入容器和MVVM库协同工作时，可以增强应用的架构灵活性和维护性，特别适合那些希望保持代码轻量化，但又不希望牺牲导航复杂度控制的开发者。

---

以上就是Maui.Plugins.PageResolver的基本使用指南。通过它，你可以高效地管理.NET MAUI中的页面导航和依赖关系，使项目更加整洁和易于维护。