앱 수명 주기

.NET 다중 플랫폼 앱 UI(.NET MAUI) 앱에는 일반적으로 실행되지 않음, 실행 중, 비활성화 및 중지된 네 가지 실행 상태가 있습니다. .NET MAUI는 앱이 실행되지 않는 상태에서 실행 중 상태로 전환되고, 실행 상태가 비활성화된 상태로, 비활성화된 상태를 중지된 상태로, 중지된 상태를 실행 중 상태로, 중지된 상태를 실행되지 않는 상태로 전환할 때 클래스에서 플랫폼 간 수명 주기 이벤트를 Window 발생합니다.

다음 다이어그램에서는 .NET MAUI 앱 수명 주기에 대한 개요를 보여 있습니다.

다이어그램에서 회색 타원은 앱이 메모리에 로드되지 않음을 나타냅니다. 연한 파란색 타원은 앱이 메모리에 있음을 나타냅니다. 호에 있는 텍스트는 실행 중인 앱에 알림을 제공하는 .NET MAUI에서 발생하는 이벤트를 나타냅니다.

앱의 실행 상태는 앱의 기록에 따라 달라집니다. 예를 들어 앱이 처음으로 설치되거나 디바이스가 시작된 경우 앱이 실행되고 있지 않은 것으로 간주될 수 있습니다. 앱이 시작 Created Activated 되면 이벤트가 발생하고 앱이 실행됩니다. 다른 앱 창에 포커스가 Deactivated 있으면 이벤트가 발생하고 앱이 비활성화됩니다. 사용자가 다른 앱으로 전환하거나 디바이스의 홈 화면으로 돌아가서 앱 창이 더 이상 표시되지 Deactivated 않도록 하면 이벤트 및 Stopped 이벤트가 발생하고 앱이 중지됩니다. 사용자가 앱 Resuming 으로 돌아오면 이벤트가 발생하고 앱이 실행됩니다. 또는 앱이 실행되는 동안 사용자가 앱을 종료할 수 있습니다. 이 경우 앱이 비활성화된 다음 중지되고 이벤트가 Destroying 발생하며 앱이 실행되고 있지 않습니다. 마찬가지로 디바이스는 리소스 제한으로 인해 중지된 동안 앱을 종료할 수 있으며 Destroying 이벤트가 발생하고 앱이 실행되고 있지 않습니다.

또한 .NET MAUI를 사용하면 플랫폼 수명 주기 이벤트가 발생할 때 앱에 알림을 받을 수 있습니다. 자세한 내용은 플랫폼 수명 주기 이벤트를 참조 하세요.

플랫폼 간 수명 주기 이벤트

클래스는 Window 다음과 같은 플랫폼 간 수명 주기 이벤트를 정의합니다.

이러한 플랫폼 간 이벤트는 서로 다른 플랫폼 이벤트에 매핑되며 다음 표에서는 이 매핑을 보여 줍니다.

또한 클래스는 Window 창이 닫혀 있거나 백그라운드 상태가 될 때 iOS 및 Mac Catalyst에서 발생하는 이벤트를 정의 Backgrounding 합니다. 개체는 BackgroundingEventArgs 이 이벤트를 동반하며, 모든 string 상태는 개체의 BackgroundingEventArgs 속성에 State 유지되어야 하며, OS는 창을 다시 시작할 때까지 유지됩니다. 창을 다시 시작하면 재정의에 대한 인수 CreateWindow 에 IActivationState 의해 상태가 제공됩니다.

이러한 이벤트 Window 외에도 클래스에는 다음과 같은 재정의 가능한 수명 주기 메서드가 있습니다.

• OnCreated- 이벤트가 발생할 때 Created 호출됩니다.
• OnActivated- 이벤트가 발생할 때 Activated 호출됩니다.
• OnDeactivated- 이벤트가 발생할 때 Deactivated 호출됩니다.
• OnStopped- 이벤트가 발생할 때 Stopped 호출됩니다.
• OnResumed- 이벤트가 발생할 때 Resumed 호출됩니다.
• OnDestroying- 이벤트가 발생할 때 Destroying 호출됩니다.
• OnBackgrounding- 이벤트가 발생할 때 Backgrounding 호출됩니다.

