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

  • Artikel

In diesem Artikel erfahren Sie, wie Sie Visual Studio-Tools für Unreal Engine für folgende Aktionen verwenden:

Voraussetzungen

Die folgenden Komponenten müssen installiert sein:

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:

  1. Wählen Sie im Projektmappen-Explorer ein Projekt wie LyraStarterGame aus, dem das neue Modul hinzugefügt werden soll.
  2. 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: Screenshot des Menüs „Neues Element hinzufügen“. Leeres Unreal Engine-Modul ist ausgewählt.
  3. 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:

    Screenshot des Dialogfensters „Unreal Engine-Modul hinzufügen“.

  4. Verwenden Sie die Dropdownlisten, um den Modultyp und die Modulladephase auszuwä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 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:

  1. 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.
  2. 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:

    Ein Screenshot des Dialogfelds „Neues Element hinzufügen“ mit ausgewählter Option „Allgemeine Unreal Engine-Klassen“.

  3. Wählen Sie Allgemeine Unreal Engine Common-Klassen und dann Hinzufügen aus, um das Dialogfenster Unreal Engine-Klasse hinzufügen zu öffnen:

    Screenshot des Dialogfensters „Neue Unreal Engine-Klasse hinzufügen“.

  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 Basisklasse aus. Durch die Auswahl einer Basisklasse wird sichergestellt, dass die richtigen Header und Makros für diesen Klassentyp enthalten sind.
  6. 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.
  7. 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.
  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 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:

  1. 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.
  2. 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:

    Ein Screenshot des Dialogfelds „Neues Element hinzufügen“ mit ausgewählter Option „Unreal Engine-Plug-Ins“.

  3. Wählen Sie Unreal Engine-Plug-Ins und dann Hinzufügen aus, um das Dialogfenster Unreal Engine-Plug-In hinzuzufügen:

    Screenshot des Dialogfensters „Neues Unreal Engine-Plug-In hinzufügen“.

  4. Wählen Sie den Typ Ihres Plug-Ins aus der Plugin-Typ-Liste aus.
  5. Geben Sie den Plug-In-Namen, den Plug-In-Autor, die Plug-In-Beschreibung und die Plug-In-URL an.
  6. Aktivieren Sie bei Bedarf das Kontrollkästchen Ist Plug-In in Beta.
  7. 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.
  8. 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