Visual Studio からリモート コンピューター上の UWP アプリをデバッグする

Visual Studio を使用して、別のコンピューターまたはデバイスでユニバーサル Windows プラットフォーム (UWP) アプリの実行、デバッグ、プロファイリング、テストを行うことができます。 リモート コンピューターで UWP アプリを実行することは、Visual Studio コンピューターがタッチ、地理的位置、物理的な向きなどの UWP 固有の機能をサポートしていない場合に特に役立ちます。

[前提条件]

Visual Studio からリモート デバイス上の UWP アプリをデバッグするには:

• Visual Studio プロジェクトは、リモート デバッグ用に構成する必要があります。
• リモート コンピューターと Visual Studio コンピューターは、ネットワーク経由で接続するか、USB またはイーサネット ケーブルを介して直接接続する必要があります。 インターネット経由でのデバッグはサポートされていません。
• Visual Studio コンピューターとリモート コンピューターの両方で 開発者モードを有効にする 必要があります。
• リモート コンピューターは、リモート ツール for Visual Studio を実行している必要があります。
  • 一部の Windows 10 以降のバージョンでは、リモート ツールが自動的に起動して実行されます。 それ以外の場合は、 リモート ツール for Visual Studio をインストールして実行します。
  • Windows Mobile 10 デバイスは、リモート ツールを必要とせず、サポートもしません。

リモート デバッグ用に Visual Studio プロジェクトを構成する

プロジェクトの プロパティ を使用して、接続先のリモート デバイスを指定します。 設定はプログラミング言語によって異なります。

リモート デバッグ用に C# または Visual Basic プロジェクトを構成する

1. Visual Studio ソリューション エクスプローラーで C# または Visual Basic プロジェクトを選択し、[プロパティ] アイコンを選択するか、Alt キーを押+Enter キーを押すか、右クリックして [プロパティ] を選択します。

2. デバッグ タブを選択します。

3. [ターゲット デバイス] で、リモート コンピューターの場合は [リモート コンピューター] を選択し、直接接続された Windows Mobile 10 デバイスの場合は [デバイス] を選択します。

4. リモート コンピューターの場合は、[リモート コンピューター] フィールドにネットワーク名または IP アドレスを入力するか、[リモート接続] ダイアログ ボックスで [検索] を選択してデバイスを検索します。

   

リモート デバッグ用に C++ プロジェクトを構成する

1. Visual Studio ソリューション エクスプローラーで C++ プロジェクトを選択し、[プロパティ] アイコンを選択するか、Alt キーを押+Enter キーを押すか、右クリックして [プロパティ] を選択します。

2. [デバッグ] タブ を 選択します。

3. [ 起動するデバッガー ] で、リモート コンピューターの場合は [ リモート コンピューター ] を、直接接続された Windows Mobile 10 デバイスの場合は [ デバイス ] を選択します。

4. リモート コンピューターの場合は、[コンピューター名] フィールドにネットワーク名または IP アドレスを入力または選択するか、ドロップダウンを選択し、[リモート接続] ダイアログ ボックスでデバイスを検索する場合は [検索] を選択します。

   

[リモート接続] ダイアログ ボックスを使用する

[ リモート接続 ] ダイアログ ボックスでは、特定のリモート コンピューター名または IP アドレスを検索したり、丸め矢印更新アイコンを選択して接続を自動検出したりできます。 このダイアログでは、現在リモート デバッガーを実行しているローカル サブネット上のデバイスのみが検索されます。 [ リモート接続 ] ダイアログ ボックスですべてのデバイスを検出できるわけではありません。

Remote Tools for Visual Studio をダウンロードしてインストールする

Visual Studio でリモート コンピューター上のアプリをデバッグするには、リモート コンピューターでリモート ツール for Visual Studio が実行されている必要があります。

• Windows Mobile 10 デバイスは、リモート ツールを必要とせず、サポートもしません。
• Creator's Update (バージョン 1703) 以降を実行している Windows 11 PC と Windows 10 PC、Windows 10 Xbox、IoT、HoloLens デバイスは、アプリの展開時にリモート ツールを自動的にインストールします。
• Creator より前の Update Windows 10 PC では、デバッグを開始する前に、リモート コンピューターでリモート ツールを手動でダウンロード、インストール、実行する必要があります。

リモート ツールをダウンロードしてインストールするには:

Visual Studio コンピューターではなく、デバッグ対象のリモート デバイスまたはサーバーで、次の表のリンクから正しいバージョンのリモート ツールをダウンロードしてインストールします。

