Uso de Visual Studio para implementaciones y depuraciones

  • Artículo

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. En esta sección aprenderá a:

  • Implementar aplicaciones en tu casco envolvente de HoloLens o Windows Mixed Reality a través de Visual Studio.
  • Usar el emulador de HoloLens integrado en Visual Studio.
  • Depurar aplicaciones de realidad mixta.

Requisitos previos

  1. Consulta Instalar las herramientas para obtener instrucciones de instalación.
  2. Crear un nuevo proyecto de realidad mixta en Unity o Visual Studio.
  3. Crear el proyecto de Unity según nuestras instrucciones.

Habilitar el modo de desarrollador

Para empezar, habilite el Modo de desarrollador en el dispositivo, para que Visual Studio pueda conectarse a él.

Modo de desarrollador en HoloLens

  1. Enciende tu HoloLens y colócate el dispositivo.
  2. Realice el gesto de inicio para iniciar el menú principal.
  3. Selecciona el icono Configuración para iniciar la aplicación en tu entorno.
  4. Selecciona el elemento de menú Actualizar.
  5. Selecciona el elemento de menú Para desarrolladores.
  6. Habilite Usar las funciones de desarrollador para implementar aplicaciones de Visual Studio en HoloLens. Si el dispositivo ejecuta Windows Holographic, versión 21H1 o posterior, habilite también Detección de dispositivos.
  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.

Modo de desarrollador en un equipo de Windows

Si trabaja con un casco de Windows Mixed Reality conectado al equipo, debe habilitar el Modo de desarrollador en el equipo.

  1. Vaya a Configuración.
  2. Seleccione Actualización y seguridad.
  3. Seleccione Para desarrolladores.
  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.

Implementación de una aplicación de HoloLens a través de Wi-Fi o USB

Opciones de compilación

  1. Abra el proyecto en Visual Studio.

  2. Haga clic en la lista desplegable Opciones de compilación y, a continuación, realice una de las siguientes acciones:

    • En el caso de los proyectos de Unity, elija Versión o Maestro.
    • Para todos los demás proyectos, elija Versión.

    Captura de pantalla que muestra las opciones de compilación en Visual Studio

    Estas son las definiciones de las opciones de compilación:

Configuración Explicación
Depurar Todas las optimizaciones desactivadas y el generador de perfiles están habilitados. Se usa para depurar scripts.
Master Todas las optimizaciones están activadas y el generador de perfiles está deshabilitado. Se usa para enviar aplicaciones a la Store.
Release Todas las optimizaciones están activadas y el generador de perfiles está habilitado. Se usa para evaluar el rendimiento de la aplicación.

Configuración de compilación

  1. Seleccione la configuración de compilación en función del dispositivo.

    Elija la opción de configuración ARM o ARM64.

    Configuración de compilación ARM64 en Visual Studio

    Para obtener más información sobre las configuraciones de compilación, consulte la tabla "Tipos de configuraciones de compilación" en la documentación de Unity.

    Nota

    Para la implementación en el dispositivo HoloLens 2, elija arm64 o la arquitectura de ARM.

    Si no ve Dispositivo como opción de destino, es posible que deba cambiar el proyecto de inicio de la solución de Visual Studio del proyecto de IL2CPP al proyecto de UWP. Para ello, en el Explorador de soluciones, haga clic con el botón derecho en el proyecto y seleccione Set as StartUp Project (Establecer como proyecto de inicio).

  2. Haga clic en la lista desplegable destino de implementación y, a continuación, realice una de las siguientes acciones:

    • Si va a compilar e implementar a través de Wi-Fi, seleccione Equipo remoto.

    Seleccione

    • Si va a compilar e implementar a través de USB, seleccione Dispositivo.

    Seleccione

Conexión remota

Para establecer la conexión remota:

  1. En la barra de menú, seleccione Proyecto > Propiedades > Propiedades de configuración > Depuración.

    Nota

    En un proyecto de C#, debe aparecer automáticamente un cuadro de diálogo.

  2. Haga clic en el menú desplegable Debugger to launch (Depurador que se va a iniciar) y seleccione Equipo remoto.

  3. En el campo Nombre del equipo, escriba la dirección IP del dispositivo.

    Cuadro de diálogo de conexión remota en Visual Studio

    • Puede encontrar la dirección IP en HoloLens en Configuración > Red & Opciones avanzadas de Internet>.

    • Siempre se recomienda especificar manualmente la dirección IP en lugar de depender de la característica "Detección automática".

  4. Establezca el Modo de autenticación en Universal (protocolo sin cifrar).

  5. Compile, implemente y depure la aplicación en función de sus necesidades:

    • Para compilar, implementar y comenzar a depurar, seleccione Depurar > Iniciar depuración.

    • Para compilar e implementar sin depurar, seleccione Compilar > Implementar solución.

  6. La primera vez que implemente una aplicación en HoloLens desde el equipo, deberá escribir un PIN. Sigue las instrucciones de la sección Emparejamiento del dispositivo que hay a continuación.

Nota

Si los errores que se enumeran a continuación se producen al iniciar la depuración de una aplicación para UWP instalada en el HoloLens 2, intente cambiar el nombre del paquete o desinstalar la aplicación para UWP.

