Einrichten einer Perforce-Verbindung

Epic Games stellt Lizenznehmern QA-genehmigte Builds von Unreal Engine sowie andere spezialisierte Code-Drops über ein Perforce-Depot zur Verfügung, das extern zugänglich ist. Dies ist eine der Methoden, die Lizenznehmer nutzen, um die Engine sowie Updates auf neue Versionen als Erstes zu erhalten, sobald diese veröffentlicht und vom Lizenznehmer für angemessen erachtet werden. Dieses Dokument beschreibt die Schritte zum lokalen Einrichten von Perforce, um eine Verbindung zum Unreal Engine-Depot von Epic Games herzustellen und mit einem Build der Engine zu synchronisieren.

Konnektivitätsrichtlinie

Bitte beachte, dass sich nur ein autorisierter Benutzer beim Perforce-Konto anmelden sollte. Die Anmeldung mehrerer Benutzer bei demselben Konto stellt einen Verstoß gegen die Nutzungsbedingungen von Perforce dar.

Die Empfehlung von Epic Games lautet, dass ein einzelner Benutzer oder ein Automatisierungsprogramm das Konto verwendet, um Engine-Builds mit deinem lokalen Perforce-Depot zu synchronisieren, und deinen Mitarbeitern den Zugriff mit ihren eigenen, von deinem Unternehmen lizenzierten Perforce-Konten ermöglicht.

Wenn du noch keine Perforce-Lizenz für dein Team hast, ist diese für bis zu 5 Benutzer kostenlos, oder du kannst die Lizenzierungsoptionen erkunden.

Der vollständige Prozess zum Herunterladen von Builds oder Revisionen von Unreal Engine aus dem Perforce-Depot von Epic Games wird auf der Seite Unreal Engine mit Perforce herunterladen ausführlich beschrieben.

Installation und Konfiguration

Einrichtung von P4V

Der P4V Client ist der aktuell von Perforce bereitgestellte Client. Es bietet Zugang zu versionierten Dateien über eine grafische Interface und umfasst Werkzeuge zur Zusammenführung und Visualisierung der Code-Entwicklung.

Der vollständige P4V-Installer kann von der Seite Perforce Downloads heruntergeladen werden. Zieh die P4V-Dokumentation von Perforce zu Rate, um Anweisungen zur Installation und Einrichtung von P4V zu erhalten.

Zeichenkodierung

Wenn du Unicode-Dateien als Text in Perforce speicherst, wird ein 0xd hinzugefügt, um dem lokalen Zeilenende zu entsprechen. Das Unicode-Zeilenende 0x0a 0x00 0x0d 0x00 wird also in 0x0a 0x0d 0x00 0x0d 0x00 umgewandelt und dann umgebrochen. Dabei bleibt deine lokale Version jedoch unverändert (und funktionsfähig). Synchronisiere mit einer früheren Version und dann zurück zum Head, um das Problem zu sehen.

Perforce definiert UTF-8 als Unicode. UTF-16 ist ideal, solange niemand aus Versehen in ASCII konvertiert. Binär funktioniert ebenfalls, solange dir keine Zusammenführung oder mehrere Bezahlvorgänge entgehen.

Unreal Engine lädt ASCII oder UTF-16 mit BOM, solange es sich um gültige Dateien handelt.

Einrichten von Perforce für Unreal Engine-Distribution

Dein Team erhält ein einziges Konto auf dem Perforce P4-Server von Epic Games, von dem ihr den Quellcode Unreal Engine herunterladen könnt. Befolge die nachstehenden Anweisungen, um einen Prozess für die gemeinsame Nutzung von Builds mit deinem Team einzurichten. 

Anfängliche Einrichtung und Import

1. Erstelle deinen eigenen (lokalen) P4-Server.

2. Erstelle ein Stream-Depot auf diesem Server, um es zu importieren, zum Beispiel: //UE5

3. Erstelle einen Stream für die jeweilige Version, die du aus Epic importierst, zum Beispiel: //UE5/Release-5.6.0

   1. Füge keine Dateien zu diesem lokalen Stream hinzu – du wirst sie unten in einem separaten Schritt hinzufügen.

4. Erstelle einen Arbeitsbereich auf dem Epic Games Perforce P4-Server (siehe Unreal Engine mit Perforce herunterladen) und synchronisiere die gewünschten Daten.

   1. Setze den Arbeitsbereich-Stammordner auf etwas wie z. B.C:\UE5\release-5.6

   2. Merke dir die neueste Änderungsliste, mit der du synchronisierst (sieh dir dazu den Tab „History“ in P4V an, während der Stream ausgewählt ist).

5. Erstelle in P4V eine neue Verbindung zu deinem eigenen Perforce P4-Server.

6. Erstelle einen Arbeitsbereich für deinen neuen Stream (//UE5/Release-5.6.0)

7. Lege als Stamm des Arbeitsbereichs denselben Ordner fest wie deinen Arbeitsbereich auf dem Epic Games Perforce P4-Server (in diesem Beispiel, C:\UE\release-5.6).

8. Klicke mit der rechten Maustaste auf den Stammordner und wähle Mark for Add.

9. Gehe zum Ordner mit den ausstehenden Änderungslisten und reiche die Änderungsliste ein.

   1. Notiere in der Beschreibung die Nummer der Änderungsliste, die du vom Epic Games Server synchronisiert hast

Hole und importiere einen neuen Schnappschuss von Epic Games

Das ist ein regulärer Prozess, der die zuvor erstellten Arbeitsbereiche verwendet. Es handelt sich um eine modifizierte Teilmenge der oben genannten Schritte, und dieser Arbeitsablauf setzt voraus, dass du deine Arbeitsbereiche noch wie zuvor eingerichtet haben. Du wirst die neuesten Änderungen importieren.

1. Verbinde dich mit dem Epic Games Perforce P4-Server

   1. Wähle den zuvor erstellten Arbeitsbereich aus.

   2. Klicke auf Get Lastest, um die Dateien zu aktualisieren.

   3. Notiere die letzte Änderungsliste, mit der du synchronisiert hast.

2. Verbinde dich mit deinem lokalen Perforce P4-Server.

3. Wähle den zuvor erstellten Arbeitsbereich aus.

4. Klicke mit der rechten Maustaste auf den Stammordner und wähle Reconcile offline work.

5. Gehe zum Ordner mit den ausstehenden Änderungslisten und reiche die Änderungsliste ein.

   1. Notiere in der Beschreibung die Nummer der Änderungsliste, die du vom Epic Games Server synchronisiert hast.

Support

Verbindungsprobleme

Solltest du aus irgendeinem Grund keine Verbindung zum Perforce-Depot herstellen können, wende dich bitte an [email protected] oder poste auf Epic Pro Support.