Windows アプリ SDK デスクトップ アプリのアプリ ライフサイクル

この記事では、起動から終了までのWindows アプリ SDK デスクトップ アプリのライフサイクルについて説明します。 ライフサイクルを理解すると、状態の管理、リソースの節約、スムーズなユーザー エクスペリエンスの実現に役立ちます。

ライフサイクルの概要

Windows アプリ SDK デスクトップ アプリのライフサイクルは、UWP よりも簡単です。

中断状態がないため、UWP アプリと同様に Suspending イベントや Resuming イベントを処理する必要はありません。 代わりに、次の点に注目してください。

• ウィンドウが閉じるか、アプリがシャットダウンしたときにユーザーの状態を保存する。
• アクティブ化の処理 (起動、ファイル、プロトコル、またはその他のアクティブ化の種類)。
• ポータブルデバイスのバッテリーを節約するためにバックグラウンド作業を効率的に管理します。

アプリの起動

ユーザーがアプリを起動すると、Microsoft。Ui。Xaml.Application.OnLaunched メソッドが実行されます。 これを使用してメイン ウィンドウを初期化し、最初のページに移動します。

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

アプリのアクティブ化

Windows アプリ SDK は、Microsoft.Windows.AppLifecycle 名前空間を通じて、豊富なアクティブ化サポートを提供します。 アプリは次の方法でアクティブ化できます。

• 既定の起動 - ユーザーがアプリ アイコンを選択します。
• ファイルのアクティブ化 - ユーザーがアプリに関連付けられているファイルの種類を開きます。
• プロトコルのアクティブ化 — アプリに登録されている URI スキームが呼び出されます。
• スタートアップのアクティブ化 - ユーザー ログオン時に開始するようにアプリが登録されます。
• その他 — トースト通知、共有ターゲット、その他のアクティブ化の種類。

AppInstance.GetActivatedEventArgs を使用して、アクティブ化の種類を確認します。

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

パッケージ アプリは、 Package.appxmanifestを介してファイルとプロトコルのアクティブ化に登録します。 パッケージ化されていないアプリにはマニフェストがないため、 Microsoft.Windows.AppLifecycle.ActivationRegistrationManagerを使用してコードに同じアクティブ化の種類を登録します。 両方の方法の詳細なチュートリアルについては、「Windows アプリ SDKのアプリのアクティブ化」を参照してください。

バックグラウンドとフォアグラウンドでの実行

デスクトップ アプリは、フォアグラウンドに存在するかどうかに関係なく、引き続き実行されます。 ユーザーが別のアプリに切り替えたときに、システムがスレッドを停止したり、メモリを再利用したりすることはありません。 ただし、リソースの使用状況を最適化するために、可視性の変更に対応することはできます。

• ウィンドウが最小化されている場合は、高価な GPU またはレンダリング リソースを解放します。
• ウィンドウがフォーカスを失ったときにアニメーションまたはメディア プレビューを一時停止します。
• バックグラウンドでのポーリングのタイマーの頻度を減らします。

Microsoft.UI.Xaml.Window は VisibilityChanged イベントを公開していません。 代わりに、 Window.Activated イベントを使用して、ウィンドウがフォーカスを取得または失うタイミングを検出するか、 AppWindow.Changed を使用して発表者の状態 (最小化や復元など) への変更を検出します。

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

状態の保存

デスクトップ アプリは中断されないため、状態を保存するタイミングを制御します。 推奨される方法:

• ウィンドウが閉じた場合 - データを保持するために Window.Closed イベントを処理します。
• 定期的な保存 — タイマーを使用して、間隔 (60 秒ごとなど) で状態を保存します。
• 重要なアクションの場合 - ユーザーが重要なアクションを完了した後に保存します (編集の完了など)。

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

アプリのクローズと終了処理

デスクトップ アプリは、次の場合に終了します。

• ユーザーは最後のウィンドウを閉じます。
• コードは Application.Current.Exit()を呼び出します。
• プロセスは外部で終了します (タスク マネージャー、システムのシャットダウン)。

UWP のように、"リソースを解放するためにシステムによって終了される" 状態はありません。 アプリは、明示的に終了するまで実行されます。

UWP アプリのライフサイクルとの違い

関連するコンテンツ

• Windows アプリ SDKのアプリのアクティブ化
• デスクトップ アプリでメモリを管理する
• マルチインスタンス アプリ
• Windows アプリ SDKでの豊富なアクティブ化
• Windows アプリ SDKでのアプリのインスタンス化