Hinzufügen von Unreal Engine-Klassen, Modulen und Plug-Ins in Visual Studio

In diesem Artikel erfahren Sie, wie Sie Visual Studio Tools for Unreal Engine verwenden, um:

• Hinzufügen von Unreal Engine-Modulen in Visual Studio
• Hinzufügen von Unreal Engine-Klassen in Visual Studio
• Hinzufügen von Unreal Engine-Plug-Ins in Visual Studio

Voraussetzungen

Folgendes muss installiert sein:

• Visual Studio Version 17.11 (17.11 Vorschauversionen ok) oder höher.
• Unreal Engine Version 5 oder höher.
• Visual Studio Tools for Unreal Engine. Installationsanweisungen finden Sie unter Installieren von Visual Studio Tools for Unreal Engine.
• Schließen Sie den Schnellstart: Visual Studio-Tools für Unreal Engine ab, um das Spiel Lyra herunterzuladen, zu erstellen und für die Verwendung der Visual Studio-Tools für Unreal Engine zu konfigurieren.

Hinzufügen von Unreal Engine-Modulen in Visual Studio

Sie können ihrem Unreal Engine-Projekt Module für Unreal Engine nun aus Visual Studio hinzufügen. Sie müssen nicht mehr zwischen dem Unreal Engine Editor und Visual Studio wechseln, um ein Modul hinzuzufügen, oder sie müssen die Visual Studio-Projektmappe anschließend mit Ihrer Unreal Engine-Projektdatei synchronisieren.

Module sind eine Möglichkeit, Ihren Code in der Unreal Engine zu organisieren. Sie helfen Ihnen, verwandte Klassen und Ressourcen zusammen zu gruppieren und Ihren Code in eigenständige Einheiten zu organisieren, die zur Laufzeit geladen und entladen werden können. Das Erstellen von Modulen kann mühsam und fehleranfällig sein, wenn Sie dies manuell tun, da das Bearbeiten von Konfigurationsdateien und das Hinzufügen von Codebausteinen erforderlich ist. Visual Studio erleichtert das Erstellen von Modulen, indem ein Dialogfeld bereitgestellt wird, das Sie durch den Prozess führt und die Konfiguration durchführt und die Bausteine für Sie hinzufügt.

Wenn Sie ein Unreal Engine-Modul in Visual Studio hinzufügen möchten, führen Sie die folgenden Schritte aus, nachdem Sie Schnellstart ausgeführt haben: Visual Studio Tools for Unreal Engine, um das Lyra-Spiel herunterzuladen und zu erstellen. Bei diesen Schritten wird davon ausgegangen, dass die LyraStarterGame.sln Lösung in Visual Studio geöffnet ist.

1. Wählen Sie im Projektmappen-Explorerein Projekt aus, z. B. LyraStarterGame, wo das neue Modul hin soll.
2. Klicken Sie mit der rechten Maustaste auf das Projekt (stellen Sie sicher, dass ein Projekt ausgewählt und kein Ordner ist), und wählen Sie >Element "Unreal Engine hinzufügen" aus..., um das Dialogfeld Neues Element für Elemente des Unreal Engine-Elements zu öffnen:
3. Wählen Sie Unreal Engine Moduleaus, geben Sie im Feld Name einen Modulnamen ein, und wählen Sie dann Hinzufügen aus, um das Dialogfeld "Unreal Engine Module hinzufügen" zu öffnen:

   

   Das Dialogfeld "Unreal Engine Module hinzufügen" enthält ein Feld für den Modulnamen, Dropdowns für den Modultyp (Laufzeit ist ausgewählt) und die Modulladephase (Standard ist ausgewählt). Der Modulpfad, die Kopfzeile, die Quelle und die Builddateipfade werden aufgelistet. Das Kontrollkästchen für "IntelliSense-Informationen aktualisieren" mithilfe von Unreal Editor-Tools ist aktiviert.

4. Verwenden Sie die Dropdowns, um den Modultyp und Modulladephaseauszuwählen.
5. Wählen Sie OK aus, um das Modul zum Projekt hinzuzufügen und die Visual Studio-Projektmappendatei zu aktualisieren.

Module können nur im Ordner Source oder als Modul eines Plug-Ins im Ordner Plugins erstellt werden.
Der Build- Pfad zeigt an, wo die Build.cs Datei erstellt wird. Die Build.cs Datei enthält Konfigurationsinformationen für das Modul.

Hinzufügen von Unreal Engine-Klassen in Visual Studio

Jetzt können Sie Ihrem Unreal Engine-Projekt in Visual Studio Unreal Engine Klassen hinzufügen. Sie müssen nicht mehr zwischen dem Unreal-Editor und Visual Studio wechseln, um eine Klasse hinzuzufügen, oder sie müssen die Visual Studio-Projektmappe anschließend mit Ihrer Unreal Engine-Projektdatei synchronisieren.

Um eine Unreal Engine-Klasse in Visual Studio hinzuzufügen, führen Sie die folgenden Schritte aus, nachdem Sie Schnellstart ausgeführt haben: Visual Studio Tools for Unreal Engine, um das Lyra-Spiel herunterzuladen und zu erstellen. Die Schritte gehen davon aus, dass die LyraStarterGame.sln Lösung in Visual Studio geöffnet ist:

1. Wählen Sie im Projektmappen-Explorereinen Ordner aus, in dem die neue Klasse abgelegt werden soll. Im LyraStarterGame-Projekt könnten Sie dem Ordner LyraStarterGame>Source beispielsweise eine neue Klasse hinzufügen.
2. Klicken Sie mit der rechten Maustaste auf den Ordner und wählen Sie >'Unreal Engine-Element hinzufügen' aus, um das Dialogfeld 'Neues Element hinzufügen' zu öffnen.

   

   Es gibt Optionen zum Hinzufügen von allgemeinen Unreal Engine-Klassen (ausgewählt), einem leeren Unreal Engine-Modul und Unreal Engine-Plugins.

