Visual Studio を使用してデプロイをデバッグします。Using Visual Studio to deploy and debug

複合現実アプリを開発する DirectX または Unity を使用するかどうかは Visual Studio のデバッグおよび展開するために使用します。Whether you want to use DirectX or Unity to develop your mixed reality app, you will use Visual Studio for debugging and deploying. このセクションでは、次の説明は。In this section, you will learn:

  • HoloLens や Windows Mixed Reality イマーシブ ヘッドセット Visual Studio を使用するアプリケーションをデプロイする方法。How to deploy applications to your HoloLens or Windows Mixed Reality immersive headset through Visual Studio.
  • Visual Studio に組み込まれている HoloLens のエミュレーターを使用する方法。How to use the HoloLens emulator built in to Visual Studio.
  • 複合現実アプリをデバッグする方法。How to debug mixed reality apps.

前提条件Prerequisites

  1. 参照してくださいツールをインストールするインストール手順についてはします。See Install the Tools for installation instructions.
  2. Visual Studio 2015 Update 1 または Visual Studio 2017 では、新しいユニバーサル Windows アプリ プロジェクトを作成します。Create a new Universal Windows app project in Visual Studio 2015 Update 1 or Visual Studio 2017. C#、 C++、JavaScript のプロジェクトすべてサポートされます。C#, C++, and JavaScript projects are all supported. (または、指示に従って、 Unity でビルドをアプリの作成)。(Or follow the instructions to create an build an app in Unity.)

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

有効にすると開始開発者モードVisual Studio が接続できるようにデバイスにします。Start by enabling Developer Mode on your device so Visual Studio can connect to it.

HoloLensHoloLens

  1. HoloLens を有効にし、デバイス上に配置します。Turn on your HoloLens and put on the device.
  2. ブルーム ジェスチャを実行して、メイン メニューを開きます。Perform the bloom gesture to launch the main menu.
  3. 見つめます、設定タイルし、実行、エア タップジェスチャ。Gaze at the Settings tile and perform the air-tap gesture. 2 回目のエア タップを実行して、アプリを環境内に配置します。Perform a second air tap to place the app in your environment. 配置すると、設定アプリが起動します。The Settings app will launch after you place it.
  4. [Update] (更新) メニュー項目を選択します。Select the Update menu item.
  5. [For developers] (開発者向け) メニュー項目を選択します。Select the For developers menu item.
  6. [Developer Mode] (開発者モード) を有効にします。Enable Developer Mode. こうと、 Visual Studio からアプリを展開HoloLens にします。This will allow you to deploy apps from Visual Studio to your HoloLens.
  7. 省略可能: 下へスクロールし、有効にすることもデバイス ポータルします。Optional: Scroll down and also enable Device Portal. 接続することを許可するがこの、 Windows Device Portal web ブラウザーから、HoloLens にします。This will also allow you to connect to the Windows Device Portal on your HoloLens from a web browser.

Windows PCWindows PC

お使いの PC に接続されている Windows Mixed Reality ヘッドセットを使用して有効にした開発者モードPC にします。If you are working with a Windows Mixed Reality headset connected to your PC, you must enable Developer Mode on the PC.

  1. 移動して設定Go to Settings
  2. 選択更新とセキュリティSelect Update and Security
  3. 選択開発者向けSelect For developers
  4. 有効にする開発者モード、選択した設定の免責事項を読んで、変更を確定するには、[はい] をクリックします。Enable Developer Mode, read the disclaimer for the setting you chose, then click Yes to accept the change.

HoloLens Wi-fi 経由でアプリを展開する (第 1 世代)Deploying an app over Wi-Fi - HoloLens (1st gen)

  1. 選択、 x86アプリの構成をビルドx86 ビルドの Visual Studio での構成Select an x86 build configuration for your app x86 build configuration in Visual Studio
  2. 選択リモート マシンデプロイ ターゲット ドロップダウン メニューでVisual Studio でのリモート コンピューターの配置ターゲットSelect Remote Machine in the deployment target drop-down menu Remote machine deployment target in Visual Studio
  3. C++および JavaScript プロジェクトの場合に移動してプロジェクト > プロパティ > 構成プロパティ > デバッグします。For C++ and JavaScript projects, go to Project > Properties > Configuration Properties > Debugging. C#プロジェクトは、ダイアログがポップアップに自動的に接続を設定します。For C# projects, a dialog will automatically pop-up to configure your connection. a. a. デバイスの IP アドレスを入力して、アドレスまたはマシン名フィールド。Enter the IP address of your device in the Address or Machine Name field. 下、HoloLens の IP アドレスを調べる設定 > ネットワークとインターネット > 高度なオプションCortana をもらうことができます、"What is my IP address?"またはFind the IP address on your HoloLens under Settings > Network & Internet > Advanced Options, or you can ask Cortana "What is my IP address?" b. b. 認証モードを設定ユニバーサル (暗号化されていないプロトコル)Visual Studio でのリモート接続 ダイアログSet Authentication Mode to Universal (Unencrypted protocol)Remote connection dialog in Visual Studio
  4. 選択デバッグ > デバッグを開始アプリを展開およびデバッグを開始するデバッグなしで開始 Visual Studio でSelect Debug > Start debugging to deploy your app and start debuggingStart Without Debugging in Visual Studio
  5. 初めて、PC から、HoloLens にアプリを展開するは促さ PIN の。The first time you deploy an app to your HoloLens from your PC, you will be prompted for a PIN. に従って、デバイスをペアリング以下の手順。Follow the Pairing your device instructions below.

