在.NET MAUI应用中配置应用生命周期事件

前言

管理应用生命周期事件是开发应用程序时最常见的要求之一。同样，有必要在跨平台应用程序（如 .NET MAUI应用）中处理应用生命周期，以提高其效率。
在这篇博客中，我将通过代码示例分享如何在 .NET MAUI 应用中配置应用生命周期事件。

应用程序生命周期

通常，应用具有不同的生命周期或状态。.NET MAUI 应用具有以下四个生命周期（执行状态）：

运行 (Running)
未运行 (Not running)
关闭 (Deactivated)
停止 (Stopped)

当窗口移动到每个状态时，将触发不同的事件。

跨平台生命周期

以下是跨平台应用中提供的一些预定义生命周期事件：

Created: 应用从未运行状态移动到正在运行状态时发生。通常，当我们启动新窗口时。
Activated: 当窗口从未聚焦状态移动到聚焦状态（未聚焦 = 位于另一个窗口后面）时发生。
Deactivated: 当窗口移动到未聚焦状态时发生。
Stopped: 在窗口变为隐藏时发生。例如，当我们将其最小化时。这样，窗口就有可能被破坏。
Resumed: 已停止事件的后续事件，但与创建的事件不同。
Destroying: 在窗口被销毁和解除分配时发生。

下面是映射图，其中说明了 .NET MAUI 框架将如何映射本机事件。

如何配置生命周期事件

使用 .NET MAUI Preview 13，您可以使用 MauiAppBuilder 和 ConfigureLifecycleEvents 扩展方法轻松地在 MauiProgram 类中配置生命周期事件。此方法在 Microsoft.Maui.LifecycleEvents 命名空间中可用。

有关常见配置，请参阅以下代码示例。

using Microsoft.Maui.LifecycleEvents;
namespace MauiApp1;

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            }).ConfigureLifecycleEvents(app =>
            { 
                //Code...
            });
        return builder.Build();
    }
}

特定于平台的生命周期事件

您还可以为自定义设置引发特定于平台的事件。下面列举了每个平台的特定事件(可用):

Android

目前，有以下 21 个特定于 Android 平台的事件可用：

OnActivityResult
OnApplicationConfigurationChanged
OnApplicationCreate
OnApplicationCreating
OnApplicationLowMemory
OnApplicationTrimMemory
OnBackPressed
OnConfigurationChanged
OnCreate
OnDestroy
OnNewIntent
OnPause
OnPostCreate
OnPostResume
OnRequestPermissionsResult
OnRestart
OnRestoreInstanceState
OnResume
OnSaveInstanceState
OnStart
OnStop

您可以使用编译器指令通过 AddAndroid() 扩展方法调用特定于 Android 平台的事件。
请参阅下面的代码示例。在这里，我们将调用 OnBackPressed事件以移动到上一个目标。

public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            }).ConfigureLifecycleEvents(AppLifecycle =>
            {
#if ANDROID
                AppLifecycle.AddAndroid(android => android
                   .OnBackPressed((activity) => BackPressed()));
#endif
            });
        return builder.Build();
    }

    static bool BackPressed()
    {
        return true;
    }

IOS

目前，有以下 10 个特定于 iOS 平台的事件可用：

ContinueUserActivity
DidEnterBackground
FinishedLaunching
OnActivated
OnResignActivation
OpenUrl
PerformActionForShortcutItem
WillEnterForeground
WillFinishLaunching
WillTerminate

您可以使用编译器指令通过 AddiOS() 扩展方法调用特定于 iOS 平台的事件。
请参阅下面的代码示例。在这里，我们将调用 WillEnterForeground 事件，该事件将在应用处于焦点模式时引发。

public static MauiApp CreateMauiApp()
{
  var builder = MauiApp.CreateBuilder();
  builder.UseMauiApp<App>()
  builder.ConfigureLifecycleEvents(AppLifecycle => {
      #if IOS
       AppLifecycle.AddiOS(ios => ios
          .WillEnterForeground((app) => EnteredForeground())
       );
      #endif
  });
  return builder.Build();
}
static void EnterForeground()
{
}

Windows

目前，以下 8 个特定于 Windows 平台的事件可用：

OnActivated
OnClosed
OnLaunched
OnLaunching
OnNativeMessage
OnResumed
OnVisibilityChanged
OnWindowCreated

您可以使用编译器指令通过 AddWindows() 扩展方法来调用特定于 Windows 平台的事件。
请参阅下面的代码示例。在这里，我们将调用 OnNativeMessage 事件来访问应用程序实例并删除标题栏。

public static MauiApp CreateMauiApp()
{
  var builder = MauiApp.CreateBuilder();
  builder.UseMauiApp<App>()
  builder.ConfigureLifecycleEvents(AppLifecycle => {
      #if WINDOWS
        AppLifecycle
         .AddWindows(windows =>
           windows.OnNativeMessage((app, args) => {
             app.ExtendsContentIntoTitleBar = false;
           }));
      #endif
  });
  return builder.Build();
}

关于不同平台的生命周期事件定义位置: Core > LifecycleEvents

参考

有关更多详细信息，请参阅 .NET MAUI 应用程序生命周期事件文档。

频道导航