最初のアプリをビルドする

このチュートリアルでは、Windows 上の Visual Studio 2022 または Visual Studio 2022 for Mac 17.4 プレビューで初めての .NET マルチプラットフォーム アプリ UI (.NET MAUI) アプリを作成して実行する方法について説明します。

前提条件

  • Visual Studio 2022 17.3 以降。.NET マルチプラットフォーム アプリ UI ワークロードがインストールされています。 詳細については、「インストール」を参照してください。

アプリを作成する

このチュートリアルでは、Visual Studio 2022 で最初の .NET MAUI アプリを作成し、Android エミュレーターで実行します。

Windows 上で iOS 用の .NET MAUI アプリを開発するには、Mac ビルド ホストが必要です。 特に iOS をターゲットにする必要がなく、Mac がない場合は、代わりに Android または Windows の使用を検討してください。

このチュートリアルでは、Visual Studio で最初の .NET MAUI アプリを作成し、iOS シミュレーターで実行します。

このチュートリアルでは、Visual Studio 2022 で最初の .NET MAUI アプリを作成し、Windows で実行します。

  1. Visual Studio 2022 を起動し、スタート ウィンドウで [ 新しいプロジェクトの作成 ] をクリックして新しいプロジェクトを作成します。

    新しいソリューション。

  2. [新しいプロジェクトの作成] ウィンドウで、[すべてのプロジェクトの種類] ドロップダウンで [MAUI] を選択し、.NET MAUI アプリ テンプレートを選択し、[次へ] ボタンをクリックします。

    テンプレートを選択します。

    注意

    .NET 7 Preview もインストールされている場合、Visual Studio に .NET MAUI のテンプレートが表示されない場合があります。 詳しくは、「Visual Studio に .NET MAUI のテンプレートが表示されない」をご覧ください。

  3. [ 新しいプロジェクトの構成 ] ウィンドウで、プロジェクトに名前を付け、適切な場所を選択し、[ 次へ ] ボタンをクリックします。

    プロジェクトを構成します。

  4. [ 追加情報 ] ウィンドウで、[ 作成 ] ボタンをクリックします。

    追加情報。

  5. プロジェクトが作成され、その依存関係が復元されるまで待ちます。

    復元された依存関係。

  1. Visual Studio のツール バーで、[ デバッグ ターゲット ] ドロップダウンを使用して [Android エミュレーター ] を選択し、[ Android エミュレーター ] エントリを選択します。

    .NET MAUI の Android Emulator デバッグ ターゲットを選択します。

  2. Visual Studio ツール バーで、 Android Emulator ボタンを押します。

    Android エミュレーター ボタン。

    Visual Studio では、既定の Android SDK と Android Emulator のインストールが開始されます。

  3. Android SDK の [ライセンス契約] ウィンドウで、[同意する] ボタンを押します。

    最初の Android SDK ライセンス契約ウィンドウ。

  4. Android SDK の [ライセンス契約] ウィンドウで、[同意する] ボタンを押します。

    [2 番目の Android SDK ライセンス契約] ウィンドウ。

  5. [ ユーザー アカウント制御 ] ダイアログで、[ はい ] ボタンを押します。

    Android SDK ライセンス ユーザー アカウント制御ダイアログ。

  6. [ ライセンスの同意 ] ウィンドウで、[ 同意 する] ボタンを押します。

    Android デバイス ライセンス ウィンドウ。

    Visual Studio によって Android SDK と Android Emulator がダウンロードされるのを待ちます。

  7. Visual Studio ツール バーで、 Android Emulator ボタンを押します。

    Android エミュレーター ボタン。

    Visual Studio では、既定の Android エミュレーターの作成が開始されます。

  8. [ ユーザー アカウント制御 ] ダイアログで、[ はい ] ボタンを押します。

    Android デバイス マネージャーユーザー アカウント制御ダイアログ。

  9. [ 新しいデバイス ] ウィンドウで、[ 作成 ] ボタンを押します。

    [新しい Android デバイス] ウィンドウ。

    Visual Studio が Android エミュレーターをダウンロード、解凍、および作成するまで待ちます。

  10. Android デバイス マネージャー ウィンドウを閉じます。

    Android デバイス マネージャー ウィンドウ。

  11. Visual Studio ツール バーで、 Pixel 5 - API 30 (Android 11.0 - API 30) ボタンを押して、アプリをビルドして実行します。

    Pixel 5 API 30 エミュレーター ボタン。

    Visual Studio によって Android エミュレーターが起動し、アプリがビルドされ、エミュレーターにアプリがデプロイされます。

    警告

    Android エミュレーターのパフォーマンスを最大化するには、ハードウェア アクセラレータを有効にする必要があります。 これを行わないと、エミュレーターの実行速度が非常に遅くなります。 詳細については、「 Android エミュレーター (Hyper-V & HAXM) でハードウェア アクセラレータを有効にする方法」を参照してください。

  12. Android エミュレーターで実行中のアプリで 、[クリック] ボタンを数回押し、ボタンのクリック数が増加していることを確認します。

    Android エミュレーターで実行されているアプリ。

