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.xaml中Application.SplashScreen已声明(MAUI 模板默认已配); - 启动图资源放在
Platforms/Windows/Assets/SplashScreen.png(推荐 1280×720 或按比例缩放); - 在
App.xaml.cs的OnInitialized或OnLaunched中,调用Microsoft.UI.Xaml.Window.Current.Content = new MainPage();后,SplashScreen 会自动隐藏;如需手动控制,可通过WindowHelper.GetWindowForCurrentView().Content = ...触发。
统一隐藏逻辑(可选增强)
如果你希望在 MAUI 页面加载完成后才真正“结束”启动流程(比如等数据初始化完),可以加一层过渡控制:
- 在
App.xaml.cs的OnInitialized中不立即设置MainPage,而是先设为一个空ContentPage或占位页; - 在后台完成初始化(如读配置、检查登录态)后,再切换
Application.Current.MainPage = new MainPage(); - 部分平台(如 Android)需注意避免 SplashActivity 过早关闭导致白屏,建议用
Handler.PostDelayed确保 UI 线程安全。
基本上就这些。关键不是写多少 C# 代码,而是理解各平台启动图的本质——它是原生系统在应用进程启动初期渲染的一张静态图,MAUI 只负责衔接好这个过程。配对资源尺寸、命名规范、主题/Storyboard 绑定,比写逻辑更重要。










