Condividi tramite


Uso di Visual Studio per la distribuzione e il 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. In questa sezione si apprenderà come:

  • Distribuire applicazioni nel visore VR immersive di HoloLens o Windows Mixed Reality tramite Visual Studio.
  • Usare l'emulatore HoloLens integrato in Visual Studio.
  • Eseguire il debug di app di realtà mista.

Prerequisiti

  1. Per le istruzioni di installazione, vedi Installare gli strumenti.
  2. Creare un nuovo progetto di realtà mista in Unity o Visual Studio.
  3. Compilare il progetto Unity in base alle istruzioni

Abilitazione della modalità sviluppatore

Per iniziare, abilitare la modalità sviluppatore nel dispositivo in modo che Visual Studio possa connettersi.

Modalità sviluppatore in HoloLens

  1. Accendi HoloLens e il dispositivo.
  2. Usare il gesto Start per avviare il menu principale.
  3. Seleziona il riquadro Impostazioni per avviare l'app nell'ambiente in uso.
  4. Scegli la voce di menu Aggiorna.
  5. Scegli la voce di menu Per gli sviluppatori.
  6. Abilitare Usa funzionalità sviluppatore per distribuire le app da Visual Studio al dispositivo HoloLens. Se il dispositivo esegue Windows Holographic versione 21H1 o successiva, abilitare anche l'individuazione dei dispositivi.
  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.

Modalità sviluppatore in un PC Windows

Se si usa un visore VR di Windows Mixed Reality connesso al PC, è necessario abilitare Modalità sviluppatore nel PC.

  1. Passare a Impostazioni.
  2. Seleziona Aggiornamento e sicurezza.
  3. Selezionare Per sviluppatori.
  4. Abilitare la modalità sviluppatore, leggere la dichiarazione di non responsabilità per l'impostazione scelta e quindi selezionare per accettare la modifica.

Distribuzione di un'app HoloLens tramite Wi-Fi o USB

Opzioni di compilazione

  1. Aprire il progetto in Visual Studio

  2. Fare clic sull'elenco a discesa Opzioni di compilazione e quindi eseguire una delle operazioni seguenti:

    • Per i progetti Unity, scegliere Release o Master
    • Per tutti gli altri progetti, scegliere Rilascio

    Screenshot che mostra le opzioni di compilazione in Visual Studio

    Ecco le definizioni per le opzioni di compilazione:

Configurazione Spiegazione
Debug Tutte le ottimizzazioni sono disattivate e il profiler è abilitato. Usato per eseguire il debug degli script.
Master Tutte le ottimizzazioni sono attivate e il profiler è disabilitato. Usato per inviare app allo Store.
Versione Tutte le ottimizzazioni sono attivate e il profiler è abilitato. Usato per valutare le prestazioni dell'app.

Configurare la compilazione

  1. Selezionare la configurazione di compilazione in base al dispositivo.

    Scegliere l'opzione di configurazione ARM o ARM64

    Configurazione della build ARM64 in Visual Studio

    Per altre informazioni sulle configurazioni di compilazione, vedere la tabella "Tipi di configurazioni di compilazione" nella documentazione di Unity.

    Nota

    Per la distribuzione nel dispositivo HoloLens 2, scegliere l'architettura ARM64 o ARM.

    Se non viene visualizzata l'opzione Dispositivo come destinazione, potresti dover modificare il progetto di avvio per la soluzione di Visual Studio passando dal progetto IL2CPP al progetto UWP. A tale scopo, nella Esplora soluzioni fare clic con il pulsante destro del mouse sul progetto e quindi scegliere Imposta come progetto di avvio.

  2. Fare clic sull'elenco a discesa per la destinazione della distribuzione e quindi eseguire una di queste operazioni:

    • Se la compilazione e la distribuzione vengono eseguite tramite Wi-Fi, selezionare Computer remoto.

    Selezionare

    • Se la compilazione e la distribuzione vengono eseguite tramite USB, seleziona Dispositivo.

    Selezionare

Connessione remota

Per impostare la connessione remota:

  1. Nella barra dei menu selezionare > Proprietà progetto Proprietà > di configurazione > Debug.

    Nota

    Per un progetto C#, verrà visualizzata automaticamente una finestra di dialogo.

  2. Fare clic sull'elenco a discesa Debugger per avviare e quindi selezionare Computer remoto.

  3. Nel campo Machine Name immettere l'indirizzo IP del dispositivo.

    Finestra di dialogo Connessione remota in Visual Studio

    • È possibile trovare l'indirizzo IP in HoloLens in Impostazioni > Rete & Opzioni avanzate Internet>.

    • È consigliabile immettere manualmente l'indirizzo IP invece di dipendere dalla funzionalità "A rilevamento automatico".

  4. Impostare la Authentication Mode su Universal (Unencrypted protocol).

  5. Compilare, distribuire ed eseguire il debug dell'app in base alle esigenze:

    • Per compilare, distribuire e avviare il debug, selezionare Debug > Avvia debug.

    • Per compilare e distribuire senza eseguire il debug, selezionare Compila distribuisci > soluzione.

  6. La prima volta che viene distribuita un'app in HoloLens dal PC, verrà chiesto di specificare un PIN. Segui le istruzioni riportate di seguito in Associazione del dispositivo.

Nota

Se gli errori elencati di seguito si verificano quando si avvia il debug di un'applicazione UWP installata nel HoloLens 2, provare a rinominare il pacchetto o disinstallare l'applicazione UWP.

"Impossibile avviare il debug"
"Operazione non supportata. Errore sconosciuto: 0x80070057"

