1. IDEのダウンロードとインストール
Visual Studio 2022 プレビュー版をまだインストールしていない場合は、以下の手順に従ってください。
インストールプロセス中は、.NETクロスプラットフォームアプリケーションUI開発を選択する必要があります。
既にVisual Studio 2022プレビュー版をお持ちの場合は、.NET MAUIサポートを追加するために更新できます。
2. アプリケーションの作成
- Visual Studio 2022プレビュー版を開きます。
- 「新しいプロジェクトを作成」ボタンを選択します。
- プロジェクトタイプのドロップダウンリストから「MAUI」を選択します。
- 「.NET MAUI App」テンプレートを選択し、「次へ」ボタンをクリックします。
- プロジェクト名として「MyFirstMauiApp」を入力し、「作成」ボタンをクリックします。
NuGetパッケージの復元
NuGetがアプリケーションの依存関係を自動的に復元するのを待ちます。画面左下のステータスバーに「復元済み」または「準備完了」のメッセージが表示されるまでお待ちください。
3. アプリケーションの実行
このチュートリアルでは、まず.NET MAUIアプリケーションをローカルWindowsコンピューターにデプロイする方法に焦点を当てます。後で、Androidデバイスまたはエミュレータを設定することを選択できます。
Windows開発の設定
Windowsアプリケーションを開発するには、Windows 11またはWindows 10でアプリケーションのサイドロードを許可するために、開発者モードを有効にする必要があります。
開発者モードの有効化
- Windowsで「設定」アプリケーションに移動します。
- Windows 11では「プライバシーとセキュリティ」、Windows 10では「更新とセキュリティ」で「開発者設定」を検索します。
- 「開発者モード」の下にあるトグルスイッチをオンにします。
- 「開発者機能を使用する」ダイアログが表示されます。「はい」を選択して、開発者モードを有効にすることを確認します。
Windowsでの実行
これで.NET MAUIアプリを実行してWindowsにデプロイする準備が整いました。ツールバーでは、デバッグ対象として「Windowsマシン」がデフォルトで選択されています。
「デバッグ」→「デバッグ開始」（F5）を選択します。
4. コードの編集
.NET MAUIを使用して開発する場合、デバッグ中にXAMLホットリロードを使用できます。これにより、実行時にXAMLユーザーインターフェースを変更し、UIが自動的に更新されます。
ソリューションエクスプローラーで、MyFirstMauiAppプロジェクトのMainPage.xamlファイルをダブルクリックします。
現在、最初のLabelのTextはHello, World!に設定されています：
<Label
Text="Hello, World!"
SemanticProperties.HeadingLevel="Level1"
FontSize="32"
HorizontalOptions="Center" />
テキストをHello, .NET MAUI!に更新します：
<Label
Text="Hello, .NET MAUI!"
SemanticProperties.HeadingLevel="Level1"
FontSize="32"
HorizontalOptions="Center" />
UIは自動的に更新されます。
.NET MAUIを使用して開発する場合、.NETホットリロードを使用してC#コードも再読み込みできます。プログラムのロジックを変更し、カウントを1ではなく10増やしてみましょう。
MainPage.xaml.csファイルを開きます（このファイルはMainPage.xamlの下にネストされているか、右クリックしてメニューから「コードの表示」を選択できます）。
OnCounterClickedメソッド上の現在のコードは次のとおりです：
private void OnCounterClicked(object sender, EventArgs e)
{
count++;
if (count == 1)
CounterBtn.Text = $"Clicked {count} time";
else
CounterBtn.Text = $"Clicked {count} times";
SemanticScreenReader.Announce(CounterBtn.Text);
}
count++;をcount += 10;に変更して、10増やすように更新します：
private void OnCounterClicked(object sender, EventArgs e)
{
count += 10;
if (count == 1)
CounterBtn.Text = $"Clicked {count} time";
else
CounterBtn.Text = $"Clicked {count} times";
SemanticScreenReader.Announce(CounterBtn.Text);
}
コードの変更を適用するには、Visual Studioでホットリロードボタンを選択するか、ALT+F10を選択します。
「クリックしてください」ボタンを選択すると、10増加していることがわかります。
5. Androidデバイスの設定
開発環境に応じて、複数のプラットフォームにデプロイするかどうかを決定できます。先ほどWindowsで実行してデプロイしました。次に、Androidデバイスまたはエミュレータを設定してみましょう。
Android SDKのインストール
デバッグドロップダウンメニューから、フレームワークのnet6.0-androidを選択します。
プロジェクトのビルドには特定のバージョンのAndroid SDKが必要です。まだAndroid SDKライセンスに同意していない場合、エラーリストウィンドウに次のエラーメッセージが表示されます。
メッセージをダブルクリックして、ライセンス受け付けプロセスを開始します。存在する各ライセンスに対して「受け入れる」をクリックすると、自動インストールが開始されます。
Androidエミュレータの設定
デプロイするAndroidデバイスがない場合は、Androidエミュレータを設定できます。既に設定している場合は、このステップをスキップしてください。
.NET MAUIアプリケーションを初めてビルドする場合、デバッグメニューに「Android Emulator」が表示されます。クリックして作成プロセスを開始します。
これにより、ユーザーアカウント制御のプロンプトが表示されます。「はい」ボタンを選択すると、エミュレータの作成プロセスが開始されます。デフォルト設定を使用してエミュレータを作成するには、「作成」ボタンを選択します。
この時点で、Androidエミュレータのライセンス契約に同意するように求められる場合があります。「受け入れる」を選択してプロセスを続行し、エミュレータイメージをダウンロードしてエミュレータの作成を完了します。エミュレータが作成されると、「開始」が表示されるボタンが表示されます。クリックします。
Windowsハイパーバイザープラットフォームの有効化を求めるメッセージが表示される場合があります。パフォーマンスを向上させるために（強く推奨）、ドキュメントに従って有効化します。
Androidエミュレータが起動します。完全に起動するまで待ち、Visual Studioのデバッグメニューに表示されていることがわかります。
Androidエミュレータが作成され、使用できるようになりました。次回Visual Studioを実行すると、デバッグ対象ウィンドウにエミュレータが直接表示され、選択すると起動します。
Androidデバイスの設定
Androidデバイスを使用して開発するには、USBデバッグを有効にする必要があります。デバイス上でこれらの手順に従って、Visual Studioに接続します。Androidデバイスがない場合は、このセクションをスキップできます。
開発者モードの有効化
- 「設定」画面に移動します。
- 設定画面の上部を使用して「ビルド番号」を検索するか、「この端末について」で見つけます。
- 「ビルド番号」を7〜10回クリックします。「あなたは今開発者です！」というポップアップが表示されるまで続けます。
- 「OK」をクリックします。
USBデバッグ状態の確認
- 「設定」画面に移動します。
- 設定画面の上部を使用して「USBデバッグ」を検索するか、「開発者オプション」で見つけます。
- 「USBデバッグ」がまだ有効になっていない場合は、有効にします。
デバイスの信頼
- デバイスをコンピューターに接続します。
- システムが「USBデバッグを許可しますか？」とプロンプトを表示します。
- 「このコンピューターから常に許可」にチェックを入れます。
- 「許可」をクリックします。
デバイスが設定され、Visual Studioにデプロイ対象として表示されます。
Androidでの実行
デバイスまたはエミュレータがデバッグ対象として選択されていることを確認します。
メニューから「デバッグ」→「デバッグ開始」（F5）を選択します。オプションが無効になっている場合は、エミュレータまたはデバイスが選択されていることを確認してください。
アプリケーションがビルドされ、選択したAndroidデバイス/エミュレータにデプロイされ、実行されます。