Жизненный цикл приложения

Приложения многоплатформенного пользовательского интерфейса приложений .NET (.NET MAUI) обычно имеют четыре состояния выполнения: не запущено, не запущено, деактивировано и остановлено. .NET MAUI вызывает события жизненного цикла кроссплатформенного цикла класса Window , когда приложение переходит из не запущенного состояния в состояние выполнения, состояние выполнения в деактивированное состояние, деактивированное состояние в остановленное состояние, остановленное состояние в состояние выполнения и остановленное состояние в не запущенное состояние.

На следующей схеме показан обзор жизненного цикла приложения .NET MAUI:

На схеме серый овал указывает, что приложение не загружается в память. Светло-голубые овалы указывают на то, что приложение находится в памяти. Текст на дугах указывает события, создаваемые .NET MAUI, которые предоставляют уведомления в работающем приложении.

Состояние выполнения приложения зависит от журнала приложения. Например, когда приложение установлено в первый раз или устройство запускается, приложение может считаться не запущенным. При запуске Created приложения создаются события и Activated запускается приложение. Если другое окно приложения получает фокус, Deactivated событие вызывается и приложение деактивируется. Если пользователь переключается на другое приложение или возвращается на начальный экран устройства, чтобы окно приложения больше не отображалось, Deactivated возникают события и Stopped приложение останавливается. Если пользователь возвращается в приложение, Resuming вызывается событие и выполняется приложение. Кроме того, приложение может быть завершено пользователем во время его работы. В этой ситуации приложение деактивируется, а затем останавливается, Destroying вызывается событие, и приложение не выполняется. Аналогичным образом, устройство может завершить приложение во время его остановки из-за ограничений ресурсов, и событие возникает, и Destroying приложение не выполняется.

Кроме того, .NET MAUI позволяет приложениям получать уведомления при возникновении событий жизненного цикла платформы. Дополнительные сведения см. в разделе "События жизненного цикла платформы".

События жизненного цикла кроссплатформенного цикла

Класс Window определяет следующие межплатформенные события жизненного цикла:

Эти кроссплатформенные события сопоставляют с различными событиями платформы, а в следующей таблице показано следующее сопоставление:

Кроме того, Window класс также определяет Backgrounding событие, которое вызывается в iOS и Mac Catalyst при закрытии окна или входит в фоновое состояние. BackgroundingEventArgs Объект сопровождает это событие, и любое string состояние должно быть сохранено в State свойстве BackgroundingEventArgs объекта, которое ОС сохранится до тех пор, пока не придется возобновить окно. Когда окно возобновляется IActivationState , состояние предоставляется аргументом CreateWindow переопределения.

Помимо этих событий, Window класс также имеет следующие переопределимые методы жизненного цикла:

• OnCreated, который вызывается при Created вызове события.
• OnActivated, который вызывается при Activated вызове события.
• OnDeactivated, который вызывается при Deactivated вызове события.
• OnStopped, который вызывается при Stopped вызове события.
• OnResumed, который вызывается при Resumed вызове события.
• OnDestroying, который вызывается при Destroying вызове события.
• OnBackgrounding, который вызывается при Backgrounding вызове события.

Чтобы подписаться на Window события жизненного цикла, переопределите CreateWindow метод в App классе, чтобы создать Window экземпляр, на который можно подписаться на события:

namespace MyMauiApp
{
    public partial class App : Application
    {
        public App()
        {
            InitializeComponent();

            MainPage = new MainPage();
        }

        protected override Window CreateWindow(IActivationState? activationState)
        {
            Window window = new Window(new AppShell());

            window.Created += (s, e) =>
            {
                // Custom logic
            };

            return window;
        }
    }
}

namespace MyMauiApp
{
    public partial class App : Application
    {
        public App()
        {
            InitializeComponent();
        }

        protected override Window CreateWindow(IActivationState activationState)
        {
            Window window = base.CreateWindow(activationState);

            window.Created += (s, e) =>
            {
                // Custom logic
            };

            return window;
        }
    }
}

