在 .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在 Activity
onPause时触发,但若用户通过“最近任务”清掉应用,可能不会触发 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做轻量清理,避免依赖“优雅退出”。