"No se puede iniciar la depuración"
"Operación no compatible. Error desconocido: 0x80070057"

Implementación de una aplicación en el emulador de HoloLens (1.ª generación)

  1. Asegúrese de que tiene instalado el emulador de HoloLens .
  2. Selecciona una configuración de compilación x86 para tu aplicación. Selección de una configuración de compilación x86 en Visual Studio
  3. Seleccione Emulador de HoloLens en el menú desplegable de destino de la implementación.
    Destino de emulador en Visual Studio
  4. Seleccione Depurar > Iniciar depuración para implementar la aplicación e iniciar la depuración.
    Iniciar sin depurar en Visual Studio

Implementación de una aplicación en el emulador de HoloLens 2

  1. Asegúrese de que tiene instalado el emulador de HoloLens .
  2. Seleccione una configuración de compilación x86 o x64 para la aplicación.
    Configuración de compilación x86 en Visual Studio
  3. Seleccione Emulador de HoloLens 2 en el menú desplegable de destino de la implementación.
    Destino de emulador en una aplicación de Visual Studio
  4. Seleccione Depurar > Iniciar depuración para implementar la aplicación e iniciar la depuración.
    Iniciar sin depurar en Visual Studio

Implementación de una aplicación de VR en el equipo local

A la hora de usar un casco envolvente de Windows Mixed Reality que se conecte al equipo o al simulador de Mixed Reality:

  1. Selecciona una configuración de compilación x86 o x64 para tu aplicación.
  2. Selecciona Máquina local en el menú desplegable de destino de la implementación.
  3. Compile, implemente y depure la aplicación en función de sus necesidades:
    • Seleccione Depuración > Iniciar depuración para implementar la aplicación e iniciar la depuración.
    • Seleccione Compilar > Implementar para compilarla e implementarla sin depuración.

Emparejamiento del dispositivo

La primera vez que implemente una aplicación desde Visual Studio en HoloLens, deberá escribir un PIN. Genere un PIN en HoloLens, para lo que debe iniciar la aplicación Configuración e ir a Actualizar > Para desarrolladores y pulse Emparejar. Cuando el PIN se muestre en HoloLens, escríbalo en Visual Studio. Una vez completado el emparejamiento, pulsa Listo en HoloLens para descartar el cuadro de diálogo. En ese momento, el equipo estará emparejado con HoloLens y podrá implementar aplicaciones automáticamente. Repita estos pasos para todos los equipos que se usen para implementar aplicaciones en HoloLens.

Para desemparejar HoloLens de todos los equipos emparejados:

  • Inicie la aplicación Configuración, vaya a Actualizar > Para desarrolladores y pulse Borrar.

Depurador de gráficos para HoloLens (1.ª generación)

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. Consulta Diagnóstico de gráficos de Visual Studio en MSDN para obtener todos los detalles.

Para iniciar el depurador de gráficos

  1. Sigue las instrucciones anteriores para usar un dispositivo o un emulador como destino.
  2. Vaya a Depurar > Gráficos > Iniciar diagnóstico.
  3. Es posible que la primera vez que realice un diagnóstico con HoloLens obtenga un error de tipo "Acceso denegado". Reinicie HoloLens para permitir que se apliquen los permisos actualizados y vuelva a intentarlo.

Generación de perfiles

Las herramientas de generación de perfiles de Visual Studio te permiten analizar el rendimiento y el uso de recursos de tu aplicación. Esto incluye herramientas para optimizar el uso de la CPU, la memoria, los gráficos y la red. Consulta Ejecutar las herramientas de diagnóstico sin depuración en MSDN para obtener todos los detalles.

Para iniciar las herramientas de generación de perfiles con HoloLens

  1. Sigue las instrucciones anteriores para usar un dispositivo o un emulador como destino.
  2. Vaya a Depurar > Iniciar herramientas de diagnóstico sin depuración...
  3. Selecciona las herramientas que quieres utilizar.
  4. Seleccione Inicio.
  5. Es posible que la primera vez que realice un diagnóstico sin depuración con HoloLens obtenga un error de tipo "Acceso denegado". Reinicie HoloLens para permitir que se apliquen los permisos actualizados y vuelva a intentarlo.

Depuración de una aplicación instalada o en ejecución

Puede usar Visual Studio para depurar una aplicación universal de Windows instalada sin implementarla desde un proyecto de Visual Studio. 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.

  1. Vaya a Depurar > Otros destinos de depuración > Depurar paquete de aplicaciones instalado.
  2. Selecciona el destino Máquina remota para HoloLens o Máquina local para los cascos envolventes.
  3. Escribe la dirección IP de tu dispositivo.
  4. Selecciona el modo de autenticación Universal.
  5. En la ventana se muestran las aplicaciones en ejecución e inactivas. Elige la que quieras depurar.
  6. Elige el tipo de código que quieras depurar (administrado, nativo, mixto).
  7. Seleccione Adjuntar o Iniciar.

Siguiente punto de control de desarrollo

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. Desde aquí, puede continuar con el siguiente tema:

Implementación en el emulador de HoloLens

O bien puede ir directamente a agregar servicios avanzados:

Servicios avanzados

Puede volver a los puntos de control de desarrollo de Unity en cualquier momento.

Consulta también