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中定义主题:
<style name="SplashTheme" parent="Theme.AppCompat.Light.NoActionBar">
<item name="android:windowBackground">@drawable/splash_background</item>
<item name="android:windowNoTitle">true</item>
<item name="android:windowFullscreen">true</item>
</style>
在 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 绑定,比写逻辑更重要。
