Uso de Visual Studio para implementaciones y depuracionesUsing Visual Studio to deploy and debug

Tanto si usa DirectX como Unity para desarrollar su aplicación de realidad mixta, Visual Studio será una herramienta imprescindible para realizar la depuración y la implementación.Whether you're using DirectX or Unity to develop your mixed reality app, Visual Studio is your go-to tool for debugging and deployment. En esta sección, aprenderás a:In this section, you will learn how to:

  • Implementar aplicaciones en tu casco envolvente de HoloLens o Windows Mixed Reality a través de Visual Studio.Deploy applications to your HoloLens or Windows Mixed Reality immersive headset through Visual Studio.
  • Usar el emulador de HoloLens integrado en Visual Studio.Use the HoloLens emulator built in to Visual Studio.
  • Depurar aplicaciones de realidad mixta.Debug mixed reality apps.

Requisitos previosPrerequisites

  1. Consulta Instalar las herramientas para obtener instrucciones de instalación.See Install the Tools for installation instructions.
  2. Crea un proyecto de aplicación universal de Windows en Visual Studio.Create a new Universal Windows app project in Visual Studio. Para HoloLens (1.ª generación), usa Visual Studio 2017 o una versión más reciente.For HoloLens (1st gen), use Visual Studio 2017 or newer. Para Hololens 2, use Visual Studio 2019 16.2 o una versión más reciente.For HoloLens 2, use Visual Studio 2019 16.2 or newer. Se admiten los lenguajes C# y C++.C# and C++ are supported. (También puedes seguir las instrucciones para crear una aplicación en Unity).(Or follow the instructions to create an app in Unity.)

Habilitar el modo de desarrolladorEnabling Developer Mode

Para empezar, habilita el Modo de desarrollador en tu dispositivo, para que Visual Studio pueda conectarse a él.Start by enabling Developer Mode on your device, so Visual Studio can connect to it.

HoloLensHoloLens

  1. Enciende tu HoloLens y colócate el dispositivo.Turn on your HoloLens and put on the device.
  2. Realice el gesto de inicio para iniciar el menú principal.Use the start gesture to launch the main menu.
  3. Selecciona el icono Configuración para iniciar la aplicación en tu entorno.Select the Settings tile to launch the app in your environment.
  4. Selecciona el elemento de menú Actualizar.Select the Update menu item.
  5. Selecciona el elemento de menú Para desarrolladores.Select the For developers menu item.
  6. Habilite el Modo de desarrollador para implementar aplicaciones de Visual Studio en HoloLens.Enable Developer Mode to deploy apps from Visual Studio to your HoloLens.
  7. Opcional: Desplácese hacia abajo y habilite el Portal de dispositivos, que le permitirá conectarse al Portal de dispositivos Windows en HoloLens desde un explorador web.Optional: Scroll down and also enable Device Portal, which lets you connect to the Windows Device Portal on your HoloLens from a web browser.

Equipo WindowsWindows PC

Si trabaja con un casco de Windows Mixed Reality conectado al equipo, debe habilitar el Modo de desarrollador en el equipo.If you're working with a Windows Mixed Reality headset connected to your PC, you must enable Developer Mode on the PC.

  1. Ve a Configuración.Go to Settings
  2. Selecciona Actualización y seguridad.Select Update and Security
  3. Selecciona Para desarrolladores.Select For developers
  4. Habilite el Modo de desarrollador, lea el aviso de declinación de responsabilidades para la configuración elegida y, a continuación, haga clic en Sí para aceptar el cambio.Enable Developer Mode, read the disclaimer for the setting you chose, then select Yes to accept the change.

Implementación de una aplicación a través de Wi-Fi: HoloLens (1.ª generación)Deploying an app over Wi-Fi - HoloLens (1st gen)

  1. Selecciona una configuración de compilación x86 para tu aplicación.Select an x86 build configuration for your app
    Configuración de compilación x86 en Visual Studiox86 build configuration in Visual Studio
  2. Selecciona Máquina remota en el menú desplegable de destino de la implementación.Select Remote Machine in the deployment target drop-down menu
    Destino de implementación de la máquina remota en Visual StudioRemote machine deployment target in Visual Studio
  3. Para proyectos de C++ y JavaScript, ve a Proyecto > Propiedades > Propiedades de configuración > Depuración.For C++ and JavaScript projects, go to Project > Properties > Configuration Properties > Debugging. Para proyectos de C#, aparecerá automáticamente un cuadro de diálogo para configurar tu conexión.For C# projects, a dialog will automatically appear to configure your connection. a.a. Escribe la dirección IP del dispositivo en el campo Dirección o Nombre de la máquina.Enter the IP address of your device in the Address or Machine Name field. Busca la dirección IP de tu HoloLens en Configuración > Red e Internet > Opciones avanzadas, o puedes pedirle a Cortana "¿Cuál es mi dirección 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. Establece el modo de autenticación en Universal (protocolo sin cifrar) .Set Authentication Mode to Universal (Unencrypted protocol)
    Cuadro de diálogo de conexión remota en Visual StudioRemote connection dialog in Visual Studio
  4. Selecciona Depuración > Iniciar depuración para implementar tu aplicación e iniciar la depuración.Select Debug > Start debugging to deploy your app and start debugging
    Iniciar sin depuración en Visual StudioStart Without Debugging in Visual Studio
  5. La primera vez que implemente una aplicación en HoloLens desde el equipo, deberá escribir un PIN.The first time you deploy an app to your HoloLens from your PC, you'lll be prompted for a PIN. Sigue las instrucciones de la sección Emparejamiento del dispositivo que hay a continuación.Follow the Pairing your device instructions below.

