WinUI の概要

WinUI を使用したアプリの開発へようこそ。 このガイドでは、開始するために必要な手順について説明します。 また、Windows 開発の詳細を学習するのに役立つリソースも示します。

1. Visual Studio のインストール

Microsoft の包括的な統合開発環境 (IDE) である Visual Studio を使用して、WinUI アプリを作成します。 これは多くの Windows 開発者に好まれている開発ツールであり、アプリの作成、デバッグ、デプロイに役立ちます。 Visual Studio のプロジェクト テンプレートを使用すると、Windows や多くのその他プラットフォーム向けのプロジェクトをすぐに開始できます。

ヒント

これらのツールをインストールする前に、開発用コンピューターが Windows アプリ開発のシステム要件を満たしていることを確認します。

このリンクを使用して Visual Studio をダウンロードし、インストールします。 インストーラーで手順が示されますが、詳細な手順が必要な場合は、「Visual Studio のインストール」を参照してください。

無料の Visual Studio Community Edition には、アプリを作成するために必要なものがすべて含まれています。 開発チームまたはエンタープライズと連携している場合は、Visual Studio Professional または Visual Studio Enterprise が必要になる場合があります。 詳細については、「Visual Studio とは」を参照してください。

必要なワークロードとコンポーネント

Visual Studio をインストールするときに、WinUI と Windows アプリ SDK を使用した開発に必要なワークロードとコンポーネントをインストールする必要があります。 ワークロードとコンポーネントを追加するには、インストール後、Visual Studio インストーラー アプリを開き、[変更] を選択します。

Visual Studio インストーラー アプリの [ワークロード] タブで、次のワークロードとコンポーネントを選択します。

  • Windows アプリ SDK を使用した C# アプリの開発の場合は、[Windows アプリケーション開発] を選びます。

Windows アプリケーション開発ワークロードが選択された状態の Visual Studio インストーラー UI のスクリーンショット。

  • Windows アプリ SDK を使用した C++ アプリの開発の場合は、[Windows アプリケーション開発] を選びます。
    • 次に、[インストールの詳細] ウィンドウの [Windows アプリケーション開発] ノードで、[C++ WinUI アプリ開発ツール] を選択します。 (これにより、追加の必須コンポーネントも選択されます)

C++ WinUI アプリ開発ツールが選択されている状態の Visual Studio インストーラー UI のスクリーンショット。

2. 開発者モードを有効にする

Windows には、作業中のアプリを実行できるようにするために、セキュリティ設定を調整する開発者向けの特殊モードがあります。 Visual Studio を使用してアプリをビルド、デプロイ、テストするには、開発者モードを有効にする必要があります。

ヒント

ここで有効にしない場合は、Visual Studio でアプリをビルドしようとしたときに有効にするように求められます。

開発者モードを有効にするには:

  • Windows 設定を開き、[システム] > [開発者用] ページに移動します。
  • [開発者モード] スイッチを [オン] に切り替え、確認ダイアログで選択内容を確認します。

開発者モードの詳細については、「デバイスを開発用に有効にする」を参照してください。

3. 最初の WinUI アプリを作成して起動する

Visual Studio プロジェクト テンプレートには、アプリをすばやく作成するために必要なファイルがすべて含まれています。 実際、WinUI アプリ テンプレートからプロジェクトを作成すると、実行できるアプリが既に作成され、コードを追加できます。

[WinUI C# の空のアプリ] プロジェクト テンプレートを使用して新しいプロジェクトを作成するには:

  1. Visual Studio を起動し、起動ページから [新しいプロジェクトの作成] を選択します。 (Visual Studio が既にエディターで開いている場合は、[ファイル]>[新規]>[プロジェクト] を選択します):新しいプロジェクトの作成

  2. WinUI を検索して Blank App, Packaged (WinUI 3 in Desktop) C# プロジェクト テンプレートを選択し、[次へ] をクリックします。空のパッケージ化された WinUI 3 C# デスクトップ アプリ

  3. プロジェクト名を指定して、[作成] をクリックします。 必要に応じて、ソリューション名とディレクトリを指定することも、既定値のままにすることもできます。 この画像では、Hello World プロジェクトは Hello World ソリューションに属しており、C:\Projects\ に存在しています。プロジェクトの詳細を指定する

  4. [デバッグ] の [スタート] ボタンをクリックして、プロジェクトをビルドして実行します。
    プロジェクトをビルドして実行する
    Hello World プロジェクトがビルドされ、ローカル コンピューターにデプロイされ、デバッグ モードで実行されます。
    Hello World プロジェクトのビルドと実行

  5. デバッグを停止するには、アプリ ウィンドウを閉じるか、Visual Studio でデバッグの [停止] ボタンをクリックします。

4. 最新の WinUI/Windows アプリ SDK に更新する

Windows アプリ SDK (およびその一部である WinUI) は、NuGet パッケージとして配布されます。 つまり、更新プログラムは Windows および Visual Studio と同期しないでリリースされる可能性があります。 その結果、プロジェクトの作成に使用した Visual Studio テンプレートは、最新の Windows アプリ SDK NuGet パッケージを参照しない場合があります。 最新の機能と修正を確実に入手するには、Visual Studio で新しいプロジェクトを作成するたびに NuGet パッケージを更新する必要があります。

プロジェクトの Windows アプリ SDK NuGet パッケージを更新するには:

  • Visual Studio ソリューションで、プロジェクトが読み込まれた状態で、[ツール]>[NuGet パッケージ マネージャー]>[ソリューションの NuGet パッケージを管理...] を選択します。
  • 更新プログラムが利用可能な場合は、[更新] ページに表示されます。 一覧表示されている更新プログラムの横にあるチェック ボックスをオンにします。 (プレリリースの更新プログラムを含めるには、[プレリリースを含める] オプションをチェックします。更新プログラムに含まれる内容の詳細については、リリース ノートを参照してください)
  • [更新] ボタンをクリックして、[変更のプレビュー] ダイアログで [適用] をクリックし、ライセンス条項に同意して更新プログラムのインストールを完了します。

Windows アプリ SDK パッケージの更新を示す Visual Studio の NuGet パッケージ マネージャーのスクリーンショット。

これで、使用可能な最新の WinUI 機能がプロジェクトで使用できるようになり、独自の WinUI 機能を作成する準備が整いました。

次のステップ

  • チュートリアルを完了して、Hello World アプリにコードを追加します。
  • WinUI で提供する必要がある内容を確認するには、WinUI ギャラリー アプリをチェックします。

    WinUI 3 ギャラリー アプリには、ほとんどの WinUI 3 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。

  • WinUI Fundamentals の詳細を学びます。
  • Fluent Design の原則を確認します。
  • アプリをより効率的に開発するのに役立つサンプルとツールを見つけます。