수명 주기 이벤트를 구독하려면 클래스의 Window 메서드 App 를 재정의 CreateWindow 하여 이벤트를 구독할 수 있는 인스턴스를 만듭니 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그런 다음 인스턴스를 반환하기 위해 클래스의 메서드 App 를 재정의 CreateWindow 하여 -derived 클래스를 MyWindow 사용할 수 있습니다.

플랫폼 수명 주기 이벤트

.NET MAUI는 발생하는 플랫폼 수명 주기 이벤트에 대한 응답으로 호출되는 대리자를 정의합니다. 대리자를 호출할 때 실행되는 명명된 메서드 또는 익명 함수를 사용하여 이러한 대리자의 처리기를 지정할 수 있습니다. 이 메커니즘을 사용하면 일반적인 플랫폼 수명 주기 이벤트가 발생할 때 앱에 알림을 받을 수 있습니다.

Android

다음 표에서는 발생하는 Android 수명 주기 이벤트에 대한 응답으로 호출되는 .NET MAUI 대리자를 나열합니다.

호출되는 Android 수명 주기 대리자에게 응답하려면 클래스의 메서드에서 MauiAppBuilder 개체의 메서드를 CreateMauiapp 호출 ConfigureLifecycleEvents 합니다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 활동 수명 주기 이해(Understand the Activity Lifecycle )를 참조하세요.

iOS 및 Mac Catalyst

다음 표에서는 발생하는 iOS 및 Mac Catalyst 수명 주기 이벤트에 대한 응답으로 호출되는 .NET MAUI 대리자를 나열합니다.

호출되는 iOS 및 Mac Catalyst 수명 주기 대리자에게 응답하려면 클래스의 메서드에서 MauiAppBuilder 개체의 메서드를 CreateMauiapp 호출 ConfigureLifecycleEvents 합니다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

다음 표에서는 발생하는 Windows 수명 주기 이벤트에 대한 응답으로 호출되는 .NET MAUI 대리자를 나열합니다.

.NET MAUI는 대리자를 사용하여 특정 네이티브 Windows 메시지를 수명 주기 이벤트로 노출합니다 OnPlatformMessage . 이 대리자를 함께 사용하는 개체에는 WindowsPlatformMessageEventArgs 형식uint의 MessageId 속성이 포함됩니다. 이 속성의 값을 검사하여 앱 창에 전달된 메시지를 확인할 수 있습니다. Windows 메시지에 대한 자세한 내용은 Windows 메시지(Win32 및 C++시작)를 참조하세요. 창 메시지 상수 목록은 창 알림을 참조 하세요.

호출되는 Windows 수명 주기 대리자에 응답하려면 클래스의 메서드에서 개체의 MauiAppBuilder 메서드를 CreateMauiApp 호출 ConfigureLifecycleEvents 합니다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 호출하여 플랫폼 이벤트 이름을 인수로 지정합니다.

그런 다음 플랫폼 수명 주기 이벤트에 대한 알림을 받으려는 앱은 해당 클래스의 메서드를 MauiProgram 수정 CreateMauiApp 하여 개체에서 메서드를 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
  

  Windows의 형식을 MauiWinUIApplication 사용하여 해당 Current 속성을 통해 네이티브 앱 인스턴스에 액세스할 수 있습니다. Android의 형식을 MauiApplication 사용하여 네이티브 앱 인스턴스에 액세스할 수 있습니다. 마찬가지로 iOS의 형식을 MauiUIApplicationDelegate 사용하여 네이티브 앱 인스턴스에 액세스할 수 있습니다.

  Warning

  메서드를 사용하여 등록되지 않은 이벤트를 InvokeEvents 호출해도 예외는 throw되지 않습니다.

• 클래스의 CreateMauiApp MauiProgram 메서드에서 개체의 메서드를 ConfigureLifecycleEvents 호출합니다 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 지정된 작업이 실행된다는 것입니다.