Visual Studio を使用した配置とデバッグUsing Visual Studio to deploy and debug

DirectX と Unity のどちらを使用して Mixed Reality アプリを開発する場合でも、デバッグと配置には 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 how to:

  • Visual Studio を使用して、HoloLens または Windows Mixed Reality のイマーシブ ヘッドセットにアプリケーションを配置する。Deploy applications to your HoloLens or Windows Mixed Reality immersive headset through Visual Studio.
  • Visual Studio に組み込まれている HoloLens エミュレーターを使用する。Use the HoloLens emulator built in to Visual Studio.
  • Mixed Reality アプリをデバッグする。Debug mixed reality apps.

前提条件Prerequisites

  1. インストール手順については、「ツールのインストール」を参照してください。See Install the Tools for installation instructions.
  2. Visual Studio で新しいユニバーサル Windows アプリ プロジェクトを作成します。Create a new Universal Windows app project in Visual Studio. HoloLens (第 1 世代) の場合は、Visual Studio 2017 以降を使用します。For HoloLens (1st gen), use Visual Studio 2017 or newer. Hololens 2 の場合は、Visual Studio 2019 16.2 以降を使用します。For Hololens 2, use Visual Studio 2019 16.2 or newer. C# と C++ がサポートされています C# and C++ are supported. (または、Unity でアプリを作成するための手順に従ってください)。(Or follow the instructions to create 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 start gesture to launch the main menu.
  3. [Settings](設定) タイルを選択して、環境でアプリを起動します。Select the Settings tile to launch the app in your environment.
  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. 省略可能: 下にスクロールし、 [Device Portal](デバイス ポータル) も有効にします。Optional: Scroll down and also enable Device Portal. これで、Web ブラウザーからも HoloLens の [Windows Device Portal](Windows デバイス ポータル) に接続できるようになります。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.

Wi-Fi 経由でのアプリの配置 - HoloLens (第 1 世代)Deploying an app over Wi-Fi - HoloLens (1st gen)

  1. アプリに合わせて [x86] ビルド構成を選択しますSelect an x86 build configuration for your app
    Visual Studio の [x86] ビルド構成x86 build configuration in Visual Studio
  2. [配置ターゲット] ドロップダウン メニューで [リモート マシン] を選択しますSelect Remote Machine in the deployment target drop-down menu
    Visual Studio でのリモート マシンの配置ターゲット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 appear to configure your connection. a。a. [アドレス] または [コンピューター名] フィールドに、デバイスの IP アドレスを入力します。Enter the IP address of your device in the Address or Machine Name field. IP アドレスは、HoloLens の [Settings](設定) > [Network & Internet](ネットワークとインターネット) > [Advanced Options](詳細オプション) で確認します。または、Cortana に「自分の IP アドレスを教えて」と聞くことができます。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. 認証モードを [ユニバーサル (暗号化されていないプロトコル)] に設定しますSet Authentication Mode to Universal (Unencrypted protocol)
    Visual Studio の [リモート接続] ダイアログRemote connection dialog in Visual Studio
  4. [デバッグ] > [デバッグの開始] を選択して、アプリをデプロイし、デバッグを開始しますSelect Debug > Start debugging to deploy your app and start debugging
    Visual Studio でのデバッグなしの開始Start 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.

Wi-Fi 経由でのアプリの配置 - HoloLens 2Deploying an app over Wi-Fi - HoloLens 2

  1. アプリに合わせて [ARM] または [ARM64] ビルド構成を選択しますSelect an ARM or ARM64 build configuration for your app
    Visual Studio の [ARM64] ビルド構成ARM64 build configuration in Visual Studio
  2. [配置ターゲット] ドロップダウン メニューで [リモート マシン] を選択しますSelect Remote Machine in the deployment target drop-down menu
    Visual Studio でのリモート マシンの配置ターゲット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 appear to configure your connection. a。a. [アドレス] または [コンピューター名] フィールドに、デバイスの IP アドレスを入力します。Enter the IP address of your device in the Address or Machine Name field. IP アドレスは、HoloLens の [Settings](設定) > [Network & Internet](ネットワークとインターネット) > [Advanced Options](詳細オプション) で確認します。または、Cortana に「自分の IP アドレスを教えて」と聞くことができます。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. 認証モードを [ユニバーサル (暗号化されていないプロトコル)] に設定しますSet the Authentication Mode to Universal (Unencrypted protocol)
    Visual Studio の [リモート接続] ダイアログRemote connection dialog in Visual Studio
  4. [デバッグ] > [デバッグの開始] を選択して、アプリをデプロイし、デバッグを開始しますSelect Debug > Start debugging to deploy your app and start debugging
    Visual Studio でのデバッグなしの開始Start 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.