Кроме того, чтобы использовать переопределение жизненного цикла, создайте класс, производный от Window класса.

namespace MyMauiApp
{
    public class MyWindow : Window
    {
        public MyWindow() : base()
        {
        }

        public MyWindow(Page page) : base(page)
        {
        }

        protected override void OnCreated()
        {
            // Register services
        }
    }
}

Затем производный Windowкласс можно использовать путем переопределения CreateWindow метода в App классе для возврата экземпляра MyWindow .

События жизненного цикла платформы

.NET MAUI определяет делегаты, вызываемые в ответ на события жизненного цикла платформы. Обработчики можно указать для этих делегатов, используя именованные методы или анонимные функции, которые выполняются при вызове делегата. Этот механизм позволяет приложениям получать уведомления при возникновении распространенных событий жизненного цикла платформы.

Android

В следующей таблице перечислены делегаты MAUI .NET, которые вызываются в ответ на события жизненного цикла Android.

Чтобы ответить на вызываемый делегат жизненного цикла Android, вызовите ConfigureLifecycleEvents метод MauiAppBuilder объекта в методе CreateMauiapp класса MauiProgram . Затем вызовите ILifecycleBuilder AddAndroid метод и укажите Action обработчики для необходимых делегатов:

using Microsoft.Maui.LifecycleEvents;

namespace PlatformLifecycleDemo
{
    public static class MauiProgram
    {
        public static MauiApp CreateMauiApp()
        {
            var builder = MauiApp.CreateBuilder();
            builder
                .UseMauiApp<App>()
                .ConfigureLifecycleEvents(events =>
                {
#if ANDROID
                    events.AddAndroid(android => android
                        .OnActivityResult((activity, requestCode, resultCode, data) => LogEvent(nameof(AndroidLifecycle.OnActivityResult), requestCode.ToString()))
                        .OnStart((activity) => LogEvent(nameof(AndroidLifecycle.OnStart)))
                        .OnCreate((activity, bundle) => LogEvent(nameof(AndroidLifecycle.OnCreate)))
                        .OnBackPressed((activity) => LogEvent(nameof(AndroidLifecycle.OnBackPressed)) && false)
                        .OnStop((activity) => LogEvent(nameof(AndroidLifecycle.OnStop))));
#endif
                    static bool LogEvent(string eventName, string type = null)
                    {
                        System.Diagnostics.Debug.WriteLine($"Lifecycle event: {eventName}{(type == null ? string.Empty : $" ({type})")}");
                        return true;
                    }
                });

            return builder.Build();
        }
    }
}

Дополнительные сведения о жизненном цикле приложений Android см. в разделе "Общие сведения о жизненном цикле действий" на developer.android.com.

IOS и Mac Catalyst

В следующей таблице перечислены делегаты .NET MAUI, которые вызываются в ответ на события жизненного цикла iOS и Mac Catalyst:

Чтобы ответить на вызываемый делегат жизненного цикла iOS и Mac Catalyst, вызовите ConfigureLifecycleEvents метод MauiAppBuilder объекта в методе CreateMauiapp класса MauiProgram . Затем вызовите ILifecycleBuilder AddiOS метод и укажите Action обработчики для необходимых делегатов:

using Microsoft.Maui.LifecycleEvents;

namespace PlatformLifecycleDemo
{
    public static class MauiProgram
    {
        public static MauiApp CreateMauiApp()
        {
            var builder = MauiApp.CreateBuilder();
            builder
                .UseMauiApp<App>()
                .ConfigureLifecycleEvents(events =>
                {
#if IOS || MACCATALYST
                    events.AddiOS(ios => ios
                        .OnActivated((app) => LogEvent(nameof(iOSLifecycle.OnActivated)))
                        .OnResignActivation((app) => LogEvent(nameof(iOSLifecycle.OnResignActivation)))
                        .DidEnterBackground((app) => LogEvent(nameof(iOSLifecycle.DidEnterBackground)))
                        .WillTerminate((app) => LogEvent(nameof(iOSLifecycle.WillTerminate))));
#endif
                    static bool LogEvent(string eventName, string type = null)
                    {
                        System.Diagnostics.Debug.WriteLine($"Lifecycle event: {eventName}{(type == null ? string.Empty : $" ({type})")}");
                        return true;
                    }
                });

            return builder.Build();
        }
    }
}