Implementación de una aplicación a través de Wi-Fi: HoloLens 2Deploying an app over Wi-Fi - HoloLens 2

  1. Selecciona una configuración de compilación ARM o ARM64 para tu aplicación.Select an ARM or ARM64 build configuration for your app
    Configuración de compilación ARM64 en Visual StudioARM64 build configuration in Visual Studio
  2. Selecciona Máquina remota en el menú desplegable de destino de la implementación.Select Remote Machine in the deployment target drop-down menu
    Destino de implementación de la máquina remota en Visual StudioRemote machine deployment target in Visual Studio
  3. Para proyectos de C++ y JavaScript, ve a Proyecto > Propiedades > Propiedades de configuración > Depuración.For C++ and JavaScript projects, go to Project > Properties > Configuration Properties > Debugging. Para proyectos de C#, aparecerá automáticamente un cuadro de diálogo para configurar tu conexión.For C# projects, a dialog will automatically appear to configure your connection. a.a. Escribe la dirección IP del dispositivo en el campo Dirección o Nombre de la máquina.Enter the IP address of your device in the Address or Machine Name field. Busca la dirección IP de tu HoloLens en Configuración > Red e Internet > Opciones avanzadas, o puedes pedirle a Cortana "¿Cuál es mi dirección 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. Establece el modo de autenticación en Universal (protocolo sin cifrar) .Set the Authentication Mode to Universal (Unencrypted protocol)
    Cuadro de diálogo de conexión remota en Visual StudioRemote connection dialog in Visual Studio
  4. Selecciona Depuración > Iniciar depuración para implementar tu aplicación e iniciar la depuración.Select Debug > Start debugging to deploy your app and start debugging
    Iniciar sin depuración en Visual StudioStart Without Debugging in Visual Studio
  5. La primera vez que implemente una aplicación en HoloLens desde el equipo, deberá escribir un PIN.The first time you deploy an app to your HoloLens from your PC, you'll be prompted for a PIN. Sigue las instrucciones de la sección Emparejamiento del dispositivo que hay a continuación.Follow the Pairing your device instructions below.

Si cambia la dirección IP de tu HoloLens, puedes cambiar la dirección IP de la máquina de destino. Para ello, ve a Proyecto > Propiedades > Propiedades de configuración > Depuración.If your HoloLens IP address changes, you can change the IP address of the target machine by going to Project > Properties > Configuration Properties > Debugging

Implementar una aplicación a través de USB: HoloLens (1.ª generación)Deploying an app over USB - HoloLens (1st gen)

  1. Selecciona una configuración de compilación x86 para tu aplicación.Select an x86 build configuration for your app
    Configuración de compilación x86 en Visual Studiox86 build configuration in Visual Studio
  2. Selecciona Dispositivo en el menú desplegable de destino de la implementación.Select Device in the deployment target drop-down menu
    Implementación de dispositivos en Visual StudioDevice deployment in Visual Studio
  3. Selecciona Depuración > Iniciar depuración para implementar tu aplicación e iniciar la depuración.Select Debug > Start debugging to deploy your app and start debugging
    Iniciar sin depuración en Visual StudioStart Without Debugging in Visual Studio
  4. La primera vez que implemente una aplicación en HoloLens desde el equipo, deberá escribir un PIN.The first time you deploy an app to your HoloLens from your PC, you'll be prompted for a PIN. Sigue las instrucciones de la sección Emparejamiento del dispositivo que hay a continuación.Follow the Pairing your device instructions below.

