Prism.Maui 中 NavigationPage 使用问题解析与解决方案

问题背景

在使用 Prism.Maui 9.0.401-pre 版本时，开发者可能会遇到一个常见的启动错误："System.ArgumentException: Page to remove must be contained on this Navigation Page"。这个错误通常发生在应用启动时，特别是当开发者尝试注册并使用 NavigationPage 进行导航时。

问题分析

这个问题的根源在于 Prism.Maui 框架内部对 NavigationPage 的特殊处理机制。与传统的 Xamarin.Forms 不同，Prism.Maui 实际上使用的是自定义的 PrismNavigationPage 而非标准的 NavigationPage。

当开发者按照传统方式注册 NavigationPage 时：

cr.RegisterForNavigation<NavigationPage>();

框架内部会产生冲突，导致页面移除时出现异常，因为 Prism 期望使用的是它自己的导航页面实现。

解决方案

1. 移除 NavigationPage 的显式注册

最简单的解决方案是完全移除对 NavigationPage 的注册代码。Prism.Maui 已经内置了对导航页面的支持，不需要开发者显式注册。

prism.RegisterTypes(cr =>
{
    // 不需要这行代码
    // cr.RegisterForNavigation<NavigationPage>();
    cr.RegisterForNavigation<MainPage>();
});

2. 导航语法保持不变

尽管移除了 NavigationPage 的注册，导航语法可以保持不变，仍然可以使用：

var result = await navigation.NavigateAsync($"/{nameof(NavigationPage)}/{nameof(MainPage)}");

3. 样式设置的正确方式

对于需要自定义 NavigationPage 样式的开发者，需要注意 Prism 使用的是派生自 NavigationPage 的 PrismNavigationPage。有两种方式可以正确应用样式：

方式一：使用 ApplyToDerivedTypes

<Style TargetType="NavigationPage" ApplyToDerivedTypes="True">
    <Setter Property="BarBackgroundColor" Value="{DynamicResource NavigationBarColour}" />
    <Setter Property="BarTextColor" Value="{DynamicResource NavigationBarTextColour}" />
</Style>

方式二：直接针对 PrismNavigationPage

<Style TargetType="prism:PrismNavigationPage">
    <Setter Property="BarBackgroundColor" Value="{DynamicResource NavigationBarColour}" />
    <Setter Property="BarTextColor" Value="{DynamicResource NavigationBarTextColour}" />
</Style>

技术原理

Prism.Maui 对导航系统进行了深度定制，主要出于以下几个考虑：

1. 功能扩展：Prism 需要在基础导航功能上添加如导航服务、区域导航等高级功能
2. 生命周期控制：提供更精细的页面生命周期管理
3. 一致性保证：确保在不同平台上的行为一致性

这种设计虽然带来了轻微的学习曲线，但为开发者提供了更强大和灵活的导航控制能力。

最佳实践建议

1. 避免直接注册 NavigationPage，让 Prism 管理导航栈
2. 使用 Prism 提供的导航服务进行所有导航操作
3. 对于样式定制，优先考虑使用 ApplyToDerivedTypes 方式
4. 在需要深度定制时，可以继承 PrismNavigationPage 而非标准 NavigationPage

总结

Prism.Maui 对导航系统的封装是其框架设计的核心部分。理解这一设计理念可以帮助开发者避免常见的导航相关错误，并充分利用 Prism 提供的强大导航功能。通过遵循上述解决方案和最佳实践，开发者可以构建出既稳定又具有丰富导航功能的 MAUI 应用程序。