MAUI Android项目如何设置Shell启动页？避免启动页面切换闪烁

你遇到的问题是因为Loaded事件触发时，Shell已经完成初始化并显示了第一个ShellContent（Page1），后续的GoToAsync会导致页面跳转的闪屏。以下是几种直接显示目标页面的方案：

方案一：动态构建ShellContent（推荐） #

不在XAML中预先定义ShellContent，而是根据Preferences的设置在代码中动态添加，确保第一个添加的就是目标页面：

1. 在AppShell.xaml中定义页面的DataTemplate资源：

<Shell xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
       xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
       xmlns:local="clr-namespace:YourAppNamespace"
       x:Class="YourAppNamespace.AppShell">
    <Shell.Resources>
        <DataTemplate x:Key="Page1Template">
            <local:Page1 />
        </DataTemplate>
        <DataTemplate x:Key="Page2Template">
            <local:Page2 />
        </DataTemplate>
    </Shell.Resources>
</Shell>

2. 在AppShell.xaml.cs的构造函数中动态添加ShellContent：

public AppShell()
{
    InitializeComponent();

    bool startWithPage2 = Preferences.Default.Get("StartPage2", false);

    // 添加目标页面作为第一个ShellContent
    var initialContent = new ShellContent
    {
        Title = startWithPage2 ? "Page2" : "Page1",
        ContentTemplate = (DataTemplate)Resources[startWithPage2 ? "Page2Template" : "Page1Template"],
        Route = startWithPage2 ? "Page2" : "Page1"
    };
    Items.Add(initialContent);

    // 添加另一个页面
    var secondaryContent = new ShellContent
    {
        Title = startWithPage2 ? "Page1" : "Page2",
        ContentTemplate = (DataTemplate)Resources[startWithPage2 ? "Page1Template" : "Page2Template"],
        Route = startWithPage2 ? "Page1" : "Page2"
    };
    Items.Add(secondaryContent);
}

这种方式下，Shell初始化时会直接加载第一个添加的页面，完全避免跳转闪屏。

方案二：设置Shell的CurrentItem #

如果希望保留XAML中的ShellContent定义，可以通过设置CurrentItem直接指定初始显示的页面，利用Dispatcher确保在Shell初始化完成后执行：

public AppShell()
{
    InitializeComponent();

    bool startWithPage2 = Preferences.Default.Get("StartPage2", false);
    var targetContent = startWithPage2 
        ? Items.OfType<ShellContent>().First(c => c.Route == "Page2") 
        : Items.OfType<ShellContent>().First(c => c.Route == "Page1");

    // 延迟到UI线程空闲时执行，避免初始化阶段报错
    Dispatcher.DispatchAsync(() =>
    {
        CurrentItem = targetContent;
    });
}

为什么直接在InitializeComponent后调用GoToAsync会报错？ #

因为InitializeComponent完成后，Shell的内部导航框架还未完全初始化，此时调用GoToAsync会因为导航上下文未就绪而抛出异常。使用Dispatcher延迟执行或动态构建ShellContent，都能避开这个初始化时序问题。

内容的提问来源于stack exchange，提问作者Vadim Rapp