HoloLens IP アドレスが変わった場合は、 [プロジェクト] > [プロパティ] > [構成プロパティ] > [デバッグ] に移動して、ターゲット コンピューターの 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] ビルド構成を選択しますSelect an x86 build configuration for your app
    Visual Studio の [x86] ビルド構成x86 build configuration in Visual Studio
  2. [配置ターゲット] ドロップダウン メニューで [デバイス] を選択しますSelect Device in the deployment target drop-down menu
    Visual Studio でのデバイスの配置Device deployment in Visual Studio
  3. [デバッグ] > [デバッグの開始] を選択して、アプリをデプロイし、デバッグを開始しますSelect Debug > Start debugging to deploy your app and start debugging
    Visual Studio でのデバッグなしの開始Start 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.

USB 経由での アプリの配置 - HoloLens 2Deploying an app over USB - HoloLens 2

  1. アプリに合わせて [ARM] または [ARM64] ビルド構成を選択しますSelect an ARM or ARM64 build configuration for your app
    Visual Studio の [ARM64] ビルド構成ARM64 build configuration in Visual Studio
  2. [配置ターゲット] ドロップダウン メニューで [デバイス] を選択しますSelect Device in the deployment target drop-down menu
    Visual Studio でのデバイスの配置Device deployment in Visual Studio
  3. [デバッグ] > [デバッグの開始] を選択して、アプリをデプロイし、デバッグを開始しますSelect Debug > Start debugging to deploy your app and start debugging
    Visual Studio でのデバッグなしの開始Start 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 または Mixed Reality シミュレーターに接続する Windows 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

デバイスのペアリングPairing your device

Visual Studio から HoloLens にアプリを初めて配置するときは、PIN の入力を求められます。The first time you deploy an app from Visual Studio to your HoloLens, you will be prompted for a PIN. HoloLens で、[Settings](設定) アプリを起動して PIN を生成し、 [Update](更新) > [For Developers](開発者向け) に移動し、 [Pair](ペアリング) をタップします。On the HoloLens, generate a PIN by launching the Settings app, go to Update > For Developers and tap on Pair. HoloLens に PIN が表示されます。Visual Studio でこの PIN を入力します。A PIN will be displayed on your HoloLens; type this PIN in Visual Studio. ペアリングが完了したら、HoloLens で [Done](完了) をタップしてダイアログを閉じます。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 のペアリングを解除するには、 [Settings](設定) アプリを起動し、 [Update](更新) > [For Developers](開発者向け) に移動し、 [Clear](クリア) をタップします。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 世代) Emulator へのアプリの配置Deploying an app to the HoloLens (1st gen) Emulator

  1. HoloLens Emulator をインストール済み であることを確認します。Make sure you have installed the HoloLens Emulator.
  2. アプリに合わせて [x86] ビルド構成を選択します。Select an x86 build configuration for your app.
    Visual Studio の [x86] ビルド構成x86 build configuration in Visual Studio
  3. [配置ターゲット] ドロップダウン メニューで [HoloLens エミュレーター] を選択しますSelect HoloLens Emulator in the deployment target drop-down menu
    Visual Studio のエミュレーター ターゲットEmulator target in Visual Studio
  4. [デバッグ] > [デバッグの開始] を選択して、アプリをデプロイし、デバッグを開始しますSelect Debug > Start debugging to deploy your app and start debugging
    Visual Studio でのデバッグなしの開始Start Without Debugging in Visual Studio

HoloLens 2 Emulator へのアプリの配置Deploying an app to the HoloLens 2 Emulator

  1. HoloLens Emulator をインストール済み であることを確認します。Make sure you have installed the HoloLens Emulator.
  2. アプリに合わせて [x86] または [x64] ビルド構成を選択します。Select an x86 or x64 build configuration for your app.
    Visual Studio の [x86] ビルド構成x86 build configuration in Visual Studio
  3. [配置ターゲット] ドロップダウン メニューで [HoloLens 2 エミュレーター] を選択しますSelect HoloLens 2 Emulator in the deployment target drop-down menu
    Visual Studio のエミュレーター ターゲットEmulator target in Visual Studio
  4. [デバッグ] > [デバッグの開始] を選択して、アプリをデプロイし、デバッグを開始しますSelect Debug > Start debugging to deploy your app and start debugging
    Visual Studio でのデバッグなしの開始Start Without Debugging in Visual Studio

HoloLens (第 1 世代) 用グラフィックス デバッガーGraphics Debugger for HoloLens (1st gen)

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 プロジェクトから配置せずにインストールされたユニバーサル Windows アプリを、Visual Studio を使用してデバッグできます。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. デバッグするものを選択します。Pick the one what you’d like to debug.
  6. デバッグするコードの種類を選択します ([マネージド]、[ネイティブ]、[混合])Choose the type of code to debug (Managed, Native, Mixed)
  7. [アタッチ] または [開始] をクリックしますClick Attach or Start

関連項目See also