チュートリアル: XAML と C を使用して Visual Studio で初めての Windows App SDK アプリケーションを作成する#

この Visual Studio 統合開発環境 (IDE) の概要では、Windows 10 以降のデバイスで実行される "Hello World" アプリを作成します。 そのためには、Windows App SDK (WinUI 3) プロジェクト テンプレート、拡張アプリケーション マークアップ言語 (XAML)、および C# プログラミング言語を使用します。

手記

WinUI 3 は、Windows App SDK に付属するネイティブ UI プラットフォーム コンポーネントです (Windows SDKから完全に切り離されています)。 詳細については、「WinUI 3 を参照してください。

Visual Studio をまだインストールしていない場合は、Visual Studio のダウンロード ページに移動して無料でインストールします。

前提 条件

  • このチュートリアルを完了するには、Visual Studio が必要です。 無料版については、Visual Studio のダウンロード ページ を参照してください。

  • WinUI と Windows App SDK を使用した開発に必要なワークロードとコンポーネント。 Visual Studio でワークロードを確認またはインストールするには、[ツール] >[ツールと機能の取得]を選択します。 詳細については、「ワークロードまたは個々のコンポーネント変更する」を参照してください。

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

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

プロジェクトを作成する

まず、WinUI 3 プロジェクトを作成します。 プロジェクトの種類には、何も追加する前に、必要なすべてのテンプレート ファイルが付属しています。

重要

Visual Studio 2019 では、Windows App SDK 1.1 以前のみがサポートされています。 Visual Studio 2022 は、すべてのバージョンの Windows App SDK を使用してアプリを開発する場合に推奨されます。

Windows App SDK 1.1.x テンプレートは、Visual Studio 拡張機能 (VSIX)をインストールすることで利用できます。

手記

Windows App SDK Visual Studio 拡張機能 (VSIX) が既にインストールされている場合は、別のバージョンをインストールする前にアンインストールしてください。 手順については、「Visual Studioの拡張機能を管理する」を参照してください。

  • Visual Studio から最新の安定した 1.1.x リリース VSIX をインストールできます。 拡張機能>拡張機能の管理を選択し、Windows App SDKを検索して、Windows App SDK 拡張機能をダウンロードします。 Visual Studio を閉じて再度開き、画面の指示に従って拡張機能をインストールします。 Windows App SDK 1.1 用のテンプレートをインストールしてください。
  • または、Visual Studio Marketplace から直接拡張機能ダウンロードしてインストールすることもできます。

テンプレート拡張機能がインストールされたら、最初のプロジェクトを作成できます。 Visual Studio 2019 のサポートの詳細については、「Windows App SDK用のツールをインストールする」を参照してください。 このチュートリアルの残りの部分では、Visual Studio 2022 を使用していることを前提としています。

  1. Visual Studio を開き、スタート ウィンドウで [新しいプロジェクト の作成]選択します。

  2. [新しいプロジェクトの作成] 画面で、検索ボックスに「WinUI」と入力し、[空のアプリ、パッケージ化 (デスクトップの WinUI 3)] 用の C# テンプレートを選択して、[次へ] を選択します。

    [新しいプロジェクトの作成] ダイアログのスクリーンショット。検索ボックスに「WinUI」と入力され、[空のアプリ、パッケージ化 (デスクトップの WinUI 3)] プロジェクト テンプレートが強調表示されています。

  3. プロジェクトに HelloWorldという名前を付け、作成を選択します。

    [プロジェクト名] フィールドに 「HelloWorld」と入力された [新しいプロジェクトの構成] ダイアログのスクリーンショット。

    手記

    Visual Studio を初めて使用して Windows App SDK アプリを作成する場合は、[の設定] ダイアログ ボックスが表示されることがあります。 [開発者モード ] を選択し、次に [はい ] を選択します。

    開発者モードを有効にするオプションが表示された [設定] ダイアログ ボックスを示すスクリーンショット。

    Visual Studio によって追加の開発者モード パッケージがインストールされます。 パッケージのインストールが完了したら、[設定] ダイアログ ボックスを閉じます。

アプリケーションを作成する

開発を始めましょう。 ボタン コントロールを追加し、そのボタンにアクションを追加し、"Hello World" アプリを実行して外観を確認します。