Дополнительные сведения о жизненном цикле приложений iOS см. в разделе "Управление жизненным циклом приложения" на developer.apple.com.

Windows

В следующей таблице перечислены делегаты .NET MAUI, которые вызываются в ответ на события жизненного цикла Windows.

.NET MAUI предоставляет определенные собственные сообщения Windows в качестве события жизненного цикла с делегатом OnPlatformMessage . Объект WindowsPlatformMessageEventArgs , сопровождающий этот делегат, включает MessageId свойство типа uint. Значение этого свойства можно проверить, чтобы определить, какое сообщение было передано в окно приложения. Дополнительные сведения о сообщениях Windows см. в статьях "Сообщения Windows" (начало работы с Win32 и C++). Список констант сообщений окна см. в разделе "Уведомления о окне".

Чтобы ответить на вызываемый делегат жизненного цикла Windows, вызовите ConfigureLifecycleEvents метод MauiAppBuilder объекта в методе CreateMauiApp класса MauiProgram . Затем вызовите ILifecycleBuilder AddWindows метод и укажите Action обработчики для необходимых делегатов:

using Microsoft.Maui.LifecycleEvents;

namespace PlatformLifecycleDemo
{
    public static class MauiProgram
    {
        public static MauiApp CreateMauiApp()
        {
            var builder = MauiApp.CreateBuilder();
            builder
                .UseMauiApp<App>()
                .ConfigureLifecycleEvents(events =>
                {
#if WINDOWS
                    events.AddWindows(windows => windows
                           .OnActivated((window, args) => LogEvent(nameof(WindowsLifecycle.OnActivated)))
                           .OnClosed((window, args) => LogEvent(nameof(WindowsLifecycle.OnClosed)))
                           .OnLaunched((window, args) => LogEvent(nameof(WindowsLifecycle.OnLaunched)))
                           .OnLaunching((window, args) => LogEvent(nameof(WindowsLifecycle.OnLaunching)))
                           .OnVisibilityChanged((window, args) => LogEvent(nameof(WindowsLifecycle.OnVisibilityChanged)))
                           .OnPlatformMessage((window, args) =>
                           {
                               if (args.MessageId == Convert.ToUInt32("031A", 16))
                               {
                                   // System theme has changed
                               }
                           }));
#endif
                    static bool LogEvent(string eventName, string type = null)
                    {
                        System.Diagnostics.Debug.WriteLine($"Lifecycle event: {eventName}{(type == null ? string.Empty : $" ({type})")}");
                        return true;
                    }
                });

            return builder.Build();
        }
    }
}

Получение объекта Window

Код платформы может получить объект приложения Window из событий жизненного цикла платформы с GetWindow помощью метода расширения:

using Microsoft.Maui.LifecycleEvents;

namespace PlatformLifecycleDemo
{
    public static class MauiProgram
    {
        public static MauiApp CreateMauiApp()
        {
            var builder = MauiApp.CreateBuilder();
            builder
                .UseMauiApp<App>()
                .ConfigureLifecycleEvents(events =>
                {
#if WINDOWS
                    events.AddWindows(windows => windows
                            .OnClosed((window, args) =>
                            {
                                IWindow appWindow = window.GetWindow();
                            }));
#endif
                });

            return builder.Build();
        }
    }
}

Пользовательские события жизненного цикла

Хотя .NET MAUI определяет делегаты, которые вызываются в ответ на события жизненного цикла платформы, он предоставляет только общий набор событий жизненного цикла платформы. Однако он также включает механизм, как правило, для авторов библиотек, что позволяет приложениям получать уведомления при возникновении дополнительных событий жизненного цикла платформы. Чтобы этого добиться, выполните следующие действия.