• Visual Studio のバージョンのリモート ツールの最新の更新プログラムをダウンロードします。 以前のバージョンのリモート ツールは、以降の Visual Studio バージョンと互換性がありません。 (たとえば、Visual Studio 2019 を使用している場合は、Visual Studio 2019 のリモート ツールの最新の更新プログラムをダウンロードします。このシナリオでは、Visual Studio 2022 用のリモート ツールをダウンロードしないでください)。
• リモート ツールをインストールするコンピューターと同じアーキテクチャでダウンロードします。 たとえば、x64 オペレーティング システムを実行しているリモート コンピューターで x86 アプリケーションをデバッグする場合は、x64 リモート ツールをインストールします。 ARM64 オペレーティング システムで x86、ARM、または x64 アプリケーションをデバッグするには、ARM64 リモート ツールをインストールします。

リモート デバッガーを実行するには、リモート ツールをインストールするのではなく、リモート コンピューターに msvsmon.exe をコピーします。 ただし、リモート デバッガー構成ウィザード (rdbgwiz.exe) は、リモート ツールをインストールする場合にのみ使用できます。 リモート デバッガーをサービスとして実行する場合は、構成にウィザードを使用することが必要になる場合があります。 詳細については、「(省略可能) リモート デバッガーをサービスとして構成する」を参照してください。

リモート ツールを構成する

1. リモート コンピューターで、の [スタート] メニューから リモート デバッガー を見つけて起動します。

   リモート コンピューターに対する管理アクセス許可がない場合は、リモート デバッガー アプリを右クリックし、[管理者 として実行]選択します。 それ以外の場合は、通常どおりに起動するだけです。

   管理者として実行されているプロセス、または別のユーザー アカウント (IIS など) で実行しているプロセスにアタッチする場合は、リモート デバッガー アプリを右クリックし、[管理者として実行] 選択。 詳細については、「リモート デバッガーを管理者として実行する」を参照してください。

2. リモート デバッガーを初めて起動するとき (またはリモート デバッガーを構成する前)、リモート デバッグ構成 ウィザードが表示されます。

   ほとんどのシナリオでは、ウィザードの [Windows ファイアウォール の構成] ページに移動するまで、[次の ] を選択します。

   

   

   Windows Web サービス API がインストールされていない場合、これは Windows Server 2008 R2 でのみ発生するため、[インストール] ボタンを選択してください。

3. リモート ツールを使用するネットワークの種類を少なくとも 1 つ選択します。 コンピューターがドメイン経由で接続されている場合は、最初の項目を選択する必要があります。 コンピューターがワークグループまたはホームグループ経由で接続されている場合は、必要に応じて 2 番目または 3 番目の項目を選択します。

   次に、[完了] を選択してリモート デバッガーを起動します。

   次に、リモート デバッグ の構成を選択してリモート デバッガーを起動します。

4. 構成が完了すると、リモート デバッガーの ウィンドウが表示されます。

   

   

   これで、リモート デバッガーは接続を待機しています。 表示されているサーバー名とポート番号を使用して、Visual Studio でリモート接続の構成を設定します。

リモート デバッガーを停止するには、[ファイル] >選択します。 の [スタート] メニューまたはコマンド ラインから再起動できます。

<Remote debugger installation directory>\msvsmon.exe

UWP アプリをリモートでデバッグする

リモート デバッグは、ローカル デバッグと同じように動作します。

1. Creator より前のバージョンの Windows 10 の更新プログラムでは、リモート デバイスでリモート デバッグ モニター (msvsmon.exe) が実行されていることを確認します。

2. Visual Studio コンピューターで、ツール バーの緑色の矢印の横に正しいデバッグ ターゲット (リモート コンピューター または デバイス) が表示されていることを確認します。

3. デバッグ>開始を選択するか、F5 キーを押すか、ツールバーで緑色の矢印を選択して、デバッグを開始します。

   プロジェクトが再コンパイルされ、リモート デバイス上に配置されて開始されます。 デバッガーはブレークポイントで実行を中断し、コードのステップ イン、オーバー、アウトを行うことができます。

4. 必要に応じて、[ デバッグ>デバッグの停止 ] を選択するか、 Shift+F5 キーを押してデバッグを停止し、リモート アプリを閉じます。

関連コンテンツ

• リモート展開の詳細オプション
• Visual Studio を使用した UWP アプリのテスト
• Visual Studio で UWP アプリをデバッグする