如何为.NET MAUI创建带后台启动逻辑的自定义启动屏？

1. 默认MauiSplashScreen的显示时机与运行逻辑 #

默认的MauiSplashScreen是平台原生层处理的启动屏，在你的.NET MAUI托管代码（比如App类、AppShell）启动之前就会显示。它本质是通过项目文件配置，生成对应平台的原生启动资源（Android的Launch Screen、iOS的Launch Image等），不属于托管代码范畴，所以你在App构造函数中看不到它的运行痕迹。

2. 在主界面显示前添加启动任务的实现方案 #

默认原生启动屏无法绑定任务进度或执行自定义逻辑，要实现“启动屏显示期间运行任务”，需要通过自定义过渡页+后台任务的方式：

步骤1：修改App类，先加载过渡页并启动后台任务 #

public partial class App : Application
{
    public App()
    {
        InitializeComponent();
        // 先显示自定义启动过渡页
        MainPage = new SplashLoadingPage();
        // 后台异步执行启动任务
        _ = RunStartupTasksAsync();
    }

    private async Task RunStartupTasksAsync()
    {
        // 这里替换为实际启动任务：初始化数据库、加载配置、请求接口等
        await Task.Delay(2000); // 模拟耗时操作
        await InitializeDatabaseAsync();
        await LoadAppSettingsAsync();

        // 任务完成后切换到主界面
        MainPage = new AppShell();
    }

    private Task InitializeDatabaseAsync()
    {
        // 数据库初始化逻辑
        return Task.CompletedTask;
    }

    private Task LoadAppSettingsAsync()
    {
        // 应用配置加载逻辑
        return Task.CompletedTask;
    }
}

步骤2：创建自定义启动过渡页 #

这个页面可以完全模仿默认启动屏的样式，还能添加进度条等动态元素：

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="YourAppNamespace.SplashLoadingPage"
             BackgroundColor="#512BD4"> <!-- 和默认启动屏底色保持一致 -->
    <VerticalStackLayout VerticalOptions="Center" HorizontalOptions="Center">
        <!-- 使用默认启动屏的图片 -->
        <Image Source="Resources/Splash/splash.svg" WidthRequest="128" HeightRequest="128"/>
        <!-- 可选：添加进度条显示任务进度 -->
        <ProgressBar x:Name="loadingProgress" WidthRequest="200" Margin="0,20,0,0" Progress="0"/>
        <Label Text="加载中..." TextColor="White" Margin="0,10,0,0"/>
    </VerticalStackLayout>
</ContentPage>

如果需要更新进度，在过渡页后台添加方法：

public partial class SplashLoadingPage : ContentPage
{
    public SplashLoadingPage()
    {
        InitializeComponent();
    }

    // 供外部调用更新加载进度
    public void UpdateProgress(double progress)
    {
        MainThread.BeginInvokeOnMainThread(() =>
        {
            loadingProgress.Progress = progress;
        });
    }
}

然后在启动任务中调用更新：

private async Task RunStartupTasksAsync()
{
    var splashPage = MainPage as SplashLoadingPage;
    
    await Task.Delay(500);
    splashPage?.UpdateProgress(0.2);
    
    await InitializeDatabaseAsync();
    splashPage?.UpdateProgress(0.5);
    
    await LoadAppSettingsAsync();
    splashPage?.UpdateProgress(0.8);
    
    await Task.Delay(300);
    splashPage?.UpdateProgress(1.0);
    
    MainPage = new AppShell();
}

步骤3：优化启动过渡体验（可选） #

为了避免默认原生启动屏和自定义过渡页之间的闪烁，建议让自定义过渡页的样式（底色、图片）和默认MauiSplashScreen完全一致。如果不需要原生启动屏，也可以直接移除项目文件中的<MauiSplashScreen>配置，但不推荐——原生启动屏是系统层面的，能避免应用启动初期的空白窗口。

3. 默认MauiSplashScreen的自定义限制 #

默认的MauiSplashScreen仅支持配置图片、底色、基础尺寸等静态属性，因为它是生成平台原生资源，而非托管代码控件，无法添加交互或动态内容。如果需要实现带任务进度、自定义布局的启动屏，必须使用上述自定义过渡页的方案。

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