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

Questo articolo illustra come usare Visual Studio Tools for Unreal Engine per:

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

Prerequisiti

È necessario installare quanto segue:

• Visual Studio versione 17.11 o successiva.
• Unreal Engine versione 5 o successiva.
• Visual Studio Tools per unreal Engine. Per istruzioni sull'installazione, vedere Installare Visual Studio Tools for Unreal Engine.
• Completare la guida introduttiva : Visual Studio Tools for Unreal Engine per scaricare e compilare il gioco Lyra e configurarlo per l'uso di Visual Studio Tools 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: Visual Studio Tools for Unreal Engine per scaricare e compilare il gioco Lyra. Questi passaggi presuppongono che la soluzione LyraStarterGame.sln sia aperta in Visual Studio:

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

   

   La finestra di dialogo Aggiungi modulo Unreal Engine contiene 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 (è selezionata Predefinita). Vengono elencati il percorso del modulo, l'intestazione, l'origine e i percorsi dei file di compilazione. La casella di controllo per aggiornare le informazioni di IntelliSense usando gli strumenti dell'Unreal Editor è selezionata.

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 origine o come modulo di un Plugin all'interno della cartella Plugin.
Il percorso compilazione mostra dove viene creato il file di Build.cs. Il file Build.cs contiene informazioni di configurazione per il modulo.

Creare un singolo modulo unreal Engine

Dopo aver aggiunto il modulo, compilarlo per renderlo disponibile nell'editor del motore Unreal. Anziché compilare l'intero progetto, è possibile compilare solo il modulo.

In Esplora Soluzioni, fare clic con il pulsante destro del mouse sulla cartella del modulo e selezionare Genera. Questo compila il plug-in e lo rende disponibile nell'editor del motore Unreal.

Le opzioni di menu dopo aver fatto clic con il pulsante destro del mouse sulla cartella del modulo MyModule sono visibili. L'opzione Build this Unreal Engine module è evidenziata.

L'output di compilazione viene visualizzato nella finestra Output. Se la compilazione ha esito positivo, il modulo è disponibile nell'editor del motore Unreal. Se la compilazione non riesce, nella finestra output vengono visualizzati i messaggi di errore.

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: Visual Studio Tools for Unreal Engine per scaricare e compilare il gioco Lyra. I passaggi presuppongono che la soluzione LyraStarterGame.sln sia aperta in Visual Studio:

1. In Esplora soluzioni, seleziona una cartella in cui vuoi inserire la nuova classe. Nel progetto LyraStarterGame è possibile aggiungere una nuova classe alla cartella LyraStarterGame>Source, ad esempio.
2. Fare clic con il pulsante destro del mouse sulla cartella e selezionare Aggiungi>elemento Unreal Engine... per aprire la finestra di dialogo Aggiungi nuovo elemento :

   

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

3. Selezionare Classi comuni del Motore Unreal e quindi selezionare 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. Selezionare un nome di classe . Visual Studio avvisa se il nome è in conflitto con una classe o un file esistente.
5. Selezionare 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. Selezionare un modulo da aggiungere alla classe usando il Selezionare un modulo per aggiungere la classe elenco a discesa. Il nome del modulo è il nome della cartella che contiene il modulo.
7. Selezionare la casella di controllo Aggiorna informazioni di IntelliSense utilizzando gli strumenti di Unreal Editor per scegliere se Visual Studio deve utilizzare gli strumenti di Unreal Editor 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. Selezionare OK per generare i file di intestazione e di origine per la nuova classe e aggiungerli al file della soluzione di Visual Studio. Selezionare Ricarica nel prompt visualizzato 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: Visual Studio Tools for Unreal Engine per scaricare e compilare il gioco Lyra. I passaggi presuppongono che la soluzione LyraStarterGame.sln sia aperta in Visual Studio:

1. In Esplora soluzioni, scegli una cartella in cui desideri posizionare il nuovo plugin. Nel progetto LyraStarterGame, è possibile aggiungere un nuovo plugin alla cartella Sourcedi LyraStarterGame>.
2. Fare clic con il pulsante destro del mouse sulla cartella e selezionare Aggiungi>elemento Unreal Engine... per aprire la finestra di dialogo Aggiungi nuovo elemento :

   

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

3. Selezionare Plugin di Unreal Engine e quindi selezionare Aggiungi per aprire la finestra di dialogo "Aggiungi plugin di Unreal Engine".

   

   È 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. C'è una casella di controllo "Plugin in beta" (deselezionata) e una casella di controllo per "Aggiornare le informazioni di IntelliSense utilizzando gli strumenti di Unreal Editor" (selezionata).

4. Seleziona 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-ine l'URL del plug-in .
6. Seleziona la casella "Plugin in beta" in base alle esigenze.
7. Selezionare la casella di controllo Aggiorna informazioni di IntelliSense utilizzando 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. Selezionare Aggiungi per creare 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 Ricaricare per ricaricare il progetto.

Creare un singolo plug-in Unreal Engine

Dopo aver aggiunto il plug-in, compilarlo per renderlo disponibile nell'editor del motore Unreal. Invece di compilare l'intero progetto, è possibile compilare solo il plug-in.

In Esplora Soluzioni, fare clic con il pulsante destro del mouse sulla cartella del plugin e scegliere Compilare il plugin di Unreal Engine. Questo compila il plug-in e lo rende disponibile nell'editor del motore Unreal.

Le opzioni di menu dopo aver fatto clic con il pulsante destro del mouse sulla cartella del plug-in MyPlugin sono visibili. La voce Crea questo plugin per Unreal Engine è evidenziata.

Se la compilazione ha esito positivo, il plug-in è disponibile nell'editor del motore Unreal. Se la compilazione non riesce, nella finestra output vengono visualizzati i messaggi di errore.

Contenuto correlato

Visual Studio Tools for Unreal Engine
Visualizzare Blueprints di Unreal Engine in Visual Studio
Visualizzare il log di Unreal Engine in Visual Studio
Visualizzare le macro di Unreal Engine in Visual Studio