Cykl życia aplikacji dla aplikacji klasycznych Zestaw SDK do aplikacji systemu Windows

W tym artykule opisano cykl życia aplikacji klasycznej Zestaw SDK do aplikacji systemu Windows od uruchomienia do zakończenia. Zrozumienie cyklu życia pomaga zarządzać stanem, oszczędzać zasoby i zapewniać bezproblemowe środowisko użytkownika.

Przegląd cyklu życia

Aplikacja klasyczna Zestaw SDK do aplikacji systemu Windows ma prostszy cykl życia niż platforma UWP:

Ponieważ nie ma stanu wstrzymania, nie trzeba obsługiwać Suspending ani Resuming zdarzeń w taki sposób, jak działają aplikacje platformy UWP. Zamiast tego skoncentruj się na:

• Zapisywanie stanu użytkownika po zamknięciu okna lub zamknięciu aplikacji.
• Obsługa aktywacji (uruchamianie, plik, protokół lub inne rodzaje aktywacji).
• Efektywne zarządzanie pracą w tle w celu oszczędzania baterii na urządzeniach przenośnych.

Uruchamianie aplikacji

Gdy użytkownik uruchamia aplikację, jest uruchamiana metoda Microsoft.UI.Xaml.Application.OnLaunched. Użyj go, aby zainicjować okno główne i przejść do pierwszej strony.

public partial class App : Microsoft.UI.Xaml.Application
{
    private Microsoft.UI.Xaml.Window? m_window;

    protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
    {
        m_window = new MainWindow();
        m_window.Activate();
    }
}

// MainWindow is the window class generated by the WinUI 3 project
// template (MainWindow.xaml / MainWindow.xaml.cs).
public partial class MainWindow : Microsoft.UI.Xaml.Window
{
}

Aktywacja aplikacji

Zestaw SDK do aplikacji systemu Windows zapewnia rozbudowaną obsługę aktywacji za pośrednictwem przestrzeni nazw Microsoft.Windows.AppLifecycle. Aplikację można aktywować, wykonując następujące czynności:

• Uruchamianie domyślne — użytkownik wybiera ikonę aplikacji.
• Aktywacja pliku — użytkownik otwiera typ pliku skojarzony z aplikacją.
• Aktywacja protokołu — wywoływany jest schemat identyfikatora URI zarejestrowany w aplikacji.
• Uruchamianie przy logowaniu — aplikacja rejestruje się do uruchamiania przy logowaniu użytkownika.
• Inne — powiadomienia typu toast, cel udostępniania i dodatkowe typy aktywacji.

Użyj klasy AppInstance.GetActivatedEventArgs , aby określić rodzaj aktywacji:

using Microsoft.Windows.AppLifecycle;

var activatedArgs = AppInstance.GetCurrent().GetActivatedEventArgs();

switch (activatedArgs.Kind)
{
    case ExtendedActivationKind.File:
        var fileArgs = activatedArgs.Data as
            Windows.ApplicationModel.Activation.IFileActivatedEventArgs;
        // Handle the file
        break;

    case ExtendedActivationKind.Protocol:
        var protocolArgs = activatedArgs.Data as
            Windows.ApplicationModel.Activation.IProtocolActivatedEventArgs;
        // Handle the URI
        break;

    case ExtendedActivationKind.Launch:
    default:
        // Standard launch
        break;
}

Spakowane aplikacje rejestrują się na potrzeby aktywacji plików i protokołów za pośrednictwem programu Package.appxmanifest. Aplikacje rozpakowane nie mają manifestu, więc rejestrują te same rodzaje aktywacji w kodzie przy użyciu polecenia Microsoft.Windows.AppLifecycle.ActivationRegistrationManager. Aby uzyskać szczegółowy przewodnik po obu podejściach, zobacz Aktywacja aplikacji dla Zestaw SDK do aplikacji systemu Windows.

Działanie w tle i na pierwszym planie

Aplikacje klasyczne nadal działają, niezależnie od tego, czy znajdują się na pierwszym planie. System nie zatrzymuje wątków ani nie odzyskuje pamięci, gdy użytkownik przełącza się do innej aplikacji. Jednak nadal można reagować na zmiany widoczności w celu optymalizacji użycia zasobów:

• Zwolnij kosztowne zasoby GPU lub zasoby renderujące, gdy okno jest zminimalizowane.
• Wstrzymywanie animacji lub podglądu multimediów, gdy okno traci fokus.
• Zmniejsz częstotliwość czasomierza dla sondowania w tle.

Microsoft.UI.Xaml.Window nie ujawnia zdarzenia VisibilityChanged . Zamiast tego użyj zdarzenia Window.Activated, aby wykryć, kiedy okno uzyskuje lub traci fokus, albo użyj AppWindow.Changed, aby wykryć zmiany stanu prezentacji (na przykład zminimalizowanie lub przywrócenie):

// m_window is the field declared on your App type (see "App launch" above).
Microsoft.UI.Xaml.Window m_window = this;

m_window.Activated += (sender, args) =>
{
    if (args.WindowActivationState == WindowActivationState.Deactivated)
    {
        // Window lost focus — consider reducing work,
        // for example pausing animations or media preview
    }
    else
    {
        // Window is active — resume normal work
    }
};

// To specifically detect minimize/restore, use AppWindow.Changed
var appWindow = m_window.AppWindow;
appWindow.Changed += (sender, args) =>
{
    if (args.DidPresenterChange)
    {
        if (sender.Presenter is OverlappedPresenter presenter &&
            presenter.State == OverlappedPresenterState.Minimized)
        {
            // Window is minimized — pause expensive rendering
        }
        else
        {
            // Window is restored — resume rendering
        }
    }
};

Zapisywanie stanu

Ponieważ aplikacje klasyczne nie są zawieszone, możesz kontrolować czas zapisywania stanu. Zalecane podejścia:

• Po zamknięciu okna — obsłuż zdarzenie Window.Closed, aby zachować dane.
• Zapisywanie okresowe — użyj czasomierza, aby zapisać stan w odstępach czasu (na przykład co 60 sekund).
• W przypadku ważnych akcji — zapisz po zakończeniu znaczącej akcji przez użytkownika (na przykład zakończeniu edycji).

// m_window is the field declared on your App type (see "App launch" above).
Microsoft.UI.Xaml.Window m_window = this;

m_window.Closed += (sender, args) =>
{
    SaveApplicationState();
};

// Replace with your own logic to persist app state.
void SaveApplicationState() { }

Zamykanie i kończenie działania aplikacji

Aplikacja klasyczna kończy działanie, gdy:

• Użytkownik zamyka ostatnie okno.
• Twój kod wywołuje Application.Current.Exit().
• Proces jest zakończony zewnętrznie (Menedżer zadań, zamykanie systemu).

Nie ma stanu "zakończone przez system w celu zwolnienia zasobów", jak w systemie UWP. Aplikacja jest uruchamiana, dopóki nie zostanie jawnie zakończona.

Różnice w cyklu życia aplikacji platformy UWP

Treści powiązane

• Aktywacja aplikacji dla Zestaw SDK do aplikacji systemu Windows
• Zarządzanie pamięcią w aplikacji klasycznej
• Aplikacje z wieloma wystąpieniami
• Zaawansowana aktywacja w Zestaw SDK do aplikacji systemu Windows
• Wystąpienia aplikacji w Zestaw SDK do aplikacji systemu Windows