Applivscykel för Windows App SDK skrivbordsappar

I den här artikeln beskrivs livscykeln för en Windows App SDK skrivbordsapp från start till avslutning. Genom att förstå livscykeln kan du hantera tillstånd, spara resurser och ge en smidig användarupplevelse.

Livscykelöversikt

En Windows App SDK skrivbordsapp har en enklare livscykel än UWP:

Eftersom det inte finns något pausat tillstånd behöver du inte hantera Suspending eller Resuming händelser som UWP-appar gör. Fokusera i stället på:

• Sparar användartillstånd när fönstret stängs eller appen stängs av.
• Hantera aktivering (start, fil, protokoll eller andra aktiveringstyper).
• Hantera bakgrundsarbete effektivt för att spara batteri på bärbara enheter.

Start av app

När en användare startar din app Microsoft. UI. Xaml.Application.OnLaunched-metoden körs. Använd det för att initiera huvudfönstret och navigera till din första sida.

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
{
}

Aktivering av app

Windows App SDK ger omfattande aktiveringsstöd via Microsoft.Windows. AppLifecycle-namnområde. Appen kan aktiveras genom att:

• Standardstart – Användaren väljer din appikon.
• Filaktivering – Användaren öppnar en filtyp som är associerad med din app.
• Protokollaktivering – Ett URI-schema som är registrerat i din app anropas.
• Startaktivering – Appen registreras för att starta vid användarinloggning.
• Övrigt — toast-meddelande, delningsmål och ytterligare aktiveringstyper.

Använd AppInstance.GetActivatedEventArgs för att fastställa aktiveringstyp:

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;
}

Paketerade appar registreras för fil- och protokollaktivering via Package.appxmanifest. Opaketerade appar har inget manifest, så de registrerar samma aktiveringstyper i kod med Microsoft.Windows.AppLifecycle.ActivationRegistrationManager. En detaljerad genomgång av båda metoderna finns i Appaktivering för Windows App SDK.

Körs i bakgrunden och förgrunden

Skrivbordsappar fortsätter att köra oavsett om de är i förgrunden eller inte. Systemet stoppar inte trådarna eller återtar minnet när användaren växlar till en annan app. Du kan dock fortfarande svara på synlighetsändringar för att optimera resursanvändningen:

• Frigör dyra GPU-resurser eller återgivningsresurser när fönstret minimeras.
• Pausa animeringar eller medieförhandsvisning när fönstret tappar fokus.
• Minska timerfrekvensen för bakgrundspollning.

Microsoft.UI.Xaml.Window exponerar inte en VisibilityChanged-händelse. Använd Window.Activated i stället händelsen för att identifiera när ditt fönster ökar eller förlorar fokus eller använder AppWindow.Changed för att identifiera ändringar i presentatörstillstånd (till exempel minimerat eller återställt):

// 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
        }
    }
};

Sparar tillstånd

Eftersom skrivbordsappar inte pausas styr du när tillståndet ska sparas. Rekommenderade metoder:

• Vid fönsterstängning – Hantera Window.Closed händelsen för att spara data.
• Periodisk sparande – Använd en timer för att spara tillstånd med intervall (till exempel var 60:e sekund).
• Vid viktiga åtgärder – Spara när användaren har slutfört en betydande åtgärd (till exempel när en redigering har slutförts).

// 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() { }

Stäng och avsluta appen

En skrivbordsapp avslutas när:

• Användaren stänger det sista fönstret.
• Koden anropar Application.Current.Exit().
• Processen avslutas externt (Aktivitetshanteraren, systemavstängning).

Det finns inget tillstånd "avslutat av systemet för att frigöra resurser" som i UWP. Din app körs tills den uttryckligen avslutas.

Skillnader från UWP-appens livscykel

Relaterat innehåll

• Appaktivering för Windows App SDK
• Hantera minne i din skrivbordsapp
• Appar med flera instanser
• Omfattande aktivering i Windows App SDK
• Appinstanser i Windows App SDK