移動して、ターゲット マシンの IP アドレスを変更するには、HoloLens の IP アドレスが変更された場合プロジェクト > プロパティ > 構成プロパティ > デバッグIf your HoloLens IP address changes, you can change the IP address of the target machine by going to Project > Properties > Configuration Properties > Debugging

USB - HoloLens でアプリを配置する (第 1 世代)Deploying an app over USB - HoloLens (1st gen)

  1. 選択、 x86アプリの構成をビルドx86 ビルドの Visual Studio での構成Select an x86 build configuration for your app x86 build configuration in Visual Studio
  2. 選択デバイスデプロイ ターゲット ドロップダウン メニューでVisual Studio でのデバイスのデプロイSelect Device in the deployment target drop-down menuDevice deployment in Visual Studio
  3. 選択デバッグ > デバッグを開始アプリを展開およびデバッグを開始するデバッグなしで開始 Visual Studio でSelect Debug > Start debugging to deploy your app and start debuggingStart Without Debugging in Visual Studio
  4. 初めて、PC から、HoloLens にアプリを展開するは促さ PIN の。The first time you deploy an app to your HoloLens from your PC, you will be prompted for a PIN. に従って、デバイスをペアリング以下の手順。Follow the Pairing your device instructions below.

イマーシブ ヘッドセット - ローカル PC にアプリを展開します。Deploying an app to your Local PC - immersive headset

お使いの PC に接続する Windows Mixed Reality イマーシブ ヘッドセットを使用する場合は、次の手順をに従ってまたはMixed Reality シミュレーターします。Follow these instructions when using a Windows Mixed Reality immersive headset that connects to your PC or the Mixed Reality simulator. このような場合に、デプロイし、ローカル PC でアプリを実行します。In these cases, simply deploy and run your app on the local PC.

  1. 選択、 x86またはx64ビルド アプリの構成Select an x86 or x64 build configuration for your app
  2. 選択ローカル マシンで、デプロイ ターゲット ドロップダウン メニューSelect Local Machine in the deployment target drop-down menu
  3. 選択デバッグ > デバッグを開始アプリを展開およびデバッグを開始するにはSelect Debug > Start debugging to deploy your app and start debugging

HoloLens - デバイスをペアリング (第 1 世代)Pairing your device - HoloLens (1st gen)

初めて、HoloLens、するには、Visual Studio からアプリを展開するは促さ PIN の。The first time you deploy an app from Visual Studio to your HoloLens, you will be prompted for a PIN. 移動して、設定アプリを起動することで、PIN を生成、HoloLens の更新 > 開発者向けをタップするペアします。On the HoloLens, generate a PIN by launching the Settings app, go to Update > For Developers and tap on Pair. PIN は、HoloLens; に表示されます。Visual Studio では、この PIN を入力します。A PIN will be displayed on your HoloLens; type this PIN in Visual Studio. タップしてペアリングが完了したら、完了上、HoloLens ダイアログ ボックスを閉じます。After pairing is complete, tap Done on your HoloLens to dismiss the dialog. この PC は今すぐ、HoloLens と組み合わせて使用し、アプリを自動的に展開することができます。This PC is now paired with the HoloLens and you will be able to deploy apps automatically. HoloLens にアプリを展開するために使用するすべての後続の PC の次の手順を繰り返します。Repeat these steps for every subsequent PC that is used to deploy apps to your HoloLens.

解除ペアを使用すると、ペアになっているが、すべてのコンピューターから、HoloLens の起動、設定アプリに移動して更新 > 開発者向けをタップするクリアTo un-pair your HoloLens from all computers it was paired with, launch the Settings app, go to Update > For Developers and tap on Clear.

