Uso di Visual Studio per la distribuzione e il debugUsing Visual Studio to deploy and debug

Indipendentemente dal fatto che venga usato DirectX o Unity per lo sviluppo di un'app di realtà mista, Visual Studio rimane lo strumento ideale per il debug e la distribuzione.Whether you're using DirectX or Unity to develop your mixed reality app, Visual Studio is your go-to tool for debugging and deployment. In questa sezione imparerai a eseguire le operazioni seguenti:In this section, you will learn how to:

  • Distribuire applicazioni nel visore VR immersive di HoloLens o Windows Mixed Reality tramite Visual Studio.Deploy applications to your HoloLens or Windows Mixed Reality immersive headset through Visual Studio.
  • Usare l'emulatore HoloLens incorporato in Visual Studio.Use the HoloLens emulator built in to Visual Studio.
  • Eseguire il debug di app di realtà mista.Debug mixed reality apps.

PrerequisitiPrerequisites

  1. Per le istruzioni di installazione, vedi Installare gli strumenti.See Install the Tools for installation instructions.
  2. Crea un progetto di app di Windows universale in Visual Studio.Create a new Universal Windows app project in Visual Studio. Per HoloLens (prima generazione), usa Visual Studio 2017 o versione successiva.For HoloLens (1st gen), use Visual Studio 2017 or newer. Per HoloLens 2, usare Visual Studio 2019 16.2 o versione successiva.For HoloLens 2, use Visual Studio 2019 16.2 or newer. C# e C++ sono supportati.C# and C++ are supported. In alternativa, segui le istruzioni per creare un'app in Unity.(Or follow the instructions to create an app in Unity.)

Abilitazione della modalità sviluppatoreEnabling Developer Mode

Per iniziare, abilita Modalità sviluppatore sul tuo dispositivo per consentire a Visual Studio di connettersi.Start by enabling Developer Mode on your device, so Visual Studio can connect to it.

HoloLensHoloLens

  1. Accendi HoloLens e il dispositivo.Turn on your HoloLens and put on the device.
  2. Usare il gesto Start per avviare il menu principale.Use the start gesture to launch the main menu.
  3. Seleziona il riquadro Impostazioni per avviare l'app nell'ambiente in uso.Select the Settings tile to launch the app in your environment.
  4. Scegli la voce di menu Aggiorna.Select the Update menu item.
  5. Scegli la voce di menu Per gli sviluppatori.Select the For developers menu item.
  6. Abilitare Modalità sviluppatore per distribuire le app da Visual Studio al dispositivo HoloLens.Enable Developer Mode to deploy apps from Visual Studio to your HoloLens.
  7. Facoltativo: scorrere verso il basso e abilitare anche il Portale di dispositivi, che consente di connettersi al Portale di dispositivi di Windows in HoloLens da un Web browser.Optional: Scroll down and also enable Device Portal, which lets you connect to the Windows Device Portal on your HoloLens from a web browser.

PC WindowsWindows PC

Se si usa un visore VR di Windows Mixed Reality connesso al PC, è necessario abilitare Modalità sviluppatore nel PC.If you're working with a Windows Mixed Reality headset connected to your PC, you must enable Developer Mode on the PC.

  1. Vai a ImpostazioniGo to Settings
  2. Seleziona Aggiornamento e sicurezzaSelect Update and Security
  3. Seleziona Per gli sviluppatoriSelect For developers
  4. Abilitare Modalità sviluppatore, leggere la dichiarazione di non responsabilità relativa all'impostazione scelta e quindi selezionare Sì per accettare la modifica.Enable Developer Mode, read the disclaimer for the setting you chose, then select Yes to accept the change.

Distribuzione di un'app su una rete Wi-Fi - HoloLens (prima generazione)Deploying an app over Wi-Fi - HoloLens (1st gen)

  1. Seleziona una configurazione di build x86 per l'appSelect an x86 build configuration for your app
    Configurazione di build x86 in Visual Studiox86 build configuration in Visual Studio
  2. Seleziona Computer remoto nel menu a discesa delle destinazioni di distribuzioneSelect Remote Machine in the deployment target drop-down menu
    Destinazione di distribuzione computer remoto in Visual StudioRemote machine deployment target in Visual Studio
  3. Per i progetti C++ e JavaScript, vai a Progetto > Proprietà > Proprietà di configurazione > Debug.For C++ and JavaScript projects, go to Project > Properties > Configuration Properties > Debugging. Per i progetti C#, viene visualizzata automaticamente una finestra di dialogo per configurare la connessione.For C# projects, a dialog will automatically appear to configure your connection. a.a. Immetti l'indirizzo IP del tuo dispositivo nel campo Indirizzo o Nome computer.Enter the IP address of your device in the Address or Machine Name field. Puoi trovare l'indirizzo IP del tuo dispositivo HoloLens in Impostazioni > Rete e Internet > Opzioni avanzate oppure puoi chiedere a Cortana "Qual è il mio indirizzo 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. Imposta la modalità di autenticazione su Universale (protocollo non crittografato)Set Authentication Mode to Universal (Unencrypted protocol)
    Finestra di dialogo connessione remota in Visual StudioRemote connection dialog in Visual Studio
  4. Seleziona Debug > Avvia debug per distribuire l'app e avviare il debugSelect Debug > Start debugging to deploy your app and start debugging
    Avvia senza eseguire debug in Visual StudioStart Without Debugging in Visual Studio
  5. La prima volta che viene distribuita un'app in HoloLens dal PC, verrà chiesto di specificare un PIN.The first time you deploy an app to your HoloLens from your PC, you'lll be prompted for a PIN. Segui le istruzioni riportate di seguito in Associazione del dispositivo.Follow the Pairing your device instructions below.

