Usare Visual Studio Tools per Unity

In questa sezione verrà illustrato come usare le funzionalità per l'integrazione e la produttività di Visual Studio Tools per Unity e come usare il debugger di Visual Studio per lo sviluppo di Unity.

Aprire script Unity in Visual Studio

Dopo aver impostato Visual Studio come editor esterno per Unity, fare doppio clic su uno script dall'editor di Unity per avviare o passare automaticamente a Visual Studio e aprire lo script scelto.Once Visual Studio is set as the external editor for Unity, double-click a script from the Unity editor will automatically launch or switch to Visual Studio and open the chosen script.

In alternativa, è possibile aprire Visual Studio senza script aperto nell'editor di origine selezionando il menu Asset > Apri progetto C# in Unity.

Accesso della documentazione di Unity

È possibile accedere rapidamente alla documentazione di Unity da Visual Studio. Se Visual Studio Tools per Unity non trova la documentazione dell'API in locale, proverà a individuarla online.

IntelliSense per messaggi dell'API Unity

Ciò semplifica l'implementazione di messaggi dell'API Unity negli script MonoBehaviour e assiste nell'apprendimento dell'API Unity. Per usare IntelliSense per i messaggi Unity:

1. Posizionare il cursore su una nuova riga nel corpo di una classe che deriva da MonoBehaviour.

2. Iniziare digitando il nome di un messaggio Unity, ad esempio OnTriggerEnter.

3. Dopo aver digitato le lettere "ontri", viene visualizzato un elenco di suggerimenti di IntelliSense.

4. La selezione nell'elenco può essere modificata in tre modi:

   • Con le frecce su e giù.

   • Facendo clic con il mouse sull'elemento desiderato.

   • Continuando a digitare il nome dell'elemento desiderato.

5. IntelliSense può inserire il messaggio di Unity selezionato, includendo gli eventuali parametri necessari:

   • Premendo Tab.

   • Premendo Invio.

   • Facendo doppio clic sull'elemento selezionato.

Procedura guidata MonoBehaviour di Unity per la creazione di script

È possibile usare la procedura guidata Monobehaviour per visualizzare un elenco di tutti i metodi dell'API di Unity e implementare rapidamente una definizione vuota. Questa funzionalità, in particolare se è attivata l'opzione Genera commenti del metodo, è utile se si sta ancora imparando cosa è disponibile nell'API di Unity.

Per creare definizioni vuote di metodi MonoBehaviour con la procedura guidata MonoBehaviour:

1. In Visual Studio posizionare il cursore nel punto in cui si vogliono inserire i metodi e quindi premere CTRL+MAIUSC+M per avviare la procedura guidata MonoBehaviour. In Visual Studio per Mac premere CMD+MAIUSC+M.

2. Nella finestra Create script methods (Crea metodi script) selezionare la casella di controllo accanto al nome dei singoli metodi da aggiungere.

3. Usare l'elenco a discesa Framework version (Versione framework) per selezionare la versione desiderata.

4. Per impostazione predefinita, i metodi vengono inseriti in corrispondenza del cursore. In alternativa, è possibile inserirli dopo tutti i metodi già implementati nella classe modificando il valore del punto di inserimento con la posizione desiderata.

5. Se si vuole che la procedura guidata generi commenti per i metodi selezionati, selezionare la casella di controllo Genera commenti del metodo. Questi commenti vengono usati per facilitare l'individuazione del punto in cui viene chiamato il metodo e chiarirne le responsabilità generali.

6. Fare clic su OK per chiudere la procedura guidata e inserire i metodi nel codice.

Esplora progetti Unity

Esplora progetti Unity visualizza tutti i file di progetto Unity e tutte le directory nella stessa gerarchia usata dall'editor di Unity. Si differenzia dall'esplorazione degli script Unity con Esplora soluzioni Visual Studio standard, che li organizza in progetti e in una soluzione generata da Visual Studio.

Debug di Unity

Visual Studio Tools per Unity consente di eseguire il debug di script dell'editor e di gioco del progetto Unity usando il potente debugger di Visual Studio.

Eseguire il debug nell'editor di Unity

Consente di iniziare il debug

2. Passare a Unity e fare clic sul pulsante Riproduci per eseguire il gioco nell'editor.

3. Quando il gioco è in esecuzione nell'editor di Unity mentre è connesso a Visual Studio, qualsiasi punto di interruzione incontrato causa la sospensione dell'esecuzione del gioco e la visualizzazione della riga di codice dove il gioco ha incontrato il punto di interruzione in Visual Studio.

Arrestare l'esecuzione del debug

Per altre informazioni sul debug in Visual Studio, vedere La documentazione per esaminare prima il debugger di Visual Studio.

Collega a Unity e gioca

Per maggiore praticità, è possibile modificare il pulsante Collega a Unity in Collega a Unity e gioca.