デザイン キャンバスにボタンを追加する

  1. ソリューション エクスプローラーで、MainWindow.xaml ダブルクリックして XAML マークアップ エディターを開きます。

    HelloWorld プロジェクトのプロパティ、参照、アセット、ファイルを示すソリューション エクスプローラー ウィンドウのスクリーンショット。MainWindow.xaml ファイルが選択されています。

    XAML エディター では、マークアップを追加または変更できます。 UWP プロジェクトとは異なり、WinUI 3 には デザイン ビューはありません。

    Visual Studio IDE で開いている MainWindow.xaml を示すスクリーンショット。[XAML エディター] ウィンドウには、ウィンドウの XAML マークアップが表示されます。

  2. ウィンドウのルートにある StackPanel にネストされた Button コントロールをレビューします。

    XAML エディターで [ボタン] が強調表示されているスクリーンショット。

ボタンのラベルを変更する

  1. XAML エディターので、[ボタンのコンテンツ] の値を [クリックしてください] から [Hello World!] に変更します。

    XAML エディターの Button の XAML コードを示すスクリーンショット。Content プロパティの値が 'Hello World!' に変更されました。

  2. ボタンに Click イベント ハンドラー myButton_Click 指定されていることにも注意してください。 これについては、次の手順で説明します。

    XAML エディターの Button の XAML コードを示すスクリーンショット。ボタンのクリック イベントが強調表示されています。

イベント ハンドラーを変更する

"イベント ハンドラー" は複雑に思われますが、イベントが発生したときに呼び出されるコードの名前にすぎません。 この場合、"Hello World!" ボタンによってトリガーされるアクションが追加されます。

  1. ソリューション エクスプローラー で、コードビハインド ページの MainWindow.xaml.csをダブルクリックします。

  2. 開いた C# エディター ウィンドウでイベント ハンドラー コードを編集します。

    ここで興味深いものが得られます。 既定のイベント ハンドラーは次のようになります。

    既定のmyButton_Click イベント ハンドラーの C# コードを示すスクリーンショット。

    これを変更してみましょう。次のようになります。

    新しい非同期myButton_Click イベント ハンドラーの C# コードを示すスクリーンショット。

    コピーして貼り付けるコードを次に示します。

    private async void myButton_Click(object sender, RoutedEventArgs e)
    {
        var welcomeDialog = new ContentDialog()
        {
            Title = "Hello from HelloWorld",
            Content = "Welcome to your first Windows App SDK app.",
            CloseButtonText = "Ok",
            XamlRoot = myButton.XamlRoot
        };
        await welcomeDialog.ShowAsync();
    }
    

私たちは何をしましたか?

このコードでは、ContentDialog コントロールを使用して、現在のウィンドウ内のモーダル ポップアップ コントロールにウェルカム メッセージを表示します。 (Microsoft.UI.Xaml.Controls.ContentDialogの使用の詳細については、「ContentDialog クラスの」を参照してください)。

アプリケーションを実行する

次に、"Hello World" Windows アプリ SDK アプリをビルド、デプロイ、起動して、その外観を確認します。 その方法を次に示します。

  1. [再生] ボタン (HelloWorld (パッケージ) テキスト) を使用して、ローカル コンピューターでアプリケーションを起動します。

    [HelloWorld (パッケージ)]が選択されている [再生] ボタンの横にドロップダウン ボックスが開いているスクリーンショット。

    (または、メニュー バーから [デバッグ] >[デバッグの開始]選択するか、F5 キー 押してアプリを起動することもできます)。

  2. スプラッシュ画面が消えた直後に表示されるアプリを表示します。 アプリは次の画像のようになります。

    実行中の Windows App SDK 'Hello World' アプリケーションを示すスクリーンショット。

  3. Hello World ボタンを選択します。

    Windows 10 以降のデバイスに、"Hello from HelloWorld" というタイトルの "最初の Windows App SDK アプリへようこそ" というメッセージが表示されます。[ok] クリックして、メッセージを閉じます。

    実行中の

  4. アプリを閉じるには、ツール バーの [デバッグの停止] ボタンを選択します。 (または、メニュー バー [デバッグ]>[デバッグの停止] を選択するか、Shift キー 押しながら F5 キーを押) を選択します。

次の手順

このチュートリアルを完了しておめでとうございます。 Windows App SDK、WinUI 3、および Visual Studio IDE に関するいくつかの基本を学習していただければ幸いです。 詳細については、次のチュートリアルに進んでください。

チュートリアル: WinUI 3 を使用して簡単なフォト ビューアーを作成する

関連項目