Distribuzione di un'app su una rete Wi-Fi - HoloLens 2Deploying an app over Wi-Fi - HoloLens 2

  1. Seleziona una configurazione di build ARM o ARM64 per l'appSelect an ARM or ARM64 build configuration for your app
    Configurazione di build ARM64 in Visual StudioARM64 build configuration in Visual Studio
  2. Seleziona Computer remoto nel menu a discesa delle destinazioni di distribuzioneSelect Remote Machine in the deployment target drop-down menu
    Destinazione di distribuzione computer remoto in Visual StudioRemote machine deployment target in Visual Studio
  3. Per i progetti C++ e JavaScript, vai a Progetto > Proprietà > Proprietà di configurazione > Debug.For C++ and JavaScript projects, go to Project > Properties > Configuration Properties > Debugging. Per i progetti C#, viene visualizzata automaticamente una finestra di dialogo per configurare la connessione.For C# projects, a dialog will automatically appear to configure your connection. a.a. Immetti l'indirizzo IP del tuo dispositivo nel campo Indirizzo o Nome computer.Enter the IP address of your device in the Address or Machine Name field. Puoi trovare l'indirizzo IP del tuo dispositivo HoloLens in Impostazioni > Rete e Internet > Opzioni avanzate oppure puoi chiedere a Cortana "Qual è il mio indirizzo 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. Imposta la modalità di autenticazione su Universale (protocollo non crittografato)Set the Authentication Mode to Universal (Unencrypted protocol)
    Finestra di dialogo connessione remota in Visual StudioRemote connection dialog in Visual Studio
  4. Seleziona Debug > Avvia debug per distribuire l'app e avviare il debugSelect Debug > Start debugging to deploy your app and start debugging
    Avvia senza eseguire debug in Visual StudioStart Without Debugging in Visual Studio
  5. La prima volta che viene distribuita un'app in HoloLens dal PC, verrà chiesto di specificare un PIN.The first time you deploy an app to your HoloLens from your PC, you'll be prompted for a PIN. Segui le istruzioni riportate di seguito in Associazione del dispositivo.Follow the Pairing your device instructions below.

Se l'indirizzo IP di HoloLens cambia, puoi modificare l'indirizzo IP del computer di destinazione scegliendo Progetto > Proprietà > Proprietà di configurazione > DebugIf your HoloLens IP address changes, you can change the IP address of the target machine by going to Project > Properties > Configuration Properties > Debugging

Distribuzione di un'app tramite USB - HoloLens (prima generazione)Deploying an app over USB - HoloLens (1st gen)

  1. Seleziona una configurazione di build x86 per l'appSelect an x86 build configuration for your app
    Configurazione di build x86 in Visual Studiox86 build configuration in Visual Studio
  2. Seleziona Dispositivo nel menu a discesa delle destinazioni di distribuzioneSelect Device in the deployment target drop-down menu
    Distribuzione dispositivi in Visual StudioDevice deployment in Visual Studio
  3. Seleziona Debug > Avvia debug per distribuire l'app e avviare il debugSelect Debug > Start debugging to deploy your app and start debugging
    Avvia senza eseguire debug in Visual StudioStart Without Debugging in Visual Studio
  4. La prima volta che viene distribuita un'app in HoloLens dal PC, verrà chiesto di specificare un PIN.The first time you deploy an app to your HoloLens from your PC, you'll be prompted for a PIN. Segui le istruzioni riportate di seguito in Associazione del dispositivo.Follow the Pairing your device instructions below.