Implementación de una aplicación a través de USB: HoloLens 2Deploying an app over USB - HoloLens 2

  1. Selecciona una configuración de compilación ARM o ARM64 para tu aplicación.Select an ARM or ARM64 build configuration for your app
    Configuración de compilación ARM64 en Visual StudioARM64 build configuration in Visual Studio
  2. Selecciona Dispositivo en el menú desplegable de destino de la implementación.Select Device in the deployment target drop-down menu
    Implementación de dispositivos en Visual StudioDevice deployment in Visual Studio
  3. Selecciona Depuración > Iniciar depuración para implementar tu aplicación e iniciar la depuración.Select Debug > Start debugging to deploy your app and start debugging
    Iniciar sin depuración en Visual StudioStart Without Debugging in Visual Studio
  4. La primera vez que implemente una aplicación en HoloLens desde el equipo, deberá escribir un PIN.The first time you deploy an app to your HoloLens from your PC, you'll be prompted for a PIN. Sigue las instrucciones de la sección Emparejamiento del dispositivo que hay a continuación.Follow the Pairing your device instructions below.

Implementación de una aplicación en tu equipo local: casco envolventeDeploying an app to your Local PC - immersive headset

A la hora de usar un casco envolvente de Windows Mixed Reality que se conecte al equipo o al simulador de Mixed Reality:To use a Windows Mixed Reality immersive headset that connects to your PC or the Mixed Reality simulator:

  1. Selecciona una configuración de compilación x86 o x64 para tu aplicación.Select an x86 or x64 build configuration for your app
  2. Selecciona Máquina local en el menú desplegable de destino de la implementación.Select Local Machine in the deployment target drop-down menu
  3. Selecciona Depuración > Iniciar depuración para implementar tu aplicación e iniciar la depuración.Select Debug > Start debugging to deploy your app and start debugging

Emparejamiento del dispositivoPairing your device

La primera vez que implemente una aplicación desde Visual Studio en HoloLens, deberá escribir un PIN.The first time you deploy an app from Visual Studio to your HoloLens, you'll be prompted for a PIN. Para generar un PIN en HoloLens, inicie la aplicación Configuración, vaya a Actualizar > Para desarrolladores y pulse Emparejar.On the HoloLens, generate a PIN by launching the Settings app, go to Update > For Developers, and tap on Pair. Cuando el PIN se muestre en HoloLens, escríbalo en Visual Studio.When the PIN is displayed on your HoloLens, type it into Visual Studio. Una vez completado el emparejamiento, pulsa Listo en HoloLens para descartar el cuadro de diálogo.After pairing is complete, tap Done on your HoloLens to dismiss the dialog. En ese momento, el equipo estará emparejado con HoloLens y podrá implementar aplicaciones automáticamente.This PC is now paired with the HoloLens and you can deploy apps automatically. Repita estos pasos para todos los equipos que se usen para implementar aplicaciones en HoloLens.Repeat these steps for every PC that's used to deploy apps to your HoloLens.

Para desemparejar HoloLens de todos los equipos emparejados:To unpair your HoloLens from all paired computers:

  • Inicie la aplicación de Configuración, vaya a Actualizar > Para desarrolladores y pulse Borrar.Launch the Settings app, go to Update > For Developers, and tap on Clear.

Implementación de una aplicación en el emulador de HoloLens (1.ª generación)Deploying an app to the HoloLens (1st gen) Emulator

  1. Asegúrese de que tiene instalado el emulador de HoloLens .Make sure you've installed the HoloLens Emulator.
  2. Selecciona una configuración de compilación x86 para tu aplicación.Select an x86 build configuration for your app.
    Configuración de compilación x86 en Visual Studiox86 build configuration in Visual Studio
  3. Selecciona Emulador de HoloLens en el menú desplegable de destino de la implementación.Select HoloLens Emulator in the deployment target drop-down menu
    Destino del emulador en Visual StudioEmulator target in Visual Studio
  4. Selecciona Depuración > Iniciar depuración para implementar tu aplicación e iniciar la depuración.Select Debug > Start debugging to deploy your app and start debugging
    Iniciar sin depuración en Visual StudioStart Without Debugging in Visual Studio

Implementación de una aplicación en el emulador de HoloLens 2Deploying an app to the HoloLens 2 Emulator

  1. Asegúrese de que tiene instalado el emulador de HoloLens .Make sure you've installed the HoloLens Emulator.
  2. Selecciona una configuración de compilación x86 o x64 para tu aplicación.Select an x86 or x64 build configuration for your app.
    Configuración de compilación x86 en Visual Studiox86 build configuration in Visual Studio
  3. Selecciona Emulador de HoloLens 2 en el menú desplegable de destino de la implementación.Select HoloLens 2 Emulator in the deployment target drop-down menu
    Destino del emulador en Visual StudioEmulator target in Visual Studio
  4. Selecciona Depuración > Iniciar depuración para implementar tu aplicación e iniciar la depuración.Select Debug > Start debugging to deploy your app and start debugging
    Iniciar sin depuración en Visual StudioStart Without Debugging in Visual Studio