トラブルシューティング

アプリのコンパイルに失敗した場合は、「 既知の問題のトラブルシューティング」を参照してください。問題の解決策が考えられます。 問題が Android エミュレーターに関連している場合は、 Android エミュレーターのトラブルシューティングを参照してください。

  1. Visual Studio ツール バーで、[ デバッグ ターゲット ] ドロップダウンを使用して [フレームワーク ] を選択し、 net6.0-windows エントリを選択します。

    .NET MAUI の Windows マシン デバッグ ターゲットを選択します。

  2. Visual Studio ツール バーで、 Windows マシン ボタンを押してアプリをビルドして実行します。

    Visual Studio で .NET MAUI アプリを実行するボタン。

    開発者モードを有効にしていない場合は、Visual Studio から有効にするように求められます。 [ Windows の開発者モードを有効にする ] ダイアログで、 開発者向けの設定 をクリックして設定アプリを開きます。

    [Windows 開発者モードの有効化] ダイアログ。

    設定アプリで、 開発者モード をオンにし、免責事項に同意します。

    Windows 11設定アプリの開発者モードの切り替え。

    [設定] アプリを閉じて、[ Windows の開発者モードを有効にする ] ダイアログを閉じます。

  3. 実行中のアプリで 、[クリックする ] ボタンを数回押し、ボタンのクリック数が増加していることを確認します。

    Windows で実行されている .NET MAUI アプリ。

トラブルシューティング

アプリのコンパイルに失敗した場合は、「 既知の問題のトラブルシューティング」を参照してください。問題の解決策が考えられます。

  1. Visual Studio で、IDE を Mac ビルド ホストとペアリングします。 詳細については、「 iOS 開発のために Mac とペアリングする」を参照してください。

  2. Visual Studio のツール バーで、[ デバッグ ターゲット ] ドロップダウンを使用して iOS シミュレーター を選択し、特定の iOS シミュレーターを選択します。

    Visual Studio iOS シミュレーターでターゲットをデバッグします。

  3. Visual Studio ツール バーで、選択した iOS シミュレーターの [スタート] ボタンを押して、アプリをビルドして実行します。

    Visual Studio iOS シミュレーターのデバッグ ターゲットの選択。

    Visual Studio によってアプリがビルドされ、Windows 用のリモート iOS シミュレーターが起動され、リモート シミュレーターにアプリがデプロイされます。 Windows 用リモート iOS シミュレーターの詳細については、「Windows 用リモート iOS シミュレーター」を参照してください。

  4. 実行中のアプリで 、[クリックする ] ボタンを数回押し、ボタンのクリック数が増加していることを確認します。

    Mac 上の iOS シミュレーターで実行されている .NET MAUI アプリ。

トラブルシューティング

アプリのコンパイルに失敗した場合は、「 既知の問題のトラブルシューティング」を参照してください。問題の解決策が考えられます。

Mac Catalyst をターゲットとする .NET MAUI アプリは、Visual Studio 2022 for Mac 17.4 Preview を使用してのみ起動およびデバッグできます。

次のステップ

このチュートリアルでは、最初の .NET マルチプラットフォーム アプリ UI (.NET MAUI) アプリを作成して実行する方法について説明しました。

.NET MAUI を使用してアプリを構築する際の基礎については、「 .NET MAUI アプリを作成する」を参照してください。