WinUI を始めよう

WinUI 3 は、Windowsデスクトップアプリを構築するためのネイティブ UI フレームワークです。これはWindows アプリ SDKの一部であり、Windows オペレーティングシステム自体とは別の API とツールのセットであり、ターゲットコンピューターにインストールするか、アプリと共にパッケージ化する必要があります。 WinUI 3 は C# と C++ の両方をサポートしており、クロスプラットフォームまたは Web ベースのフレームワークではありません。

Windows 3.1 のマインスイーパーと、Windows 11で実行されるGitHub Copilotの助けを借りて作成されたバージョン。

Important

WinUI 3 は UWP とは異なります。 WinUI 3 では、 Microsoft.UI.Xaml 名前空間が使用され、デスクトッププロセスとして実行されます。UWP は Windows.UI.Xaml を使用し、アプリコンテナーで実行します。 WinUI 3 では、パッケージ化された配布 (MSIX)、外部の場所を使用するパッケージ化された配布、およびパッケージ化されていない配布がサポートされています。どの選択肢が適切かは、デプロイシナリオによって異なります。ガイダンスについては、「配布方法の選択」を参照してください。

パスを選択する

WinUI 3 プロジェクトを作成するための 2 つのサポートされているパスが存在します。

	Visual Studio	コマンドライン
最適な用途	Windows 開発が初めての開発者、ビジュアル UI デザイナー、またはフル IDE 環境を求めるすべての人	開発者は、ターミナル、CI/CD パイプライン、またはスクリプト化された環境のセットアップに慣れる
ツール	Windows アプリ SDK および WinUI のワークロードがインストールされている Visual Studio 2026	.NET 10 SDK 用の `dotnet new` WinUI テンプレート
Projectの作成	新しいプロジェクトウィザード — 空のアプリ、パッケージ化済み (デスクトップの WinUI 3) テンプレートを選択します	`dotnet new winui -n MyApp`
ビルドと実行	F5 キーを押すと、Visual Studio が MSIX パッケージをビルドして署名し、展開して、アプリを起動します。	`dotnet run` — パッケージ ID を使用してアプリをビルドして起動します (開発者モードが必要)
デバッグ	XAML ライブプレビューを使用したフル Visual Studio デバッガー	デバッガーを手動でアタッチするか、生成された`.sln`をVisual Studioで開く

どちらのパスでも、同等の WinUI 3 プロジェクトが生成されます。 Visual Studio パスは、MSIX の署名と展開を自動的に処理します。コマンドラインパスでは、ローカル開発に dotnet run が使用されます (含まれている Microsoft.Windows.SDK.BuildTools.WinApp パッケージはデバッグ ID を自動的に処理します)。配布用のパッケージには追加の手順が必要です。