Schnellstartanleitung für die Linux-Entwicklung

Die Unreal Engine (UE) unterstützt die Entwicklung auf Linux-Geräten, indem entweder aus dem Quellcode erstellte Builds oder vorkompilierte, installierte Builds verwendet werden. Auf dieser Seite finden Sie Anweisungen zum Einrichten der Unreal Engine für Linux, einschließlich Ihrer Entwicklungsumgebung und Build-Pipeline. Nach Abschluss dieses Tutorials sind Sie bereit, auf Ihrem Linux-Rechner Anwendungen in der Unreal Engine zu entwickeln.

1. Empfohlene Software und Hardware

Die Unreal Engine ist mit einer Vielzahl von Linux-Distributionen und IDEs kompatibel, solange sie diese Mindestanforderungen erfüllen:

Wir empfehlen, dass Ihr System den folgenden Standard erfüllt, damit der Unreal Editor reibungslos funktioniert:

Um Ihre Entwicklungsumgebung einzurichten, empfehlen wir Ihnen die folgende Software, mit der wir am häufigsten Tests durchführen:

Weitere Informationen zur Einrichtung finden Sie in der Dokumentation Ihrer Linux-Distribution oder IDE. Die Einrichtung Ihres Betriebssystems und der Hardware liegt außerhalb des Rahmens dieser Dokumentation, allerdings wird im Folgenden die Einrichtung Ihrer IDE für die Arbeit mit der Unreal Engine behandelt.

2. Die Unreal Engine installieren

Sie können die Unreal Engine unter Linux einrichten, indem Sie entweder einen vorkompilierten Build installieren oder die Engine über die Quelle erstellen.

2a. Herunterladen eines installierten Build

Die einfachste Option, die Unreal Engine auszuführen, ist die Verwendung eines installierten Build. Befolgen Sie diese Schritte, um diesen herunterzuladen und zu installieren:

Unreal Engine für Linux unterstützt sowohl vorkompilierte Installationsbuilds als auch Quellcode-Builds. Informationen zur Installation aus Quellcode-Builds finden Sie unter Building Unreal Engine from Source (Neuerstellung von Unreal Engine aus dem Quellcode).

Befolgen Sie diese Schritte, um die Unreal Engine aus vorkompilierten Builds zu installieren:

1. Öffnen Sie die Seite Unreal Engine für Linux. Sie werden aufgefordert, ein Epic Games-Konto zu erstellen oder sich anzumelden. Falls Sie bereits ein Konto haben, melden Sie sich an, um auf die Seite zuzugreifen. Falls Sie noch kein Konto haben, klicken Sie auf Registrieren, um eins zu erstellen.

   

   Sie können ein Epic Games-Konto über Ihre E-Mail-Adresse oder über ein Konto in unterstützten sozialen Netzwerken oder Spieleplattformen erstellen.

   

2. Laden Sie die .zip- Datei mit der Version von Unreal Engine herunter, die Sie benötigen.

   

3. Entpacken Sie den Inhalt der .zip- Datei in dem gewünschten Installationsverzeichnis.

4. Führen Sie Engine/Binaries/Linux/UnrealEditor über den Terminal aus, um Unreal Engine zu starten.

2b. Erstellen der Unreal Engine aus der Quelle

Um die Unreal Engine von der Quelle zu installieren, lesen Sie unter Herunterladen des Unreal-Engine-Quellcodes nach. Sobald Sie die Engine kompiliert haben, führen Sie im Terminal Engine/Binaries/Linux/UnrealEditor aus, um den Unreal Editor zu starten.

3. Einrichtung eines neuen Projekts

Ziehen Sie die Anleitung unter Erstellen eines neuen Projekts in Unreal Engine zu Rate, um zu erfahren, wie Sie ein neues Projekt einrichten. Sie benötigen keine bestimmte Vorlage und keinen bestimmten Projekttyp für dieses Tutorial. Sie sollten aber sicherstellen, dass C++ aktiviert ist, wenn Sie Ihre Umgebung für C++ einrichten.

4. Einrichten Ihrer Entwicklungsumgebung (C++)

Wenn Sie C++-Projekte entwickeln möchten, müssen Sie die Clang-Werkzeugkette und eine IDE einrichten, um mit der Unreal Engine arbeiten zu können. Wir benötigen zwar keine spezifische IDE, empfehlen aber die Verwendung von Visual Studio Code oder Rider. Dieser Abschnitt enthält spezifische Anweisungen für Visual Studio Code, da es eine gängige Entwicklungsumgebung für andere Betriebssysteme darstellt.

1. Installieren Sie die benutzerdefinierte Clang-Werkzeugkette für Ihre Konfiguration. Weitere Informationen finden Sie unter Linux-Entwicklungsanforderungen.

2. Suchen Sie das Installationsverzeichnis der Unreal Engine und öffnen Sie Build/BatchFiles/Linux. Führen Sie anschließend SetupToolchain.sh aus.

3. Laden Sie VS Code sowie das offizielle C/C++-Erweiterungspaket und die C#-Erweiterung herunter und installieren Sie sie. Diese sind erforderlich, um den Quellcode der Unreal Engine und der Build-Werkzeuge zu lesen.

4. Öffnen Sie entweder den Unreal Editor, öffnen Sie Ihre Editor-Einstellungen und stellen Sie Ihren Quellcode-Editor auf Visual Studio Code ein, oder passen Sie BaseEngine.ini an, sodass sie Folgendes umfasst:

   C++

   [/Script/SourceCodeAccess.SourceCodeAccessSettings]
            PreferredAccessor=VisualStudioCode

   Copy full snippet(2 lines long)

5. Führen Sie GenerateProjectFiles.sh -vscode aus, um den VS Code-Arbeitsbereich für Ihre Engine-Distribution (im Falle eines Quellcode-Builds) oder Ihr Projekt zu generieren. Fügen Sie -project=(Pfad zu Ihrem Projekt) hinzu, um ein spezifisches Projekt auszuwählen.

Informationen zur Konfiguration von VS Code mit IntelliSense und andere hilfreiche Dienstprogramme finden Sie unter Setting Up VS Code for Unreal Engine (Einrichten von VS Code für die Unreal Engine).

5. Projekt erstellen

Da Ihre Umgebung nun vollständig eingerichtet ist, sollten Sie einen Test-Build Ihres Projekts ausführen, um sicherzustellen, dass Ihr Workflow voll funktionsfähig ist.

5a. Erstellen eines Projekts im Unreal Editor

Öffnen Sie Ihr Projekt im Unreal Editor, klicken Sie auf das Dropdown-Menü Plattformen und klicken Sie auf Linux > Projekt verpacken. Wenn Ihr System korrekt konfiguriert ist, erstellt, cookt und verpackt die Unreal Engine Ihr Projekt.

5b. Erstellen eines Projekts über die Befehlszeile

Um ein Projekt über die Befehlszeile zu erstellen, verwenden Sie den BuildCookRun-Befehl des RunUAT-Scripts, der in der Anleitung Build-Operationen beschrieben wird. Das folgende Beispiel zeigt einen funktionierenden BuildCookRun-Befehl:

[UE Root Directory]/RunUAT BuildCookRun -Build -Cook -Stage -Package -Run -Project=[ProjectName]

Alternativ können Sie auch die Turnkey-Befehlszeile verwenden, um den gleichen Prozess zu starten.

[UE Root Directory]/RunUAT Turnkey -command=ExecuteBuild -platform=Linux -Project=[ProjectName]