Distribuzione di un'app tramite USB - HoloLens 2Deploying an app over USB - HoloLens 2

  1. Seleziona una configurazione di build ARM o ARM64 per l'appSelect an ARM or ARM64 build configuration for your app
    Configurazione di build ARM64 in Visual StudioARM64 build configuration in Visual Studio
  2. Seleziona Dispositivo nel menu a discesa delle destinazioni di distribuzioneSelect Device in the deployment target drop-down menu
    Distribuzione dispositivi in Visual StudioDevice deployment in Visual Studio
  3. Seleziona Debug > Avvia debug per distribuire l'app e avviare il debugSelect Debug > Start debugging to deploy your app and start debugging
    Avvia senza eseguire debug in Visual StudioStart Without Debugging in Visual Studio
  4. La prima volta che viene distribuita un'app in HoloLens dal PC, verrà chiesto di specificare un PIN.The first time you deploy an app to your HoloLens from your PC, you'll be prompted for a PIN. Segui le istruzioni riportate di seguito in Associazione del dispositivo.Follow the Pairing your device instructions below.

Distribuzione di un'app nel PC locale - Visore VR immersiveDeploying an app to your Local PC - immersive headset

Per usare un visore VR immersive di Windows Mixed Reality che si connette al PC o al simulatore di realtà mista:To use a Windows Mixed Reality immersive headset that connects to your PC or the Mixed Reality simulator:

  1. Seleziona una configurazione di build x86 o x64 per l'appSelect an x86 or x64 build configuration for your app
  2. Seleziona Computer locale nel menu a discesa delle destinazioni di distribuzioneSelect Local Machine in the deployment target drop-down menu
  3. Seleziona Debug > Avvia debug per distribuire l'app e avviare il debugSelect Debug > Start debugging to deploy your app and start debugging

Associazione del dispositivoPairing your device

La prima volta che viene distribuita un'app da Visual Studio al dispositivo HoloLens, verrà chiesto di specificare un PIN.The first time you deploy an app from Visual Studio to your HoloLens, you'll be prompted for a PIN. In HoloLens generare un PIN avviando l'app Settings, passare a Update > For Developers (Aggiorna > Per gli sviluppatori) e toccare Pair (Associa).On the HoloLens, generate a PIN by launching the Settings app, go to Update > For Developers, and tap on Pair. Quando il PIN viene visualizzato in HoloLens, digitarlo in Visual Studio.When the PIN is displayed on your HoloLens, type it into Visual Studio. Al termine dell'associazione, tocca Fine su HoloLens per chiudere la finestra di dialogo.After pairing is complete, tap Done on your HoloLens to dismiss the dialog. Il PC è ora associato a HoloLens ed è possibile distribuire le app automaticamente.This PC is now paired with the HoloLens and you can deploy apps automatically. Ripetere questi passaggi per tutti i PC usati per distribuire app in HoloLens.Repeat these steps for every PC that's used to deploy apps to your HoloLens.

Per dissociare HoloLens da tutti i computer associati:To unpair your HoloLens from all paired computers:

  • Avviare l'app Settings, passare a Update > For Developers (Aggiorna > Per sviluppatori) e toccare Clear (Cancella).Launch the Settings app, go to Update > For Developers, and tap on Clear.

Distribuzione di un'app nell'emulatore HoloLens (prima generazione)Deploying an app to the HoloLens (1st gen) Emulator

  1. Assicurarsi di aver installato l'emulatore HoloLens .Make sure you've installed the HoloLens Emulator.
  2. Seleziona una configurazione di build x86 per l'app.Select an x86 build configuration for your app.
    Configurazione di build x86 in Visual Studiox86 build configuration in Visual Studio
  3. Seleziona Emulatore HoloLens nel menu a discesa delle destinazioni di distribuzioneSelect HoloLens Emulator in the deployment target drop-down menu
    Destinazione Emulatore in Visual StudioEmulator target in Visual Studio
  4. Seleziona Debug > Avvia debug per distribuire l'app e avviare il debugSelect Debug > Start debugging to deploy your app and start debugging
    Avvia senza eseguire debug in Visual StudioStart Without Debugging in Visual Studio

Distribuzione di un'app nell'emulatore HoloLens 2Deploying an app to the HoloLens 2 Emulator

  1. Assicurarsi di aver installato l'emulatore HoloLens .Make sure you've installed the HoloLens Emulator.
  2. Seleziona una configurazione di build x86 o x64 per l'app.Select an x86 or x64 build configuration for your app.
    Configurazione di build x86 in Visual Studiox86 build configuration in Visual Studio
  3. Seleziona Emulatore HoloLens 2 nel menu a discesa delle destinazioni di distribuzioneSelect HoloLens 2 Emulator in the deployment target drop-down menu
    Destinazione Emulatore in Visual StudioEmulator target in Visual Studio
  4. Seleziona Debug > Avvia debug per distribuire l'app e avviare il debugSelect Debug > Start debugging to deploy your app and start debugging
    Avvia senza eseguire debug in Visual StudioStart Without Debugging in Visual Studio

