Aggiungere classi, moduli e plug-in di Unreal Engine in Visual Studio

Questo articolo illustra come usare Strumenti di Visual Studio per un motore Unreal per:

• Aggiungere moduli unreal Engine in Visual Studio
• Aggiungere classi unreal Engine in Visual Studio
• Aggiungere plug-in Unreal Engine in Visual Studio

Prerequisiti

È necessario installare quanto segue:

• Visual Studio versione 17.11 (17.11 preview versioni ok) o versioni successive.
• Unreal Engine versione 5 o successiva.
• Strumenti di Visual Studio per Unreal Engine. Per istruzioni sull'installazione, vedere Installare Strumenti di Visual Studio per Unreal Engine.
• Completare la guida introduttiva: Strumenti di Visual Studio per Unreal Engine per scaricare e compilare il gioco Lyra e configurarlo per l'uso di Strumenti di Visual Studio per Unreal Engine.

Aggiungere moduli unreal Engine in Visual Studio

È ora possibile aggiungere moduli Unreal Engine al progetto Unreal Engine da Visual Studio. Non è più necessario passare dall'Editor del motore Unreal a Visual Studio per aggiungere un modulo oppure è necessario sincronizzare la soluzione Visual Studio con il file di progetto Unreal Engine in un secondo momento.

I moduli sono un modo per organizzare il codice in Unreal Engine. Consentono di raggruppare le classi e gli asset correlati e di organizzare il codice in unità autonome che possono essere caricate e scaricate in fase di esecuzione. La creazione di moduli può essere noiosa e soggetta a errori se viene eseguita manualmente perché richiede la modifica dei file di configurazione e l'aggiunta di codice boilerplate. Visual Studio semplifica la creazione di moduli fornendo una finestra di dialogo che consente di scorrere il processo e di eseguire la configurazione e di aggiungere automaticamente il boilerplate.

Per aggiungere un modulo Unreal Engine in Visual Studio, seguire questa procedura dopo aver completato Avvio rapido: Strumenti di Visual Studio per Unreal Engine per scaricare e compilare il gioco Lyra. Questi passaggi presuppongono che la LyraStarterGame.sln soluzione sia aperta in Visual Studio:

1. In Esplora soluzioni scegliere un progetto, ad esempio LyraStarterGame, in cui si vuole che il nuovo modulo vada.
2. Fare clic con il pulsante destro del mouse sul progetto (assicurarsi che un progetto sia selezionato e non una cartella) e scegliere Aggiungi>elemento motore unreal... per aprire la finestra di dialogo Aggiungi nuovo elemento per gli elementi di Unreal Engine:
3. Scegliere Modulo motore unreal, specificare un nome del modulo nel campo Nome e quindi scegliere Aggiungi per aprire la finestra di dialogo Aggiungi modulo motore unreal:

   

   La finestra di dialogo Aggiungi modulo motore unreal include un campo per il nome del modulo, gli elenchi a discesa per il tipo di modulo (è selezionato Runtime) e la fase di caricamento del modulo (impostazione predefinita è selezionata). Vengono elencati il percorso del modulo, l'intestazione, l'origine e i percorsi dei file di compilazione. Viene selezionata la casella di controllo Per aggiornare le informazioni di IntelliSense usando gli strumenti dell'editor Unreal.

4. Usare gli elenchi a discesa per selezionare il tipo di modulo e la fase di caricamento del modulo.
5. Scegliere OK per aggiungere il modulo al progetto e aggiornare il file della soluzione di Visual Studio.

I moduli possono essere creati solo nella cartella Source o come modulo di un plug-in all'interno della cartella Plugins .
Il percorso di compilazione mostra dove viene creato il Build.cs file. Il Build.cs file contiene informazioni di configurazione per il modulo.

Aggiungere classi unreal Engine in Visual Studio

È ora possibile aggiungere classi Unreal Engine al progetto Unreal Engine da Visual Studio. Non è più necessario passare da Unreal Editor a Visual Studio per aggiungere una classe oppure è necessario sincronizzare la soluzione Visual Studio con il file di progetto Unreal Engine in un secondo momento.

Per aggiungere una classe Unreal Engine in Visual Studio, seguire questa procedura dopo aver completato Avvio rapido: Strumenti di Visual Studio per Unreal Engine per scaricare e compilare il gioco Lyra. I passaggi presuppongono che la LyraStarterGame.sln soluzione sia aperta in Visual Studio:

1. In Esplora soluzioni scegliere una cartella in cui si vuole passare la nuova classe. Nel progetto LyraStarterGame è possibile aggiungere una nuova classe alla cartella Origine LyraStarterGame>, ad esempio.
2. Fare clic con il pulsante destro del mouse sulla cartella e scegliere Aggiungi>elemento motore unreal... per aprire la finestra di dialogo Aggiungi nuovo elemento:

   

   Include opzioni per l'aggiunta di classi comuni del motore Unreal (selezionata), modulo motore Unreal vuoto e plug-in del motore Unreal.

