Freigeben über


Schnellstart: Visual Studio-Tools für Unreal Engine

Laden Sie in diesem Artikel ein Unreal Engine (UE)-Spielbeispiel herunter, und konfigurieren Sie Visual Studio-Tools für Unreal Engine. Visual Studio-Tools für Unreal Engine ist eine kostenlose Erweiterung, mit der Sie Spiele mit Unreal Engine entwickeln können. Es bietet Features, die die Unreal Engine-Entwicklungsumgebung in Visual Studio verbessern.

Voraussetzungen

Die folgenden Komponenten müssen installiert sein:

  • Visual Studio Version 17.10 oder höher.
  • Unreal Engine Version 5 oder höher, da für das in diesem Artikel verwendete Beispiel Unreal Engine 5 oder höher erforderlich ist.
  • Visual Studio-Tools für Unreal Engine. Installationsanweisungen finden Sie unter Installieren von Visual Studio-Tools für Unreal Engine.

Herunterladen und Erstellen des Lyra-Spielbeispiels in Visual Studio

Lyra ist ein Beispielspielprojekt, um mehr über Unreal Engine zu erfahren. Anweisungen zum Download finden Sie im Abschnitt Downloading the Lyra Starter Game unter Lyra Sample Game. Wenn Sie es über die Quellcodeinstallation von Unreal Engine erworben haben, enthält diese Version nicht die zum Erstellen und Ausführen des Spiels erforderlichen Ressourcen. Verwenden Sie die Downloadanweisungen, um alles zu erhalten, was Sie über das Epic-Installationsprogramm benötigen.

Konfigurieren des Lyra-Spielbeispiels für die Verwendung von Visual Studio-Tools für Unreal Engine

Ab Visual Studio 2022 Version 17.7 ist das Plug-In Visual Studio-Tools für Unreal Engine in der Unreal Engine-Installation enthalten. Es ist nicht mehr erforderlich, Unreal Engine-Blaupausen anzuzeigen. Wenn Sie über eine frühere Version von Visual Studio verfügen, finden Sie unter Installieren der Visual Studio-Tools für Unreal Engine Informationen zum manuellen Installieren des Plug-Ins.

Nachdem Sie das Spielbeispiel heruntergeladen haben, aktualisieren Sie LyraStarterGame.uproject, um das Visual Studio-Tools-Plug-In zu verwenden. Eine Möglichkeit hierzu ist der Unreal Editor. Laden Sie das Lyra-Projekt, und wählen Sie im Hauptmenü Plug-Ins> bearbeiten aus. Suchen Sie das Visual Studio Integration Tools-Plug-In, und aktivieren Sie das Kontrollkästchen daneben.

Eine weitere Möglichkeit hierzu besteht darin, die LyraStarterGame.uproject Datei manuell zu bearbeiten. Gehen Sie dazu wie folgt vor:

  1. Öffne die LyraStarterGame.uproject-Datei in einem Text-Editor. Sie befindet sich in dem Verzeichnis, in dem Sie das Spielbeispiel installiert haben.

  2. Fügen Sie am Ende des Abschnitts Plugins den folgenden Code hinzu:

    ,{
        "Name": "VisualStudioTools",
        "Enabled": true
    }
    

In Unreal Engine

  1. Öffnen Sie das Lyra-Projekt in Unreal Engine.
  2. Wählen Sie im Hauptmenü des Unreal Engine-Editors Tools>Visual Studio-Projekt erstellen aus. Dadurch wird die Projektmappendatei für Visual Studio erstellt.
  3. Wählen Sie im Hauptmenü des Unreal Engine-Editors Tools>Visual Studio öffnen aus, um das Spiel in Visual Studio zu öffnen. Wenn Sie über mehrere Versionen von Visual Studio auf Ihrem Computer verfügen, stellen Sie sicher, dass die richtige Version geöffnet ist: Wählen Sie im Hauptmenü von Visual Studio Hilfe>Info zu Microsoft Visual Studio aus. Sie müssen Visual Studio 2022 Version 17.7 oder höher verwenden. Wenn nicht die richtige Version geöffnet wurde, öffnen Sie LyraStarterGame.sln manuell in der richtigen Version von Visual Studio.

In Visual Studio

  1. Wählen Sie in der Dropdownliste Solutions Configurations (Projektmappenkonfigurationen) den Eintrag Development Editor (Entwicklungs-Editor) aus. Damit wird Visual Studio-Tools für Unreal Engine für Blaupausen aktiviert: Screenshot von Visual Studio mit erweiterter Dropdownliste „Lösungskonfigurationen“ und ausgewähltem „Entwicklungseditor“.
  2. Legen Sie das Startprojekt als LyraStarterGame-Projekt fest. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Lösung, und wählen Sie dann Eigenschaften aus.
  3. Wählen Sie im Dialogfeld Projektmappen-Eigenschaftenseiten unter Allgemeine Eigenschaften die Option Startprojekte konfigurieren aus.
  4. Stellen Sie sicher, dass das Einzelne Startprojekt ausgewählt ist, und wählen Sie in der Dropdownliste LyraStarterGame aus.

    Ein Screenshot der Eigenschaftenseiten der Projektmappe

    Unter „Allgemeine Eigenschaften” ist die Option „Startprojekte konfigurieren” ausgewählt. Das Optionsfeld des einzelnen Startprojekts ist ausgewählt. Das Startprojekt im Dropdown ist LyraStarterGame.

  5. Wählen Sie OK aus, um das Dialogfeld zu schließen.
  6. Wählen Sie im Hauptmenü von Visual Studio Erstellen>Projektmappe erstellen aus, um das Spiel zu erstellen.

Visual Studio Build-Ausgabefenster