• Зарегистрируйте обработчик событий для события жизненного цикла платформы, которое не предоставляется .NET MAUI.
• В обработчике событий для события жизненного цикла платформы извлеките ILifecycleEventService экземпляр и вызовите его InvokeEvents метод, указав имя события платформы в качестве аргумента.

Затем приложения, которые хотят получать уведомления о событии жизненного цикла платформы, должны изменить CreateMauiApp метод своего MauiProgram класса для вызова ConfigureLifecycleEvents метода в объекте MauiAppBuilder . Затем в ILifecycleBuilder объекте вызовите AddEvent метод и укажите имя события платформы и Action вызываемое при вызове события платформы.

Пример

Событие WinUI 3 Window.SizeChanged возникает при первом отрисовке окна собственного приложения или изменения размера отрисовки. .NET MAUI не предоставляет это событие платформы как событие жизненного цикла. Однако приложения могут получать уведомления, когда это событие платформы возникает с помощью следующего подхода:

• Зарегистрируйте обработчик событий для события жизненного Window.SizeChanged цикла платформы:

  using Microsoft.Maui.LifecycleEvents;
  ...
  
  public static MauiApp CreateMauiApp()
  {
        var builder = MauiApp.CreateBuilder();
        builder
              .UseMauiApp<App>()
              .ConfigureLifecycleEvents(events =>
              {
  #if WINDOWS
                    events.AddWindows(windows => windows
                           .OnWindowCreated(window =>
                           {
                                  window.SizeChanged += OnSizeChanged;
                           }));
  #endif
              });
  
        return builder.Build();
  }    
  

• В обработчике событий для события жизненного цикла платформы извлеките ILifecycleEventService экземпляр и вызовите его InvokeEvents метод, указав имя события платформы в качестве аргумента:

  using Microsoft.Maui.LifecycleEvents;
  ...
  
  #if WINDOWS
          static void OnSizeChanged(object sender, Microsoft.UI.Xaml.WindowSizeChangedEventArgs args)
          {
              ILifecycleEventService service = MauiWinUIApplication.Current.Services.GetRequiredService<ILifecycleEventService>();
              service.InvokeEvents(nameof(Microsoft.UI.Xaml.Window.SizeChanged));
          }
  #endif
  

  Тип MauiWinUIApplication в Windows можно использовать для доступа к собственному экземпляру приложения через его Current свойство. Тип MauiApplication в Android можно использовать для доступа к экземпляру собственного приложения. Аналогичным образом, MauiUIApplicationDelegate тип в iOS можно использовать для доступа к собственному экземпляру приложения.

  Предупреждение

  Вызов незарегистрированного события с InvokeEvents методом не вызывает исключение.

• В методе CreateMauiApp класса вызовите ConfigureLifecycleEvents метод MauiProgram объектаMauiAppBuilder. Затем в ILifecycleBuilder объекте вызовите AddEvent метод и укажите имя события платформы и Action вызываемое при вызове события платформы:

  using Microsoft.Maui.LifecycleEvents;
  
  namespace PlatformLifecycleDemo
  {
      public static class MauiProgram
      {
          public static MauiApp CreateMauiApp()
          {
              var builder = MauiApp.CreateBuilder();
              builder
                  .UseMauiApp<App>()
                  .ConfigureLifecycleEvents(events =>
                  {
  #if WINDOWS
                      events.AddWindows(windows => windows
                             .OnWindowCreated(window =>
                             {
                                    window.SizeChanged += OnSizeChanged;
                             }));
  
                      events.AddEvent(nameof(Microsoft.UI.Xaml.Window.SizeChanged), () => LogEvent("Window SizeChanged"));
  #endif
                      static bool LogEvent(string eventName, string type = null)
                      {
                          System.Diagnostics.Debug.WriteLine($"Lifecycle event: {eventName}{(type == null ? string.Empty : $" ({type})")}");
                          return true;
                      }
                  });
  
              return builder.Build();
          }
      }
  }
  

Общий эффект заключается в том, что при изменении размера окна приложения в Windows выполняется действие, указанное в методе AddEvent .