3. Wählen Sie Allgemeine Klassen des Unreal Engine aus, und wählen Sie dann Hinzufügen aus, um das Dialogfeld "Unreal Engine Class hinzufügen" zu öffnen:

   

   Optionen zum Auswählen einer Basis wie Actor, Character usw. sind sichtbar. Es gibt ein Feld für den Klassennamen und eine Dropdownliste für das Modul, dem die Klasse hinzugefügt werden soll. Die Pfade zur Headerdatei und Quelldatei werden aufgelistet. Ein Kontrollkästchen ist aktiviert, um IntelliSense-Informationen mithilfe von Unreal Editor-Tools zu aktualisieren.

4. Wählen Sie einen Klassennamen aus. Visual Studio warnt Sie, wenn der Name mit einer vorhandenen Klasse oder Datei in Konflikt steht.
5. Wählen Sie eine Basisklasseaus. Wenn Sie eine Basisklasse auswählen, wird sichergestellt, dass die richtigen Header und Makros für diesen Klassentyp enthalten sind.
6. Wählen Sie mithilfe der Dropdownliste Select a module to add the class ein Modul aus, das Ihrer Klasse hinzugefügt werden soll. Der Modulname ist der Name des Ordners, der das Modul enthält.
7. Wählen Sie das Kontrollkästchen "Unreal Editor-Tools verwenden, um IntelliSense-Informationen zu aktualisieren" aus, um festzulegen, ob Visual Studio die Unreal Editor-Tools zum Aktualisieren der IntelliSense-Informationen verwendet. Wählen Sie diese Option aus, damit das Unreal Build Tool die Visual Studio-Projektmappendatei neu generiert.
8. Wählen Sie OK aus, um die Header- und Quelldateien für die neue Klasse zu generieren und sie der Visual Studio-Projektmappendatei hinzuzufügen. Dies führt zu einer Aufforderung zum Erneutladen des Projekts. Wählen Sie laden Sie neu, um das Projekt neu zu laden.

Hinzufügen von Unreal Engine-Plug-Ins in Visual Studio

Jetzt können Sie Ihrem Unreal Engine-Projekt in Visual Studio Unreal Engine Plug-Ins hinzufügen. Sie müssen nicht mehr zwischen dem Unreal Editor und Visual Studio wechseln, um ein Plug-In hinzuzufügen, oder sie müssen die Visual Studio-Projektmappe anschließend mit Ihrer Unreal Engine-Projektdatei synchronisieren.

Um ein Unreal Engine-Plug-In in Visual Studio hinzuzufügen, führen Sie die folgenden Schritte aus, nachdem Sie Schnellstart abgeschlossen haben: Visual Studio Tools for Unreal Engine, um das Lyra-Spiel herunterzuladen und zu erstellen. Bei den Schritten wird davon ausgegangen, dass die LyraStarterGame.sln Lösung in Visual Studio geöffnet ist.

1. Wählen Sie im Projektmappen-Explorereinen Ordner aus, in dem das neue Plug-In abgelegt werden soll. Im LyraStarterGame-Projekt könnten Sie dem Ordner LyraStarterGame>Source beispielsweise ein neues Plug-In hinzufügen.
2. Klicken Sie mit der rechten Maustaste auf den Ordner und wählen Sie Unreal Engine-Element hinzufügen>, um das Dialogfeld Neues Element hinzufügen zu öffnen.

   

   Optionen zum Hinzufügen einer allgemeinen Unreal Engine-Klassen und eines leeren Unreal Engine-Moduls sowie die ausgewählte Option zum Hinzufügen von Unreal Engine-Plug-Ins sind verfügbar.

3. Wählen Sie Unreal Engine Plugins aus, und wählen Sie dann Add aus, um das Dialogfeld Add Unreal Engine Plugin zu öffnen:

   

   Es gibt eine Liste der Plug-In-Typen (Erweitert ist ausgewählt), und Felder für den Plug-In-Namen, Pfad, Autor, Beschreibung und URL. Es gibt ein Kontrollkästchen für „Is plugin in beta“ (deaktiviert) und ein Kontrollkästchen für „Refresh IntelliSense information using Unreal Editor Tools“ (aktiviert).

4. Wählen Sie den Typ Ihres Plug-Ins aus der Plugin-Typ Liste aus.
5. Geben Sie den Plugin-Namen, Plugin Author, Plugin Descriptionund Plugin URL.
6. Aktivieren Sie nach Bedarf das Kontrollkästchen Is plugin in beta.
7. Wählen Sie das Kontrollkästchen "IntelliSense-Informationen mithilfe von Unreal Editor-Tools aktualisieren" aus, um festzulegen, ob Visual Studio die Unreal Editor-Tools zur Aktualisierung der IntelliSense-Informationen verwenden soll. Dies bewirkt, dass das Unreal Build Tool die Visual Studio-Projektmappendatei neu generiert.
8. Wählen Sie Add aus, um die Plug-In-Header- und Quelldateien für das neue Plug-In zu generieren und sie der Visual Studio-Projektmappendatei hinzuzufügen. Dies führt zu einer Aufforderung zum Erneutladen des Projekts. Wählen Sie laden Sie neu, um das Projekt neu zu laden.

Verwandte Inhalte

Visual Studio-Tools für Unreal Engine
Unreal Engine Blueprints in Visual Studio anzeigen
Anzeigen der Unreal Engine-Logdateien in Visual Studio
Anzeigen von Unreal Engine-Makros in Visual Studio