.NET MAUI チュートリアル - C# で初めてのマルチプラットフォーム アプリを構築する

モバイル デバイスで実行する

開発環境に基づいて、1 つ以上のプラットフォームに配置できます。アプリを実行して Windows に展開しました。次に、Android デバイスまたはエミュレーターを設定しましょう。

Hyper-V のアクティブ化

Windows Search バーに「Windows 機能」と入力し、[Windows 機能をオンまたはオフにする] を選択します。

Windows 機能のオンとオフを切り替える

[Hyper-V] ボックスがオンになっていることを確認し、[OK] を選択します。

[Hyper-v] チェック ボックスがオンになっている Windows 機能

変更を有効にするには、この時点でコンピューターを再起動する必要があります。

Android SDK のインストール

Visual Studio と MyFirstMauiApp ソリューションを開きます。デバッグ ターゲットのドロップダウン メニューから、[フレームワーク] の下の [net8.0-android] を選択します。

デプロイ ターゲットとして Android を選択する

プロジェクトをビルドするには、Android SDK の特定のバージョンが必要です。Android SDK ライセンスに同意していない場合は、[エラー一覧] ウィンドウに次のエラー メッセージが表示されます。

[エラー一覧] ウィンドウに、Android SDK ライセンスが同意されていないことを示すエラー メッセージが表示されます。

メッセージをダブルクリックして、ライセンスへの同意プロセスを開始します。表示された各ライセンスに対して[同意する]をクリックすると、自動インストールが開始されます。

Android SDK プロンプトが表示され、ユーザーは特定の Android SDK バージョンをインストールしてプロジェクトをビルドするよう求められます。

Android Emulator の設定

展開先の Android デバイスがない場合は、次のステップに従って Android エミュレーターを設定できます。既にこれを行っているか、独自の Android デバイスを使用する場合は、このステップをスキップできます。

.NET MAUI アプリケーションを初めてビルドする場合は、デバッグ ターゲットのドロップダウン メニューで Android Emulator が表示されます。クリックして作成プロセスを開始します。ライセンス受け入れダイアログが表示されたら、同意するを選択します。

Visual Studio 2022 ツールバー メニューには、デバッグ ターゲットとして

"新しいデバイス" ウィンドウが表示されます。[作成] ボタンを選択して、既定の設定でエミュレーターを作成します。これにより、エミュレーター イメージがダウンロードされ、Visual Studio で使用するエミュレーターの作成が完了します。このステップには時間がかかる場合があります。

表示される API レベルが画像と異なる場合でも、心配はいりません。API レベルが 33 以上になる場合もあります。

ダイアログが表示され、既定の設定が反映された新しい Android Emulator を作成します。

エミュレーターが作成されると、スタート というボタンが表示されます。それをクリックします。

エミュレーターが作成され、実行する準備が整ったことを Android Emulator マネージャーが示しています。

Windows ハイパーバイザー プラットフォームを有効にするように求めるメッセージが表示される場合があります。ドキュメントに従って、パフォーマンスを向上させるために高速化を有効にします (エミュレーターを起動して実行するために必要です)。[[実行] を選択します。

Windows ハイパーバイザー プラットフォームを有効にするように求めるメッセージを表示する

Android エミュレーターが起動し、Android デバイス マネージャーに停止機能が表示されると、エミュレーターが完全に終了します。これには時間がかかる場合があります。

新たに作成した Android Emulator をデバッグ ターゲットとして表示する Visual Studio 2022 ツールバー メニュー。

ビルドが完全に終了すると、Visual Studio の [デバッグ] メニューに表示されます。

新たに作成した Android Emulator をデバッグ ターゲットとして表示する Visual Studio 2022 ツールバー メニュー。

Android emulator が作成され、使用できるようになりました。次回 Visual Studio を実行するときに、エミュレーターはデバッグ ターゲット ウィンドウに直接表示され、選択すると開始します。エミュレーターの使用中に問題が発生した場合やパフォーマンスの問題が発生した場合は、完全なセットアップ ドキュメント をお読みください。

Android デバイスの設定

Android デバイスを使用して開発するには、USB デバッグを有効にする必要があります。デバイスで以下の手順に従い、Visual Studio に接続します。Android デバイスをお持ちでない場合は、このセクションはスキップしても構いません。

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

  1. [設定] 画面に移動します。
  2. 設定画面の上部にある検索を使用してビルド番号を検索するか、[携帯電話情報] で検索します。
  3. "開発者になりました!" と表示されるまで、ビルド番号 を 7 回から 10 回タップします。

Android デバイスの設定画面で、携帯電話に関する画面にビルド番号が表示されています。

USB デバッグ状態の確認

  1. [設定] 画面に移動します。
  2. 設定画面の上部にある検索を使用して [USB デバッグ] を検索するか、[開発者向け] オプションで検索します。
  3. USB デバッグ が有効になっていない場合は、有効にします。

Android デバイスの設定画面の開発者設定についての画面で、USB デバッグ オプションがオンになっています。

デバイスを信頼する

  1. デバイスをコンピューターに接続します。
  2. USB デバッグを許可するかどうか確認するメッセージが表示されます。
  3. このコンピューターで常に許可 であることを確認します。
  4. [許可] をクリックします。

Android デバイス プロンプトで、コンピューターからデバイス上で USB デバッグできるようにします。

デバイスが構成され、配置ターゲットとして Visual Studio に表示されるようになりました。

問題はありませんか? ドキュメントを確認します

これで、エミュレーターやデバイスが展開用に構成されているはずです。

Android で実行

デバイスまたはエミュレーターがデバッグ ターゲットとして選択されていることを確認します。

5 Android エミュレーター ピクセル 5 はデバッグ ターゲットとして設定されています。

メニューから、[デバッグ] > [デバッグの開始]を選択します (またはF5 キーを押す)。このオプションが無効になっている場合は、エミュレーターまたはデバイスが選択されていることを確認してください。

アプリケーションがビルドされ、選択された Android デバイスまたは Android Emulator に展開されて実行されます。

.NET MAUI アプリを実行している Android エミュレーター。

開発環境に基づいて、1 つ以上のプラットフォームに配置できます。アプリを実行して macOS に展開しました。次に、iOS にデプロイしましょう。

実行していた .NET MAUI アプリケーションを閉じて、VS Code に戻ります。

ステータス バーの VS Code ウィンドウの右下にある中かっこをクリックし、デバッグ ターゲット を選択します。

既定でターゲット展開として選択された My Mac

下にスクロールし、iPhone 15 を選択します。

iPhone 15 が強調表示されたデバッグ ターゲットリスト

これで、新しいデバッグ ターゲットとして iOS: iPhone 15 が表示されるはずです。

iPhone 15 を表示するようにデバッグ ターゲットが更新されました

アプリを実行するには、VS Code アクティビティ バーの Run and Debug アイコンをクリックします。次に Run and Debug をクリックします。

VS Code の実行とデバッグ ウィンドウ

アプリケーションがビルドされ、iPhone シミュレーターにデプロイされます。これは少し時間がかかる場合があります。iPhone を実質的にオンにしているためです!

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

続行