Visual Studio で Win32 アプリ分離アプリケーションをパッケージ化する

[アーティクル]
01/10/2025

このページでは、Win32 アプリ分離を活用するためにアプリケーションをパッケージ化するために必要なすべての内容を説明します。

重要

この機能はプレビュー段階です: 一部の情報はリリース前の製品に関する内容であり、製品版がリリースされるまでに大幅に変更される可能性があります。 Microsoft はここに示されている情報について、明示か黙示かを問わず、一切保証しません。

前提条件

分離された Win32 アプリにアプリケーションをパッケージ化するには、次のものが必要です。

Visual Studio バージョン 17.10.2 以上

ステップ 1 - Windows 11 SDK 10.0.26100.0 (またはそれ以上) を含む必要なワークロードを Visual Studio にインストールします。

Visual Studio インストーラーを開き、既存のインストールを変更します。 [ワークロード] タブで、[Windows アプリケーション開発] ボックスをオンにします (オプションで、C++ での開発の場合は [C++ WinUI アプリ開発ツール] ボックスをオンにします)。 Windows 11 SDK 10.0.26100.0 (またはそれ以上) も必要です。

Visual Studio にインストールする必要があるワークロードを示すスクリーンショット

ステップ2 - アプリプロジェクトを作成する

Visual Studio で、テンプレート "Windows アプリケーションパッケージプロジェクト (デスクトップの WinUI 3) でパッケージ化された空のアプリ" を使用して、新しい C# または C++ プロジェクトを作成します。 [作成] をクリックし、[ターゲットプラットフォームバージョン (TPV)] と [ターゲットプラットフォームの最小バージョン (TPMinV)] として 10.0.26100.0 (またはそれ以降) を選択します。

Visual Studio の新規プロジェクト画面を示すスクリーンショット

Visual Studio の新しい WinUI プロジェクト画面を示すスクリーンショット

ステップ 3 - NuGet を使用して Microsoft.Windows.SDK.BuildTools バージョン 10.0.26100.1742 以降をインストールする

[プロジェクト -> NuGet パッケージの管理] に移動して、 Microsoft.Windows.SDK.BuildTools バージョン 10.0.26100.1 (またはそれ以降) をインストールします。

Visual Studio の NuGet パッケージ管理画面を示すスクリーンショット

Visual Studio の NuGet 画面に Microsoft.Windows.SDK.BuildTools パッケージが表示されているスクリーンショット

Visual Studio の NuGet 画面にビルドツールパッケージの情報を表示するスクリーンショット

ステップ 4 - Packaging.appxmanifest ファイルとプロジェクトファイルを編集する

マニフェストファイルで、次の変更を行う必要があります。

注: 分離された win32 アプリケーションは、同じパッケージ内の他の種類のアプリケーションと互換性がありません。

xmlns:uap18="http://schemas.microsoft.com/appx/manifest/uap/windows10/18" 要素に (まだ存在しない場合は) <Package> を追加します。
- uap18 の IgnorableNamespaces 要素の末尾に <Package> を追加します。
<Dependencies> で TargetDeviceFamily を <TargetDeviceFamily Name="Windows.Desktop" MinVersion="10.0.26100.0" MaxVersionTested="10.0.26226.0" /> に変更します。

Note

最小ビルドではすべての機能が利用できるわけではありません。詳細については、リリースノートを参照してください。さらに、次のマニフェストの変更により、アプリは分離されたアプリになりますが、Win32 アプリの分離がサポートされていないオペレーティングシステムでは引き続き Win32 アプリとして実行できます。
<Application> で、既存のエントリポイント/信頼レベル/ランタイム動作を EntryPoint="Windows.FullTrustApplication"uap18:EntryPoint="Isolated.App"uap18:TrustLevel="appContainer" uap18:RuntimeBehavior="appSilo" に置き換えます。
<Application> 拡張機能で、親 EntryPoints=* から継承された Executable=* または <Application> を削除します。
desktop7:Scope="user" の拡張要素に windows.protocol を追加します。

Note

アプリはパッケージ化された Win32 であるため、既定では Visual Studio によって自動的に <rescap:Capability name="runFullTrust"> が <Capabilities> に追加されます。アプリに comServer や FirewallRules など、ユーザーのグローバル状態に影響を与える可能性のある他の明示的な拡張機能がない限り、これを削除する必要があります。これらの拡張機能には runFullTrust 機能が必要であるためです。