MAUI怎么实现一个Splash Screen MAUI启动画面配置

MAUI启动画面依赖各平台原生机制:Android用SplashActivity和主题配置,iOS/macOS用LaunchScreen.storyboard,Windows用SplashScreen元素;统一隐藏逻辑可通过App.xaml.cs控制。

MAUI 实现启动画面(Splash Screen)主要靠平台原生配置,因为 MAUI 本身不提供跨平台的 SplashScreen 控件——它依赖 Android、iOS、macOS 和 Windows 各自的启动图机制。核心思路是:在原生项目中设置启动图资源 + 配置启动 Activity / Scene / Window,再用 MAUI 的 App.xaml.cs 或生命周期事件控制“何时隐藏”。

Android:配置启动 Activity 和主题

Android 是最典型的场景。你需要一个专用的 SplashActivity 作为启动入口,并通过主题指定背景图。

  • Platforms/Android/Resources/values/styles.xml 中定义主题:
  • Resources/drawable/ 下新建 splash_background.xml(用 `` 包裹图片或颜色,适配不同屏幕);
  • Platforms/Android/MainActivity.cs 上方添加 [Activity(Theme = "@style/SplashTheme", ...)],并确保 LaunchMode = LaunchMode.SingleTop
  • OnCreate 中调用 base.OnCreate(savedInstanceState) 后立即跳转到主 Activity(如 StartActivity(typeof(MainActivity))),再 Finish() 关闭 Splash 页面。

iOS/macOS:使用 LaunchScreen.storyboard

iOS 和 macOS 使用 Storyboard 做启动图,无需代码逻辑,纯配置。

  • 打开 Platforms/iOS/LaunchScreen.storyboard(若不存在可新建),拖入 ImageView 或约束布局,设置图片为 Assets.xcassets 中的启动图资源;
  • 确保 Info.plist 中的 UILaunchStoryboardName 指向 LaunchScreen
  • macOS 类似,在 Platforms/MacCatalyst/Assets.xcassets 添加启动图,并在 Info.plist 设置 NSAppIcon 和启动配置(macOS 启动图实际是窗口首次显示前的静态图,靠 Application.Windows[0].Show(); 触发时机控制)。

Windows:用 SplashScreen 元素 + 启动延迟控制

Windows(WinUI3)支持内置 SplashScreen API,MAUI 会自动启用,但需注意资源路径和隐藏时机。

  • 确保 Platforms/Windows/App.xamlApplication.SplashScreen 已声明(MAUI 模板默认已配);
  • 启动图资源放在 Platforms/Windows/Assets/SplashScreen.png(推荐 1280×720 或按比例缩放);
  • App.xaml.csOnInitializedOnLaunched 中,调用 Microsoft.UI.Xaml.Window.Current.Content = new MainPage(); 后,SplashScreen 会自动隐藏;如需手动控制,可通过 WindowHelper.GetWindowForCurrentView().Content = ... 触发。

统一隐藏逻辑(可选增强)

如果你希望在 MAUI 页面加载完成后才真正“结束”启动流程(比如等数据初始化完),可以加一层过渡控制:

  • App.xaml.csOnInitialized 中不立即设置 MainPage,而是先设为一个空 ContentPage 或占位页;
  • 在后台完成初始化(如读配置、检查登录态)后,再切换 Application.Current.MainPage = new MainPage()
  • 部分平台(如 Android)需注意避免 SplashActivity 过早关闭导致白屏,建议用 Handler.PostDelayed 确保 UI 线程安全。

基本上就这些。关键不是写多少 C# 代码,而是理解各平台启动图的本质——它是原生系统在应用进程启动初期渲染的一张静态图,MAUI 只负责衔接好这个过程。配对资源尺寸、命名规范、主题/Storyboard 绑定,比写逻辑更重要。