Depurador de gráficos para HoloLens (1.ª generación)Graphics Debugger for HoloLens (1st gen)

Las herramientas de Diagnóstico de gráficos de Visual Studio son muy útiles a la hora de escribir y optimizar una aplicación holográfica.The Visual Studio Graphics Diagnostics tools are helpful when writing and optimizing a Holographic app. Consulta Diagnóstico de gráficos de Visual Studio en MSDN para obtener todos los detalles.See Visual Studio Graphics Diagnostics on MSDN for full details.

Para iniciar el depurador de gráficosTo Start the Graphics Debugger

  1. Sigue las instrucciones anteriores para usar un dispositivo o un emulador como destino.Follow the instructions above to target a device or emulator
  2. Ve a Depurar > Gráficos > Iniciar diagnóstico.Go to Debug > Graphics > Start Diagnostics
  3. Es posible que la primera vez que realice un diagnóstico con HoloLens obtenga un error de tipo "Acceso denegado".The first time you start diagnostics with a HoloLens, you may get an "access denied" error. Reinicie HoloLens para permitir que se apliquen los permisos actualizados y vuelva a intentarlo.Reboot your HoloLens to let the updated permissions take effect and try again.

Generación de perfilesProfiling

Las herramientas de generación de perfiles de Visual Studio te permiten analizar el rendimiento y el uso de recursos de tu aplicación.The Visual Studio profiling tools allow you to analyze your app's performance and resource use. Esto incluye herramientas para optimizar el uso de la CPU, la memoria, los gráficos y la red.This includes tools to optimize CPU, memory, graphics, and network use. Consulta Ejecutar las herramientas de diagnóstico sin depuración en MSDN para obtener todos los detalles.See Run diagnostic tools without debugging on MSDN for full details.

Para iniciar las herramientas de generación de perfiles con HoloLensTo Start the Profiling Tools with HoloLens

  1. Sigue las instrucciones anteriores para usar un dispositivo o un emulador como destino.Follow the instructions above to target a device or emulator
  2. Ve a Depurar > Iniciar herramientas de diagnóstico sin depuración... .Go to Debug > Start Diagnostic Tools Without Debugging...
  3. Selecciona las herramientas que quieres utilizar.Select the tools you want to use
  4. Seleccione Inicio.Select Start
  5. Es posible que la primera vez que realice un diagnóstico sin depuración con HoloLens obtenga un error de tipo "Acceso denegado".The first time you start diagnostics without debugging with a HoloLens, you may get an "access denied" error. Reinicie HoloLens para permitir que se apliquen los permisos actualizados y vuelva a intentarlo.Reboot your HoloLens to let the updated permissions take effect and try again.

Depuración de una aplicación instalada o en ejecuciónDebugging an installed or running app

Puede usar Visual Studio para depurar una aplicación universal de Windows instalada sin implementarla desde un proyecto de Visual Studio.You can use Visual Studio to debug an installed Universal Windows app without deploying from a Visual Studio project. Esto resulta útil si quiere depurar un paquete de la aplicación instalado o si quiere depurar una aplicación que ya se esté ejecutando.This is useful if you want to debug an installed app package or debug an app that's already running.

  1. Ve a Depurar > Otros destinos de depuración > Depurar paquete de aplicaciones instalado.Go to Debug -> Other Debug Targets -> Debug Installed App Package
  2. Selecciona el destino Máquina remota para HoloLens o Máquina local para los cascos envolventes.Select the Remote Machine target for HoloLens or Local Machine for immersive headsets.
  3. Escribe la dirección IP de tu dispositivo.Enter your device’s IP address
  4. Selecciona el modo de autenticación Universal.Choose the Universal Authentication Mode
  5. En la ventana se muestran las aplicaciones en ejecución e inactivas.The window shows both running and inactive apps. Elige la que quieras depurar.Pick the one what you’d like to debug.
  6. Elige el tipo de código que quieras depurar (administrado, nativo, mixto).Choose the type of code to debug (Managed, Native, Mixed)
  7. Seleccione Adjuntar o Iniciar.Select Attach or Start

Siguiente punto de control de desarrolloNext Development Checkpoint

Si sigue el recorrido de puntos de control de desarrollo de Unity que hemos diseñado, significa que ya se encuentra a la mitad de la fase de implementación.If you're following the Unity development checkpoint journey we've laid out, you're in the midst of the deployment stage. Desde aquí, puede continuar con el siguiente tema:From here, you can continue to the next topic:

O bien puede ir directamente a agregar servicios avanzados:Or jump directly to adding advanced services:

Puede volver a los puntos de control de desarrollo de Unity en cualquier momento.You can always go back to the Unity development checkpoints at any time.

Consulta tambiénSee also