Im Build-Ausgabefenster in Visual Studio sehen Sie den Fortschritt des Builds sowie alle aufgetretenen Fehler oder Warnungen. Sie können das Buildausgabefenster im Visual Studio-Hauptmenü über Anzeigen>Ausgabe öffnen.

Ab Visual Studio 2022 17.12 können Sie im Ausgabefenster auf einen absoluten Pfad zu einer Datei doppelklicken, um diese Datei in Visual Studio zu öffnen. Der Quellcode muss Teil der Visual Studio-Projektmappe sein, und der Pfad im Ausgabefenster muss ein absoluter Pfad sein. Dies funktioniert beim Erstellen von Unreal Engine-Projekten in Visual Studio oder beim Erstellen anderer Projekttypen.

Der folgende Screenshot zeigt die Ausgabefenster für einen Build des LyraStarterGame-Beispiels. Der Benutzer hat auf eine Warnung von LyraCharacter.generated.h doppelgeklickt. Da der absolute Pfad zu dieser Datei angegeben ist, öffnet sich die Datei im Editor.

Screenshot: Visual Studio-Ausgabefenster. Die Datei „LyraCharacter.generated.h“ ist hervorgehoben, da der absolute Pfad angegeben ist und der Benutzer darauf doppelt geklickt hat, um die Datei „LyrCharacter.generated.h“ zu öffnen.

Symbolleiste von Unreal Engine

Visual Studio bietet eine Symbolleiste, die die Unreal Engine-Entwicklungsintegration in Visual Studio verbessert. Die Symbolleiste bietet schnellen Zugriff auf allgemeine UE-Aufgaben.

Aktivieren Sie die Symbolleiste von Unreal Engine in Visual Studio über das Hauptmenü unter Anzeigen>Symbolleisten>Unreal Engine. Die Symbolleiste sieht wie folgt aus:

Screenshot der Symbolleiste von Unreal Engine in Visual Studio.

Die Schaltflächen in der Symbolleiste von links nach rechts:

  • Das Wiedergabesymbol ist eine Schaltfläche zum schnellen Anfügen an Prozesse, die in der Dropdownliste auf der rechten Seite aufgeführt sind. In der Dropdownliste sind Vorgänge im Zusammenhang mit Unreal Engine aufgeführt, was das Anfügen an den Unreal Engine-Editor vereinfacht. Sie können diese Schaltfläche zum Anfügen an beliebige Prozesse verwenden.
  • Schaltflächen zum Starten und Beenden des Unreal Engine-Integrationsservers. Der Integrationsserver verbessert die Leistung der Unreal Engine-Integration in Visual Studio. Er wird als Hintergrundprozess ausgeführt und aktualisiert während der Arbeit an Ihrem Projekt automatisch Testinformationen. Sie können ihn deaktivieren, um Computerressourcen freizugeben, und ihn starten, wenn Sie die Integrationsverbesserungen wünschen. Der Server wird automatisch gestartet, wenn Sie ein UE-Projekt in Visual Studio öffnen.
  • Eine Schaltfläche zum erneuten Scannen der Unreal Engine-Blaupausenressourcen. Dadurch wird die Visual Studio-Projektmappe mit den neuesten Blaupausenressourcen aus dem Unreal Engine-Projekt aktualisiert.
  • Diese Schaltfläche öffnet das Unreal Engine-Protokollfenster.
  • Diese Schaltfläche öffnet das Fenster Unreal Engine-Integrationskonfiguration, in dem Sie den allgemeinen Konfigurationsstatus und den Status des Visual Studio-Integrationstools aktualisieren und anzeigen können, nach Blaupausenunterstützung suchen können, den Status der Unreal Engine-Benennungskonventionsprüfung einsehen können usw.

Dropdownmenü für Befehlszeilenargumente

Möglicherweise starten Sie Ihr Spiel häufig mit verschiedenen Kombinationen von Befehlszeilenargumenten während des Bearbeitungs- und Debuggingteils ihrer inneren Schleife. Dies ist jetzt einfacher mit der Dropdownliste für Befehlszeilenargumente:

Screenshot der Dropdownliste für Befehlszeilenargumente.

Das Dropdownmenü für Befehlszeilenargumente wird auf der Standardsymbolleiste nach der Dropdownliste "Lösungenplattformen" angezeigt. Es gibt einen Eintrag für C:\UE\LyraStarterGame\LyraStarterGame.uproject -fullscreen, und C:\UE\LyraStarterGame\LyraStarterGame.uproject -JsonDebugOutput.

Um Befehlszeilenargumente hinzuzufügen, geben Sie sie in die Dropdownliste ein, und drücken Sie die EINGABETASTE. Die Argumente werden in der Reihenfolge gespeichert, in der Sie sie eingeben und in der Dropdownliste für die zukünftige Verwendung angezeigt werden.

Es gibt eine Beschränkung von fünf Befehlszeilen, die Sie hinzufügen können, bevor das älteste hinzugefügt wird, um Platz für ein neues zu schaffen.

Das erste Argument beim Debuggen eines Unreal Engine-Projekts, das im Unreal Engine-Editor ausgeführt wird, muss der Pfad zum Projekt sein. Beispiel: C:\UE\LyraStarterGame\LyraStarterGame.uproject

Weitere Informationen zur Verwendung der Dropdownliste für Befehlszeilenargumente finden Sie unter Übergeben von Befehlszeilenargumenten beim Debuggen (C++).

Nächste Schritte

Hinzufügen von Unreal Engine-Klassen, -Modulen und -Plug-Ins in Visual Studio
Anzeigen von Unreal Engine-Blaupausen in Visual Studio
Anzeigen der Unreal Engine-Protokollierung in Visual Studio
Anzeigen von Unreal Engine-Makros in Visual Studio