3. Scegliere Classi comuni del motore Unreal e quindi scegliere Aggiungi per aprire la finestra di dialogo Aggiungi classe del motore unreal:

   

   Le opzioni per la selezione di una base, ad esempio Attore, Carattere e così via, sono visibili. È disponibile un campo per il nome della classe e un elenco a discesa per il modulo a cui aggiungere la classe. Vengono elencati i percorsi del file di intestazione e del file di origine. È selezionata una casella di controllo per aggiornare le informazioni di IntelliSense usando gli strumenti dell'editor Unreal.

4. Scegliere un nome di classe. Visual Studio avvisa se il nome è in conflitto con una classe o un file esistente.
5. Scegliere una classe base. La selezione di una classe base garantisce che le intestazioni e le macro corrette siano incluse per tale tipo di classe.
6. Scegliere un modulo da aggiungere alla classe usando l'elenco a discesa Seleziona un modulo per aggiungere la classe . Il nome del modulo è il nome della cartella che contiene il modulo.
7. Selezionare la casella di controllo Aggiorna informazioni di IntelliSense usando gli strumenti dell'editor Unreal per scegliere se Visual Studio usa gli strumenti di Editor Unreal per aggiornare le informazioni di IntelliSense. Scegliere questa opzione per fare in modo che lo strumento di compilazione Unreal rigenera il file della soluzione di Visual Studio.
8. Scegliere OK per generare i file di intestazione e di origine per la nuova classe e aggiungerli al file della soluzione di Visual Studio. In questo modo viene richiesto di ricaricare il progetto. Scegliere Ricarica per ricaricare il progetto.

Aggiungere plug-in Unreal Engine in Visual Studio

È ora possibile aggiungere plug-in Unreal Engine al progetto Unreal Engine da Visual Studio. Non è più necessario passare da Unreal Editor a Visual Studio per aggiungere un plug-in oppure è necessario sincronizzare la soluzione Visual Studio con il file di progetto Unreal Engine in un secondo momento.

Per aggiungere un plug-in Unreal Engine in Visual Studio, seguire questa procedura dopo aver completato Avvio rapido: Strumenti di Visual Studio per Unreal Engine per scaricare e compilare il gioco Lyra. I passaggi presuppongono che la LyraStarterGame.sln soluzione sia aperta in Visual Studio:

1. In Esplora soluzioni scegliere una cartella in cui si vuole che il nuovo plug-in vada. Nel progetto LyraStarterGame è possibile aggiungere un nuovo plug-in alla cartella LyraStarterGame>Source, ad esempio.
2. Fare clic con il pulsante destro del mouse sulla cartella e scegliere Aggiungi>elemento motore unreal... per aprire la finestra di dialogo Aggiungi nuovo elemento:

   

   Include opzioni per l'aggiunta di classi comuni del motore Unreal, modulo motore Unreal vuoto e plug-in del motore Unreal (selezionata).

3. Scegliere Plug-in del motore unreal e quindi scegliere Aggiungi per aprire la finestra di dialogo Aggiungi plug-in del motore unreal:

   

   È disponibile un elenco di tipi di plug-in (è selezionato Avanzate) e i campi per il nome del plug-in, il percorso, l'autore, la descrizione e l'URL. È presente una casella di controllo Is plugin in beta (deselezionata) e le informazioni di Refresh IntelliSense tramite la casella di controllo Unreal Editor Tools (selezionata).

4. Scegliere il tipo di plug-in dall'elenco Tipo di plug-in.
5. Specificare il nome del plug-in, l'autore del plug-in, la descrizione del plug-in e l'URL del plug-in.
6. Selezionare la casella Is plugin in beta in base alle esigenze.
7. Selezionare la casella di controllo Aggiorna informazioni di IntelliSense usando gli strumenti dell'editor Unreal per scegliere se Visual Studio usa gli strumenti dell'editor Unreal per aggiornare le informazioni di IntelliSense. In questo modo, lo strumento di compilazione Unreal rigenera il file di soluzione di Visual Studio.
8. Scegliere Aggiungi per generare l'intestazione del plug-in e i file di origine per il nuovo plug-in e aggiungerli al file della soluzione di Visual Studio. In questo modo viene richiesto di ricaricare il progetto. Scegliere Ricarica per ricaricare il progetto.

Contenuto correlato

Strumenti di Visual Studio per un motore Unreal
Visualizzare progetti unreal Engine in Visual Studio
Visualizzare la registrazione di Unreal Engine in Visual Studio
Visualizzare le macro di Unreal Engine in Visual Studio