Windows アプリ SDKを使用するデスクトップ プロジェクトがある場合は、Windows アプリ SDK NuGet パッケージをプロジェクト (最新バージョンまたは必要な任意のバージョン) にインストールできます。 パッケージ化されていないアプリ (つまり、展開テクノロジに MSIX を使用しないアプリ) mustWindows アプリ SDKを使用する場合は、この手順に従います。 ただし、パッケージ アプリ実行することもできます。
重要
UWP アプリで作業している場合は、「UWP から Windows App SDK に移行する」を参照してください。
注
この手順は、C# .NET 6 (以降) プロジェクトおよび C++ デスクトップ プロジェクトでサポートされています。 これらのプロジェクトの種類では、 stable リリース チャネル、 preview リリース チャネル、または experimental リリース チャネルのいずれかの NuGet パッケージを使用できます。
前提条件
- Visual Studio 2019 以降。
- Windows アプリ開発用のワークロードとコンポーネント。 詳細については、「Windows アプリ SDKのツールをインストールする」を参照してください。
手順
Visual Studio で既存のプロジェクトを開きます。
注
C# デスクトップ プロジェクトがある場合は、プロジェクト ファイル内の TargetFramework 要素が Windows 10 固有のモニカー (net6.0-windows10.0.19041.0 など) に設定されていることを確認し、Windows ランタイム API を呼び出すことができるようにします。 詳細については、「デスクトップ アプリでの API のWindows ランタイム呼び出し」を参照してください。
パッケージ参照が有効になっていることを確認します。
- Visual Studio で、[ツール] > [NuGet パッケージ マネージャー] > [パッケージ マネージャー設定] の順にクリックします。
- Default パッケージ管理形式で PackageReference が選択されていることを確認します。
ソリューション エクスプローラーでプロジェクトを右クリックし、 [NuGet パッケージの管理] をクリックします。
[NuGet パッケージ マネージャー] ウィンドウで、ウィンドウの上部近くにある [プレリリースを含める] チェックボックスをオンにし、[参照] タブを選択して、次のいずれかのパッケージを検索します。
- 1.0 またはそれ以降のリリースのいずれかをインストールするには、Microsoft.WindowsAppSDK パッケージを検索します。
- 0.8 リリースのいずれかをインストールするには、Microsoft.ProjectReunion パッケージを検索します。
適切なWindows アプリ SDK NuGet パッケージが見つかったら、パッケージを選択し、NuGet パッケージ マネージャー ウィンドウの右側のウィンドウで [Install をクリックします。
注
Windows アプリ SDK NuGet パッケージには、Windows アプリ SDK内の特定のコンポーネントの実装を含む他のサブパッケージ (Microsoft.WindowsAppSDK.Foundation、Microsoft.WindowsAppSDK.WinUI など) が含まれています。 プロジェクト内の特定のコンポーネントのみを参照するために、これらのサブパッケージを個別にインストールすることはできません。 メインの Windows App SDK NuGet パッケージをインストールする必要があります。このパッケージには、すべてのコンポーネントが含まれています。
パッケージ化されていないアプリの場合のみ。 パッケージ化されていないアプリで Windows アプリ SDK API とコンポーネントを使用できるようにするには、まず、Windows アプリ SDK フレームワーク パッケージを参照するためにWindows アプリ SDK ランタイムを読み込む必要があります。 詳細については、「外部の場所またはパッケージ化されていないアプリのWindows アプリ SDK ランタイムを使用するとTutorial: 外部の場所でパッケージ化されたアプリでブートストラップ API を使用する、またはWindows アプリ SDKを使用するパッケージ化されていないアプリを使用する方法に関するページを参照してください。
アプリで、インストールしたリリース チャネルで使用できる api とコンポーネントWindows アプリ SDK使用できるようになりました。 利用可能な機能の一覧については、リリース チャネルに関するページを参照してください。
詳細情報
既存のプロジェクトが C++ プロジェクトであり、Windows アプリ SDKで Windows ランタイム API を呼び出す場合は、C++/WinRT のサポートを追加する必要があります。 C++/WinRT、XAML、VSIX 拡張機能、NuGet パッケージに対する Visual Studio のサポートを参照してください。 Microsoft.Windows.CppWinRT NuGet パッケージに関する情報を探します。 そのパッケージがないと、プロジェクトはWindows アプリ SDK内の Windows ランタイム API の名前空間ヘッダー ファイルを見つけることができません。
Class が登録されていない場合Windows アプリ SDK コンポーネントを使用しようとしたときにエラーが発生した場合は、Windows アプリ SDK Framework パッケージへの動的な依存関係をプロジェクトに追加する必要があります。
詳細については、
参照
Windows developer