HoloLens にアプリを展開する (第 1 世代) エミュレーターDeploying an app to the HoloLens (1st gen) Emulator

  1. 必ず確保 HoloLens のエミュレーターがインストールされている します。Make sure you have installed the HoloLens Emulator.
  2. 選択、 x86アプリの構成をビルドします。Select an x86 build configuration for your app. x86 ビルドの Visual Studio での構成x86 build configuration in Visual Studio
  3. 選択HoloLens のエミュレーターデプロイ ターゲット ドロップダウン メニューでVisual Studio でのエミュレーターのターゲットSelect HoloLens Emulator in the deployment target drop-down menuEmulator target in Visual Studio
  4. 選択デバッグ > デバッグを開始アプリを展開およびデバッグを開始するデバッグなしで開始 Visual Studio でSelect Debug > Start debugging to deploy your app and start debuggingStart Without Debugging in Visual Studio

グラフィックス デバッガーGraphics Debugger

Visual Studio グラフィックス診断ツールは、書き込みおよび Holographic アプリを最適化するときに非常に便利です。The Visual Studio Graphics Diagnostics tools are very helpful when writing and optimizing a Holographic app. 参照してくださいmsdn の Visual Studio グラフィックス診断の完全な詳細情報。See Visual Studio Graphics Diagnostics on MSDN for full details.

グラフィックス デバッガーを起動するにはTo Start the Graphics Debugger

  1. デバイスまたはエミュレーターを対象には、上記の手順に従ってください。Follow the instructions above to target a device or emulator
  2. 移動してデバッグ > グラフィックス > 診断の開始Go to Debug > Graphics > Start Diagnostics
  3. 初めて、HoloLens でこれを行う「アクセスが拒否されました」エラーが発生する可能性があります。The first time you do this with a HoloLens, you may get an "access denied" error. 更新されたアクセス許可を反映し、もう一度お試し、HoloLens を再起動します。Reboot your HoloLens to allow updated permissions to take effect and try again.

プロファイリングProfiling

Visual Studio プロファイリング ツールを使用すると、アプリのパフォーマンスとリソース使用量を分析できます。The Visual Studio profiling tools allow you to analyze your app's performance and resource use. これには、CPU、メモリ、グラフィックスを最適化し、ネットワークの使用のツールが含まれています。This includes tools to optimize CPU, memory, graphics, and network use. 参照してくださいなし、MSDN でのデバッグ診断ツールの実行の完全な詳細情報。See Run diagnostic tools without debugging on MSDN for full details.

HoloLens でプロファイリング ツールを開始するにはTo Start the Profiling Tools with HoloLens

  1. デバイスまたはエミュレーターを対象には、上記の手順に従ってください。Follow the instructions above to target a device or emulator
  2. 移動してデバッグ > デバッグなしで診断ツールを開始しています.Go to Debug > Start Diagnostic Tools Without Debugging...
  3. 使用するツールを選択します。Select the tools you want to use
  4. クリックして開始Click Start
  5. 初めて、HoloLens でこれを行う「アクセスが拒否されました」エラーが発生する可能性があります。The first time you do this with a HoloLens, you may get an "access denied" error. 更新されたアクセス許可を反映し、もう一度お試し、HoloLens を再起動します。Reboot your HoloLens to allow updated permissions to take effect and try again.

インストールまたは実行中のアプリのデバッグDebugging an installed or running app

Visual Studio を使用して、Visual Studio プロジェクトからデプロイせずにインストールされているユニバーサル Windows アプリをデバッグすることができます。You can use Visual Studio to debug a Universal Windows app that's installed without deploying from a Visual Studio project. これは、インストールされているアプリ パッケージをデバッグする場合、または既に実行されているアプリをデバッグする場合に役立ちます。This is useful if you want to debug an installed app package, or if you want to debug an app that's already running.

  1. 移動してデバッグ]、[その他のデバッグ ターゲットにインストールされているアプリケーション パッケージのデバッグ]-> [Go to Debug -> Other Debug Targets -> Debug Installed App Package
  2. 選択、リモート マシンHoloLens のターゲットまたはローカル マシンイマーシブ ヘッドセットをします。Select the Remote Machine target for HoloLens or Local Machine for immersive headsets.
  3. デバイスの入力IP アドレスEnter your device’s IP address
  4. 選択、ユニバーサル認証モードChoose the Universal Authentication Mode
  5. ウィンドウには、実行中と非アクティブの両方のアプリが表示されます。The window shows both running and inactive apps. 希望するものをデバッグする 1 つを選択します。Pick the one what you’d like to debug.
  6. (マネージ、ネイティブ、Mixed) をデバッグするコードの種類を選択します。Choose the type of code to debug (Managed, Native, Mixed)
  7. クリックしてアタッチまたは開始Click Attach or Start

関連項目See also