Hinzufügen von Unreal Engine-Klassen, -Modulen und -Plug-Ins in Visual Studio
In diesem Artikel erfahren Sie, wie Sie Visual Studio-Tools für Unreal Engine für folgende Aktionen verwenden:
- 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
Die folgenden Komponenten müssen installiert sein:
- Visual Studio Version 17.11 (17.11 Vorschau ok) oder höhere Versionen.
- Unreal Engine Version 5 oder höher.
- Visual Studio-Tools für Unreal Engine. Installationsanweisungen finden Sie unter Installieren von Visual Studio-Tools für Unreal Engine.
- Arbeiten Sie den Schnellstart: Visual Studio-Tools für Unreal Engine durch, um das Lyra-Spiel herunterzuladen, zu erstellen und für die Verwendung von 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 in Visual Studio jetzt Unreal Engine-Module hinzufügen. Sie müssen nicht mehr zwischen dem Unreal Engine-Editor und Visual Studio wechseln, um ein Modul hinzuzufügen, und Sie müssen auch nicht mehr die Visual Studio-Projektmappe anschließend mit Ihrer Unreal Engine-Projektdatei synchronisieren.
Module ermöglichen es Ihnen, Ihren Code in 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 manuelle Erstellen von Modulen kann mühsam und fehleranfällig sein, da es das Bearbeiten von Konfigurationsdateien und das Hinzufügen von Codebausteinen erfordert. Visual Studio erleichtert das Erstellen von Modulen durch ein Dialogfenster, das Sie durch den Prozess führt und für Sie die Konfiguration durchführt und die Bausteine hinzufügt.
Nachdem Sie den Schnellstart: Visual Studio-Tools für Unreal Engine zum Herunterladen und Erstellen des Lyra-Spiels abgeschlossen haben, können Sie anhand der folgenden Schritte ein Unreal Engine-Modul in Visual Studio hinzufügen. Bei diesen Schritten wird davon ausgegangen, dass die LyraStarterGame.sln
-Projektmappe in Visual Studio geöffnet ist:
- Wählen Sie im Projektmappen-Explorer ein Projekt wie LyraStarterGame aus, dem das neue Modul hinzugefügt werden soll.
- Klicken Sie mit der rechten Maustaste auf das Projekt (stellen Sie sicher, dass ein Projekt und kein Ordner ausgewählt ist), und wählen Sie Hinzufügen>Unreal Engine-Element... aus, um das Dialogfenster Neues Element hinzufügen für die folgenden Unreal Engine-Elemente zu öffnen:
- Wählen Sie Unreal Engine-Modul aus, geben Sie im Feld Name einen Modulnamen an, und wählen Sie anschließend Hinzufügen, um das Dialogfenster Unreal Engine-Modul hinzufügen zu öffnen:
Das Dialogfenster „Unreal Engine-Modul hinzufügen" enthält ein Feld für den Modulnamen sowie Dropdownlisten für den Modultyp („Laufzeit“ ist ausgewählt) und die Modulladephase („Standard“ ist ausgewählt). Der Modulpfad, der Header, die Quelle und die Builddateipfade werden aufgelistet. Das Kontrollkästchen für „IntelliSense-Informationen mit Unreal Editor-Tools aktualisieren“ ist aktiviert.
- Verwenden Sie die Dropdownlisten, um den Modultyp und die Modulladephase auszuwählen.
- 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 Quelle oder als Modul eines Plug-Ins im Ordner Plug-Ins erstellt werden.
Der Build-Pfad zeigt an, wo die Build.cs
-Datei erstellt wird. Die Build.cs
-Datei enthält die Konfigurationsinformationen für das Modul.
Hinzufügen von Unreal Engine-Klassen in Visual Studio
Sie können ihrem Unreal Engine-Projekt in Visual Studio jetzt Unreal Engine-Klassen hinzufügen. Sie müssen nicht mehr zwischen dem Unreal Engine-Editor und Visual Studio wechseln, um eine Klasse hinzuzufügen, und Sie müssen auch nicht mehr die Visual Studio-Projektmappe anschließend mit Ihrer Unreal Engine-Projektdatei synchronisieren.
Nachdem Sie den Schnellstart: Visual Studio-Tools für Unreal Engine zum Herunterladen und Erstellen des Lyra-Spiels abgeschlossen haben, können Sie anhand der folgenden Schritte eine Unreal Engine-Klasse in Visual Studio hinzufügen. Bei diesen Schritten wird davon ausgegangen, dass die LyraStarterGame.sln
-Projektmappe in Visual Studio geöffnet ist:
- Wählen Sie im Projektmappen-Explorer einen Ordner aus, in dem die neue Klasse abgelegt werden soll. Im LyraStarterGame-Projekt könnten Sie dem LyraStarterGame>-Quellordner beispielsweise eine neue Klasse hinzufügen.
- Klicken Sie mit der rechten Maustaste auf den Ordner und wählen Sie Hinzufügen>Unreal Engine-Element... aus, um das Dialogfenster Neues Element hinzufügen zu öffnen:
Es verfügt über Optionen zum Hinzufügen von allgemeinen Unreal Engine-Klassen (ausgewählt), leeren Unreal Engine-Modulen und Unreal Engine-Plug-Ins.
- Wählen Sie Allgemeine Unreal Engine Common-Klassen und dann Hinzufügen aus, um das Dialogfenster Unreal Engine-Klasse hinzufügen zu öffnen:
Optionen zum Auswählen einer Basis wie Akteur, Figur 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.
- Wählen Sie einen Klassennamen aus. Visual Studio warnt Sie, wenn der Name mit einer vorhandenen Klasse oder Datei in Konflikt steht.
- Wählen Sie eine Basisklasse aus. Durch die Auswahl einer Basisklasse wird sichergestellt, dass die richtigen Header und Makros für diesen Klassentyp enthalten sind.
- Wählen Sie über die Dropdownliste Modul zum Hinzufügen der Klasse auswählen ein Modul aus, dem Ihre Klasse hinzugefügt werden soll. Der Modulname ist der Name des Ordners, der das Modul enthält.
- Aktivieren Sie das Kontrollkästchen IntelliSense-Informationen mit Unreal Editor-Tools aktualisieren, um festzulegen, dass Visual Studio zum Aktualisieren der IntelliSense-Informationen Unreal Editor-Tools verwendet. Wählen Sie diese Option aus, damit das Unreal Build-Tool die Visual Studio-Projektmappendatei neu erstellt.
- 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 der Aufforderung, das Projekt neu zu laden. Wählen Sie Neu laden aus, um das Projekt neu zu laden.
Hinzufügen von Unreal Engine-Plug-Ins in Visual Studio
Sie können ihrem Unreal Engine-Projekt in Visual Studio jetzt Unreal Engine-Plug-Ins hinzufügen. Sie müssen nicht mehr zwischen dem Unreal Engine-Editor und Visual Studio wechseln, um ein Plug-In hinzuzufügen, und Sie müssen auch nicht mehr die Visual Studio-Projektmappe anschließend mit Ihrer Unreal Engine-Projektdatei synchronisieren.
Nachdem Sie den Schnellstart: Visual Studio-Tools für Unreal Engine zum Herunterladen und Erstellen des Lyra-Spiels abgeschlossen haben, können Sie anhand der folgenden Schritte ein Unreal Engine-Plug-In in Visual Studio hinzufügen. Bei diesen Schritten wird davon ausgegangen, dass die LyraStarterGame.sln
-Projektmappe in Visual Studio geöffnet ist:
- Wählen Sie im Projektmappen-Explorer einen Ordner aus, in dem das neue Plug-In abgelegt werden soll. Im LyraStarterGame-Projekt könnten Sie dem LyraStarterGame>-Quellordner beispielsweise ein neues Plug-In hinzufügen.
- Klicken Sie mit der rechten Maustaste auf den Ordner und wählen Sie Hinzufügen>Unreal Engine-Element... aus, um das Dialogfenster Neues Element hinzufügen zu öffnen:
Es verfügt über Optionen zum Hinzufügen von allgemeinen Unreal Engine-Klassen, leeren Unreal Engine-Modulen und Unreal Engine-Plug-Ins (ausgewählt).
- Wählen Sie Unreal Engine-Plug-Ins und dann Hinzufügen aus, um das Dialogfenster Unreal Engine-Plug-In hinzuzufügen:
Es gibt eine Liste von Plug-In-Typen („Erweitert“ ist ausgewählt) und Felder für den Namen, Pfad, Autor, die Beschreibung und URL des Plug-Ins. Es gibt das Kontrollkästchen „Ist Plug-In in Beta“ (deaktiviert) und das Kontrollkästchen „IntelliSense-Informationen mit Unreal Editor-Tools aktualisieren“ (aktiviert).
- Wählen Sie den Typ Ihres Plug-Ins aus der Plugin-Typ-Liste aus.
- Geben Sie den Plug-In-Namen, den Plug-In-Autor, die Plug-In-Beschreibung und die Plug-In-URL an.
- Aktivieren Sie bei Bedarf das Kontrollkästchen Ist Plug-In in Beta.
- Aktivieren Sie das Kontrollkästchen IntelliSense-Informationen mit Unreal Editor-Tools aktualisieren, um festzulegen, dass Visual Studio zum Aktualisieren der IntelliSense-Informationen die Unreal Editor-Tools verwendet. Dadurch erstellt das Unreal Build-Tool die Visual Studio-Projektmappendatei neu.
- Wählen Sie Hinzufügen aus, um die Plug-In-Header- und Quelldateien für das neue Plug-In zu erstellen und sie der Visual Studio-Projektmappendatei hinzuzufügen. Dies führt zu der Aufforderung, das Projekt neu zu laden. Wählen Sie Neu laden aus, um das Projekt neu zu laden.
Zugehöriger Inhalt
Visual Studio-Tools für Unreal Engine
Anzeigen von Unreal Engine-Blaupausen in Visual Studio
Anzeigen der Unreal Engine-Protokollierung in Visual Studio
Anzeigen von Unreal Engine-Makros in Visual Studio