.NET MAUI iOS アプリのワイヤレス デプロイメント

  • [アーティクル]

Visual Studio と Visual Studio for Mac では、.NET マルチプラットフォーム アプリ UI (.NET MAUI) アプリをデプロイおよびデバッグするために、USB ケーブルを使用して iOS デバイスを Mac に接続する必要はなく、.NET MAUI iOS アプリをデバイスにワイヤレスでデプロイし、ワイヤレスでデバッグできます。 これを行うには、iOS デバイスを Mac 上の Xcode とペアリングする必要があります。 ペアリングすると、Visual Studio と Visual Studio for Mac のデバイス ターゲット リストからデバイスを選択できます。

重要

.NET MAUI iOS アプリをデバイスにデプロイしてテストとデバッグを行うには、まずアプリのプロビジョニングが完了している必要があります。 詳細については、「iOS のデバイス プロビジョニング」を参照してください。

iOS デバイスをペアリングする

iOS デバイスを Mac 上の Xcode とペアリングするには、次の手順を実行します。

  1. iOS デバイスが Mac と同じワイヤレス ネットワークに接続されていることを確認します。

  2. USB ケーブルを使用して、iOS デバイスを Mac に接続します。

    Note

    iOS デバイスを Mac に初めて接続するときは、デバイスの [このコンピューターを信頼する] ダイアログの [信頼] ボタンをタップする必要があります。

  3. Xcode を開き、[ウィンドウ] > [デバイスとシミュレーター] をクリックします。 表示されたウィンドウで、[デバイス] をクリックします。

  4. [デバイスとシミュレーター] ウィンドウの左側の列で、デバイスを選択します。 次に、詳細領域で、[ネットワーク経由で接続] チェックボックスを選択します。

    Screenshot of Devices and Simulators window showing Connect via network option.

    Xcode が iOS デバイスとペアリングします。

  5. [デバイスとシミュレーター] ウィンドウの左側の列で、ペアリングされている接続済みデバイスの横にネットワーク アイコンが表示されます。

    Screenshot of Devices and Simulators window showing a paired iOS device.

  6. USB ケーブルを取り外し、デバイスがペアリングされたままであることを確認します。

Xcode はペアリング設定を保持するので、デバイスを再びペアリングする必要はありません。

iOS デバイスのペアリングを解除する

Mac 上の Xcode から iOS デバイスのペアリングを解除するには、次の手順を実行します。

  1. iOS デバイスが Mac と同じワイヤレス ネットワークに接続されていることを確認します。

  2. Xcode を開き、[ウィンドウ] > [デバイスとシミュレーター] をクリックします。 表示されたウィンドウで、[デバイス] をクリックします。

  3. [デバイスとシミュレーター] ウィンドウの左側の列で、ペアリングされているデバイスを選択します。 次に、デバイスを右クリックし、[デバイスのペアリング解除] 項目を選択します。

    Screenshot of Devices and Simulators window showing a paired iOS device about to be unpaired.

デバイスにデプロイする

デバイスを Xcode にワイヤレスでペアリングしたら、プロビジョニングされた .NET MAUI iOS アプリをデバイスにワイヤレスでデプロイできます。

  1. iOS デバイスが Mac ビルド ホストとワイヤレスでペアリングされていることを確認します。 詳細については、「iOS デバイスをペアリングする」をご覧ください。

  2. Visual Studio で、IDE が Mac ビルド ホストとペアリングされていることを確認します。 詳細については、「iOS 開発のために Mac とペアリングする」をご覧ください。

  3. Visual Studio のツール バーで、[デバッグ ターゲット] ドロップダウンを使用して [iOS リモート デバイス] を選択し、Mac ビルド ホストに接続されているデバイスを選択します。

    Select your remote device in Visual Studio.

  4. Visual Studio ツール バーで、緑色の [スタート] ボタンを押して、リモート デバイスでアプリを起動します。

    Visual Studio iOS device debug target choice.

Note

.NET MAUI iOS アプリをデバイスにデプロイする別の方法は、ホット再起動を使用することです。 ホット再起動を使用すると、Mac ビルド ホストを必要とせずに、Visual Studio から 64 ビットのローカル iOS デバイスに .NET MAUI アプリをデプロイできます。 詳細については、「ホット再起動を使用して iOS アプリをデプロイする」を参照してください。

トラブルシューティング

  • 使用する iOS デバイスが Mac と同じネットワークに接続されていることを確認します。
  • デバイスがプロビジョニングされていることを確認します。 プロビジョニングの詳細については、「iOS 用デバイス プロビジョニング」をご覧ください。
  • Xcode でデバイスが表示されることを確認します。
    • Xcode で [ウィンドウ] > [デバイスとシミュレーター] を選択し、表示されたウィンドウで [デバイス] をクリックします。 デバイスが [接続済み] の下に表示されます。
  • デバイスに ping を実行します。

    • デバイスの IP アドレスを確認します。 デバイスで [設定] を開き、[Wi-Fi] をタップし、アクティブなネットワークの横にある [情報] ボタンをタップします。

    • Mac で、[ターミナル] を開いて ping を入力し、続いてデバイスの IP アドレスを入力します。 Mac でデバイスを表示できる場合は、次のような出力が表示されます。

      PING 192.168.1.107 (192.168.1.107): 56 data bytes
64 bytes from 192.168.1.107: icmp_seq=0 ttl=64 time=121.015 ms
64 bytes from 192.168.1.107: icmp_seq=1 ttl=64 time=28.387 ms
64 bytes from 192.168.1.107: icmp_seq=2 ttl=64 time=49.890 ms
64 bytes from 192.168.1.107: icmp_seq=3 ttl=64 time=72.283 ms

      エラーが発生した場合、出力は Request timeout for icmp_seq 0 です。 デバイスに ping を実行できない場合は、インターネット制御メッセージ プロトコル (ICMP) がブロックされているか、接続に関する別の問題があります。

  • ポート 62078 が開いていることを確認します。
  • イーサネット ケーブルを使用してデバイスをネットワークに接続します。
    • Lightning to USB カメラ アダプターと USB to イーサネット アダプターを使用します。
  • iOS デバイスを再ペアリングします。