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

[アーティクル]
02/18/2023

このチュートリアルでは、Windows 上の Visual Studio 2022 または Visual Studio 2022 for Mac で初めての .NET マルチプラットフォームアプリ UI (.NET MAUI) アプリを作成して実行する方法について説明します。これは、開発環境が正しくセットアップされていることを確認するのに役立ちます。

Visual Studio
Visual Studio for Mac

前提条件

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 で実行します。

Visual Studio 2022 を起動し、スタートウィンドウで [ 新しいプロジェクトの作成 ] をクリックして新しいプロジェクトを作成します。
[新しいプロジェクトの作成] ウィンドウで、[すべてのプロジェクトの種類] ドロップダウンで [MAUI] を選択し、[.NET MAUI アプリ] テンプレートを選択し、[次へ] ボタンをクリックします。
[ 新しいプロジェクトの構成] ウィンドウで、プロジェクトに名前を付け、適切な場所を選択して、[ 次へ ] ボタンをクリックします。
[ 追加情報 ] ウィンドウで、ターゲットにする .NET のバージョンを選択し、[ 作成 ] ボタンをクリックします。
プロジェクトが作成され、その依存関係が復元されるまで待ちます。

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

Visual Studio では、既定の Android SDK と Android Emulator のインストールが開始されます。
[Android SDK - ライセンス契約] ウィンドウで、[同意する] ボタンを押します。
[Android SDK - ライセンス契約] ウィンドウで、[同意する] ボタンを押します。
[ ユーザーアカウント制御 ] ダイアログで、[ はい ] ボタンを押します。
[ ライセンスの同意 ] ウィンドウで、[ 承諾 ] ボタンを押します。

Visual Studio によって Android SDK と Android Emulator がダウンロードされるのを待ちます。
Visual Studio のツールバーで、[ Android エミュレーター ] ボタンを押します。

Visual Studio によって、既定の Android エミュレーターの作成が開始されます。
[ ユーザーアカウント制御 ] ダイアログで、[ はい ] ボタンを押します。
[ 新しいデバイス ] ウィンドウで、[ 作成 ] ボタンを押します。

Visual Studio が Android エミュレーターをダウンロード、解凍、作成するまで待ちます。
Android デバイスマネージャー ウィンドウを閉じます。
Visual Studio ツールバーで、 Pixel 5 - API 30 (Android 11.0 - API 30) ボタンを押して、アプリをビルドして実行します。

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

警告

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

トラブルシューティング

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

Visual Studio のツールバーで、[ デバッグターゲット ] ドロップダウンを使用して [ フレームワーク ] を選択し、 次に net6.0-windows エントリを選択します。
Visual Studio ツールバーで、 Windows マシン ボタンを押してアプリをビルドして実行します。

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

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

[設定] アプリを閉じ、[ Windows の開発者モードを有効にする] ダイアログを閉じます。
実行中のアプリで 、[クリック ] ボタンを数回押し、ボタンのクリック数が増加していることを確認します。

トラブルシューティング

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

Visual Studio で、IDE を Mac ビルドホストとペアにします。詳細については、「 iOS 開発用に Mac とペアリングする」を参照してください。
Visual Studio ツールバーの [ デバッグターゲット ] ドロップダウンを使用して、[ iOS シミュレーター ] を選択し、次に特定の iOS シミュレーターを選択します。
Visual Studio ツールバーで、選択した iOS シミュレーターの [スタート] ボタンを押して、アプリをビルドして実行します。

Visual Studio によってアプリがビルドされ、Windows 用のリモート iOS シミュレーターが起動され、リモートシミュレーターにアプリがデプロイされます。 Windows 用リモート iOS シミュレーターの詳細については、「Windows 用リモート iOS シミュレーター」を参照してください。
実行中のアプリで 、[クリック ] ボタンを数回押し、ボタンのクリック数が増加していることを確認します。