Debugger grafica per HoloLens (prima generazione)Graphics Debugger for HoloLens (1st gen)

Gli strumenti di Diagnostica della grafica di Visual Studio sono utili per la scrittura e l'ottimizzazione di un'app olografica.The Visual Studio Graphics Diagnostics tools are helpful when writing and optimizing a Holographic app. Per informazioni dettagliate, vedi Diagnostica della grafica di Visual Studio su MSDN.See Visual Studio Graphics Diagnostics on MSDN for full details.

Per avviare Debugger graficaTo Start the Graphics Debugger

  1. Segui le istruzioni riportate sopra per specificare come destinazione un dispositivo o un emulatoreFollow the instructions above to target a device or emulator
  2. Vai a Debug > Grafica > Avvia diagnosticaGo to Debug > Graphics > Start Diagnostics
  3. La prima volta che viene avviata la diagnostica con un dispositivo HoloLens, è possibile che venga restituito un errore di accesso negato.The first time you start diagnostics with a HoloLens, you may get an "access denied" error. Riavviare il dispositivo HoloLens per rendere effettive le autorizzazioni aggiornate e riprovare.Reboot your HoloLens to let the updated permissions take effect and try again.

ProfilaturaProfiling

Gli strumenti di profilatura di Visual Studio consentono di analizzare le prestazioni e l'uso delle risorse dell'app.The Visual Studio profiling tools allow you to analyze your app's performance and resource use. Sono inclusi strumenti per ottimizzare l'uso di CPU, memoria, grafica e rete.This includes tools to optimize CPU, memory, graphics, and network use. Per i dettagli completi, vedi Eseguire strumenti di diagnostica senza debug in MSDN.See Run diagnostic tools without debugging on MSDN for full details.

Per avviare gli strumenti di profilatura con HoloLensTo Start the Profiling Tools with HoloLens

  1. Segui le istruzioni riportate sopra per specificare come destinazione un dispositivo o un emulatoreFollow the instructions above to target a device or emulator
  2. Vai a Debug > Avvia strumenti di diagnostica senza debugGo to Debug > Start Diagnostic Tools Without Debugging...
  3. Seleziona gli strumenti che vuoi usareSelect the tools you want to use
  4. Selezionare Avvia.Select Start
  5. La prima volta che viene avviata la diagnostica senza debug con un dispositivo HoloLens, è possibile che venga restituito un errore di accesso negato.The first time you start diagnostics without debugging with a HoloLens, you may get an "access denied" error. Riavviare il dispositivo HoloLens per rendere effettive le autorizzazioni aggiornate e riprovare.Reboot your HoloLens to let the updated permissions take effect and try again.

Debug di un'app installata o in esecuzioneDebugging an installed or running app

È possibile usare Visual Studio per eseguire il debug di un'app di Windows universale installata senza distribuzione da un progetto di Visual Studio.You can use Visual Studio to debug an installed Universal Windows app without deploying from a Visual Studio project. Questa opzione è utile se si vuole eseguire il debug di un pacchetto dell'app installato o di un'app già in esecuzione.This is useful if you want to debug an installed app package or debug an app that's already running.

  1. Vai a Debug -> Altre destinazioni debug -> Debug del pacchetto dell'app installatoGo to Debug -> Other Debug Targets -> Debug Installed App Package
  2. Seleziona la destinazione Computer remoto per HoloLens o Computer locale per i visori VR immersive.Select the Remote Machine target for HoloLens or Local Machine for immersive headsets.
  3. Immetti l'indirizzo IP del dispositivoEnter your device’s IP address
  4. Scegli la modalità di autenticazione UniversaleChoose the Universal Authentication Mode
  5. La finestra mostra le app in esecuzione e inattive.The window shows both running and inactive apps. Seleziona quella di cui vuoi eseguire il debug.Pick the one what you’d like to debug.
  6. Scegli il tipo di codice di cui eseguire il debug (gestito, nativo, misto)Choose the type of code to debug (Managed, Native, Mixed)
  7. Selezionare Associa o Avvia.Select Attach or Start

Successivo checkpoint di sviluppoNext Development Checkpoint

Se si segue il percorso di checkpoint per lo sviluppo con Unity che è stato delineato, ci si trova nella fase di distribuzione.If you're following the Unity development checkpoint journey we've laid out, you're in the midst of the deployment stage. Da qui, è possibile passare all'argomento successivo:From here, you can continue to the next topic:

In alternativa, passare direttamente all'aggiunta di servizi avanzati:Or jump directly to adding advanced services:

È sempre possibile tornare ai checkpoint per lo sviluppo con Unity in qualsiasi momento.You can always go back to the Unity development checkpoints at any time.

Vedere ancheSee also