.NET MAUI 应用生命周期通过App.xaml.cs中Application类的OnStart、OnResume、OnSleep事件管理:OnStart在首次启动或从终止恢复时触发;OnResume在从前台返回时调用;OnSleep在进入后台时执行,但无可靠退出事件,需注意跨平台差异及避免阻塞操作。

在 .NET MAUI 中,应用生命周期管理主要通过 App.xaml.cs 中的 Application 类及其事件来实现,核心是监听启动、进入前台、退到后台、暂停、恢复、终止等状态变化。
关键生命周期事件及触发时机
.NET MAUI 应用在不同平台(iOS、Android、Windows、macOS)底层机制不同,但 MAUI 统一抽象出以下常用事件:
-
OnStart():应用首次启动或从完全终止状态被打开时调用(对应 Android 的
OnCreate/ iOS 的DidFinishLaunching) -
OnResume():应用从后台回到前台时调用(如用户切换回本 App,对应 Android 的
OnResume/ iOS 的WillEnterForeground) -
OnSleep():应用进入后台或系统即将挂起时调用(对应 Android 的
OnPause/ iOS 的DidEnterBackground)
注意:没有单独的“退出/关闭”事件。iOS 和 Android 系统不保证应用被彻底终止前一定会回调 OnSleep;Windows/macOS 更接近传统桌面行为,但也不提供可靠“退出中”钩子。
在 App 类中重写生命周期方法
直接在 App.xaml.cs 的继承自 Application 的类中重写对应方法即可:
public partial class App : Application
{
public App()
{
InitializeComponent();
MainPage = new AppShell();
}
protected override void OnStart()
{
// 应用启动:可初始化推送、检查登录态、启动后台服务
Debug.WriteLine("App started");
}
protected override void OnResume()
{
// 前台恢复:可刷新数据、重连 WebSocket、恢复播放
Debug.WriteLine("App resumed");
}
protected override void OnSleep()
{
// 后台休眠:应释放非必要资源、保存用户进度、暂停动画或音频
Debug.WriteLine("App sleeping");
}
}
跨平台差异与注意事项
不同平台对生命周期事件的触发逻辑和可靠性有差异:
- Android 上
OnSleep在 ActivityonPause时触发,但若用户通过“最近任务”清掉应用,可能不会触发 - iOS 上
OnSleep对应DidEnterBackground,但 App 可能在几秒后被系统挂起甚至终止,无额外回调 - Windows/macOS 没有严格“后台”概念,
OnSleep和OnResume触发频率较低,主要响应窗口最小化/激活 - 不要在
OnSleep中执行耗时或阻塞操作(如网络请求、大文件写入),系统可能直接终止进程
进阶:监听平台原生事件(按需)
若需更细粒度控制(例如监听 Android 的 OnNewIntent 或 iOS 的 ContinueUserActivity),可通过 DependencyService 或 Platform-specific code 实现:
- 在 Android 平台,可在
MainActivity.cs中重写OnNewIntent,再通过 MessagingCenter 或事件通知 MAUI 层 - 在 iOS 平台,可在
AppDelegate.cs中处理ContinueUserActivity或OpenUrl,再传递参数给 MAUI - .NET 8+ 推荐使用
IApplicationLifetime(需手动注入)或Microsoft.Maui.LifecycleEvents扩展包增强可观测性
基本上就这些。生命周期事件不是万能钩子,重点是理解各平台行为边界,把关键逻辑放在 OnStart 和 OnResume 初始化/恢复,用 OnSleep 做轻量清理,避免依赖“优雅退出”。










