Upgrade auf Unreal Engine 4.27#

Diese Anweisungen gelten, wenn Sie AirSim bereits unter Unreal Engine 4.25 verwenden. Wenn Sie AirSim noch nie installiert haben, lesen Sie bitte How to get it.

Vorsicht: Die folgenden Schritte löschen alle Ihre ungespeicherten Arbeiten im AirSim- oder Unreal-Ordner.

Das zuerst tun#

Für Windows-Benutzer#

  1. Installieren Sie Visual Studio 2022 mit VC++, Python und C#.
  2. Installieren Sie UE 4.27 über den Epic Games Launcher.
  3. Starten Sie die x64 Native Tools Command Prompt for VS 2022 und navigieren Sie zum AirSim-Repository.
  4. Führen Sie clean_rebuild.bat aus, um alle nicht versionierten/zusätzlichen Elemente zu entfernen und alles neu zu erstellen.
  5. Siehe auch Build AirSim on Windows für weitere Informationen.

Für Linux-Benutzer#

  1. Führen Sie aus Ihrem AirSim-Repository-Ordner 'clean_rebuild.sh` aus.
  2. Benennen Sie Ihren vorhandenen Ordner für Unreal Engine um oder löschen Sie ihn.
  3. Folgen Sie Schritt 1 und 2, um Unreal Engine 4.27 zu installieren.
  4. Siehe auch Build AirSim on Linux für weitere Informationen.

Aktualisieren Ihres benutzerdefinierten Unreal-Projekts#

Wenn Sie Ihr eigenes Unreal-Projekt haben, das in einer älteren Version von Unreal Engine erstellt wurde, müssen Sie Ihr Projekt auf Unreal 4.27 aktualisieren. Um dies zu tun:

  1. Öffnen Sie die .uproject-Datei und suchen Sie nach der Zeile "EngineAssociation" und stellen Sie sicher, dass sie wie folgt lautet: "EngineAssociation": "4.27".
  2. Löschen Sie den Ordner Plugins/AirSim im Ordner Ihres Unreal-Projekts.
  3. Gehen Sie zu Ihrem AirSim-Repository-Ordner und kopieren Sie den Ordner Unreal\Plugins in den Ordner Ihres Unreal-Projekts.
  4. Kopieren Sie *.bat (oder *.sh für Linux) aus Unreal\Environments\Blocks in Ihren Projektordner.
  5. Führen Sie clean.bat (oder clean.sh für Linux) gefolgt von GenerateProjectFiles.bat (nur für Windows) aus.

FAQ#

Ich habe ein Unreal-Projekt, das älter als 4.16 ist. Wie aktualisiere ich es?#

Option 1: Projekt einfach neu erstellen#

Wenn Ihr Projekt außer der heruntergeladenen Umgebung keinen Code oder keine Assets enthält, können Sie das Projekt auch einfach im Unreal 4.27 Editor neu erstellen und dann den Plugins-Ordner von AirSim/Unreal/Plugins kopieren.

Option 2: Wenige Dateien ändern#

Unreal-Versionen neuer als Unreal 4.15 haben Breaking Changes. Daher müssen Sie Ihre *.Build.cs und *.Target.cs ändern, die Sie im Source-Ordner Ihres Unreal-Projekts finden. Was sind also die Änderungen? Unten ist die Zusammenfassung, aber Sie sollten sich wirklich auf Unreals offiziellen 4.16 Transition Post beziehen.

In den *.Target.cs Ihres Projekts#

  1. Ändern Sie den Konstruktor von public MyProjectTarget(TargetInfo Target) zu public MyProjectTarget(TargetInfo Target) : base(Target)

  2. Entfernen Sie die Methode SetupBinaries, falls vorhanden, und fügen Sie stattdessen die folgende Zeile im Konstruktor oben hinzu: ExtraModuleNames.AddRange(new string[] { "MyProject" });

In den *.Build.cs Ihres Projekts#

Ändern Sie den Konstruktor von public MyProject(TargetInfo Target) zu public MyProject(ReadOnlyTargetRules Target) : base(Target).

Und schließlich...#

Befolgen Sie die obigen Schritte, um mit dem Upgrade fortzufahren. Das Warnfeld zeigt möglicherweise nur die Schaltfläche "Kopie öffnen". Klicken Sie nicht darauf. Klicken Sie stattdessen auf "Weitere Optionen", um weitere Schaltflächen anzuzeigen. Wählen Sie die Option Konvertieren an Ort und Stelle. Vorsicht: Machen Sie immer zuerst ein Backup Ihres Projekts! Wenn Sie nichts Schlimmes haben, sollte die In-Place-Konvertierung erfolgreich sein und Sie sind jetzt auf der neuen Version von Unreal.