Distribuzione di un'app nell'emulatore HoloLens (prima generazione)

  1. Assicurarsi di aver installato l'emulatore HoloLens .
  2. Seleziona una configurazione di build x86 per l'app. Selezionare una configurazione di compilazione x86 in Visual Studio
  3. Selezionare Emulatore HoloLens nel menu
    a discesa Destinazione distribuzioneDestinazione emulatore in Visual Studio
  4. Selezionare Debug > Avvia debug per distribuire l'app e avviare il debug
    Avvia senza eseguire debug in Visual Studio

Distribuzione di un'app nell'emulatore HoloLens 2

  1. Assicurarsi di aver installato l'emulatore HoloLens .
  2. Selezionare una configurazione di compilazione x86 o x64 per l'app.
    Configurazione dell'impostazione di compilazione x86 in Visual Studio
  3. Selezionare HoloLens 2 Emulatore nel menu
    a discesa Destinazione distribuzioneDestinazione emulatore nell'applicazione di Visual Studio
  4. Selezionare Debug > Avvia debug per distribuire l'app e avviare il debug
    Avvia senza eseguire debug in Visual Studio

Distribuzione di un'app VR nel PC locale

Per usare un visore VR immersive di Windows Mixed Reality che si connette al PC o al simulatore di realtà mista:

  1. Seleziona una configurazione di build x86 o x64 per l'app
  2. Seleziona Computer locale nel menu a discesa delle destinazioni di distribuzione
  3. Compilare, distribuire ed eseguire il debug dell'app in base alle esigenze
    • Selezionare Debug > Avvia debug per distribuire l'app e avviare il debug
    • Selezionare Build Deploy (Distribuisci compilazione>) per compilare e distribuire senza eseguire il debug

Associazione del dispositivo

La prima volta che viene distribuita un'app da Visual Studio al dispositivo HoloLens, verrà chiesto di specificare un PIN. In HoloLens generare un PIN avviando l'app Impostazioni, passare a Aggiorna > per sviluppatori e toccare Associa. Quando il PIN viene visualizzato in HoloLens, digitarlo in Visual Studio. Al termine dell'associazione, tocca Fine su HoloLens per chiudere la finestra di dialogo. Il PC è ora associato a HoloLens ed è possibile distribuire le app automaticamente. Ripetere questi passaggi per tutti i PC usati per distribuire app in HoloLens.

Per dissociare HoloLens da tutti i computer associati:

  • Avviare l'app Impostazioni , passare a Aggiorna > per sviluppatori e toccare Cancella.

Debugger grafica per HoloLens (prima generazione)

Gli strumenti di Diagnostica della grafica di Visual Studio sono utili per la scrittura e l'ottimizzazione di un'app olografica. Per informazioni dettagliate, vedi Diagnostica della grafica di Visual Studio su MSDN.

Per avviare Debugger grafica

  1. Segui le istruzioni riportate sopra per specificare come destinazione un dispositivo o un emulatore
  2. Passare a Debug grafica Start Diagnostics (Diagnostica avvio grafica > debug>)
  3. La prima volta che viene avviata la diagnostica con un dispositivo HoloLens, è possibile che venga restituito un errore di accesso negato. Riavviare il dispositivo HoloLens per rendere effettive le autorizzazioni aggiornate e riprovare.

Profilatura

Gli strumenti di profilatura di Visual Studio consentono di analizzare le prestazioni e l'uso delle risorse dell'app. Sono inclusi strumenti per ottimizzare l'uso di CPU, memoria, grafica e rete. Per i dettagli completi, vedi Eseguire strumenti di diagnostica senza debug in MSDN.

Per avviare gli strumenti di profilatura con HoloLens

  1. Segui le istruzioni riportate sopra per specificare come destinazione un dispositivo o un emulatore
  2. Passare a Debug > Avvia strumenti di diagnostica senza eseguire il debug...
  3. Seleziona gli strumenti che vuoi usare
  4. Selezionare Avvia.
  5. La prima volta che viene avviata la diagnostica senza debug con un dispositivo HoloLens, è possibile che venga restituito un errore di accesso negato. Riavviare il dispositivo HoloLens per rendere effettive le autorizzazioni aggiornate e riprovare.

Debug di un'app installata o in esecuzione

È possibile usare Visual Studio per eseguire il debug di un'app di Windows universale installata senza distribuzione da un progetto di Visual Studio. Questa opzione è utile se si vuole eseguire il debug di un pacchetto dell'app installato o di un'app già in esecuzione.

  1. Passare a Debug -> Altre destinazioni di debug -> Eseguire il debug del pacchetto dell'app installato
  2. Seleziona la destinazione Computer remoto per HoloLens o Computer locale per i visori VR immersive.
  3. Immetti l'indirizzo IP del dispositivo
  4. Scegli la modalità di autenticazione Universale
  5. La finestra mostra le app in esecuzione e inattive. Seleziona quella di cui vuoi eseguire il debug.
  6. Scegli il tipo di codice di cui eseguire il debug (gestito, nativo, misto)
  7. Selezionare Associa o Avvia.

Successivo checkpoint di sviluppo

Se si segue il percorso di checkpoint per lo sviluppo con Unity che è stato delineato, ci si trova nella fase di distribuzione. Da qui, è possibile passare all'argomento successivo:

In alternativa, passare direttamente all'aggiunta di servizi avanzati:

È sempre possibile tornare ai checkpoint per lo sviluppo con Unity in qualsiasi momento.

Vedere anche