Eseguire il debug di compilazioni del lettore Unity

È possibile eseguire il debug delle build di sviluppo di lettori Unity con Visual Studio.

Per abilitare il debug di script in un lettore Unity

1. In Unity aprire il Impostazioni di compilazione selezionando Compilazione file > Impostazioni.

2. Nella finestra Impostazioni di compilazione del progetto Unity selezionare le caselle di controllo Development Build (Build di sviluppo) e Script Debugging (Debug di script).

   

Selezionare un'istanza di Unity alla quale connettere il debugger

Eseguire il debug di una DLL nel progetto Unity

Molti sviluppatori Unity scrivono componenti di codice sotto forma di DLL esterne in modo da facilitare la condivisione della funzionalità sviluppata con altri progetti. Visual Studio Tools per Unity semplifica il debug del codice in queste DLL con altro codice del progetto Unity.

Lo scenario descritto in questo articolo presuppone che l'utente sia proprietario del codice sorgente disponibile, ovvero che si stia sviluppando o riutilizzando il proprio codice oppure che il codice sorgente sia inserito in una libreria di terze parti e si intenda distribuirlo nel progetto Unity sotto forma di DLL. Lo scenario non illustra il debug di una DLL di cui l'utente non è proprietario del codice sorgente.

Per eseguire il debug di un progetto di DLL gestita usato nel progetto Unity

1. Aggiungere il progetto di DLL esistente alla soluzione di Visual Studio generata da Visual Studio Tools per Unity. Può capitare meno frequentemente di avviare un nuovo progetto di DLL gestita per contenere i componenti di codice nel progetto Unity. In questo caso, è possibile aggiungere un nuovo progetto di DLL gestita alla soluzione Visual Studio.

   

   In entrambi i casi, Visual Studio Tools per Unity mantiene il riferimento al progetto, anche se deve rigenerare nuovamente i file di progetto e soluzione, di conseguenza è necessario eseguire questi passaggi una sola volta.

2. Fare riferimento al profilo del framework Unity corretto nel progetto di DLL. Nelle proprietà del progetto di DLL in Visual Studio impostare la proprietà Framework di destinazione sulla versione del framework Unity usata. Si tratta della libreria di classi base Unity corrispondente alla compatibilità API di destinazione del progetto, ad esempio le librerie di classi base complete, micro o Web di Unity. In questo modo la DLL non potrà chiamare metodi del framework esistenti in altri framework o livelli di compatibilità ma che potrebbero non esistere nella versione del framework Unity usata.

3. Copiare la DLL nella cartella Assets del progetto Unity. In Unity gli asset sono file che vengono inseriti nel pacchetto dell'app Unity e distribuiti con questa per consentirne il caricamento al runtime. Poiché le DLL sono collegate in fase di esecuzione, le DLL devono essere distribuite come asset. Per distribuire le DLL come asset, l'editor di Unity richiede che vengano inserite nella cartella Assets del progetto Unity. Questa operazione può essere eseguita nei due modi seguenti:

   • Modificare le impostazioni di compilazione del progetto di DLL in modo da includere un'attività di post-compilazione che copi la DLL di output e i file PDB dalla cartella di output alla cartella Assets (Asset) del progetto Unity.

   • Modificare le impostazioni di compilazione del progetto di DLL in modo da impostare come cartella di output la cartella Assets (Asset) del progetto Unity. La DLL e i file PDB verranno entrambi inseriti nella cartella Assets (Asset).

   I file PDB sono necessari per il debug perché contengono i simboli di debug della DLL e consentono di eseguire il mapping del codice della DLL al formato del relativo codice sorgente. Se si specifica come destinazione il runtime legacy, Visual Studio Tools per Unity userà le informazioni della DLL e dei file PDB per creare un file DLL.MDB, che corrisponde al formato dei simboli di debug usato dal motore di scripting legacy di Unity. Se si specifica come destinazione il nuovo runtime e si usa PDB portatile, Visual Studio Tools per Unity non tenterà di eseguire alcuna conversione dei simboli, poiché il nuovo runtime di Unity è in grado di usare in modo nativo i file PDB portatili.

   Altre informazioni sulla generazione dei PDB sono disponibili qui. Se si specifica come destinazione il nuovo runtime, assicurarsi che "Informazioni di debug" sia impostato su "Portatile" per generare correttamente il file PDB portatile. Se si specifica come destinazione il runtime legacy, è necessario usare "Completo".

4. Eseguire il debug del codice. È ora possibile eseguire il debug del codice sorgente della DLL con il codice sorgente del progetto Unity e usare tutte le funzionalità di debug a cui si è abituati, ad esempio punti di interruzione ed esecuzione del codice un'istruzione alla volta.

Scelte rapide da tastiera

Per accedere rapidamente alle funzionalità degli strumenti Unity per Visual Studio, è possibile usare i tasti di scelta rapida elencati di seguito.