Projekte, die nach Version 36.00 erstellt wurden, können den unten angegebenen Dateipfad für die Verwendung von CLI-Befehlen nicht verwenden. Wenn du nach dem Dateipfad suchst, suche nach urc2.exe.
Verwende die folgenden CLI-Befehle für Projekte nach 36.00:
Alle Revisionen in deinem Repository ansehen
urc2 revision list
Mit der neuesten Revision des Projekts synchronisieren
urc2 revision sync
Mit einer vorherigen Revision in deinem Repository-Verlauf synchronisieren
urc2 revision sync @[revision]
Verschaffe dir einen Überblick über alle Assets und deren Status innerhalb einer bestimmten Revision
urc2 repository status
Rollback zu einer bestimmten Revision, um die Arbeit mit einer früheren Sicherung fortzusetzen
urc2 revision promote "description"
Ein Asset auf die aktuelle Revision zurücksetzen, um deine Änderungen rückgängig zu machen
urc2 file reset .\pathname
Von einem bestimmten Teammitglied signierte Assets freigeben, um dich selbst zu entsperren
urc2 lock release --force --owner <username>
Das Unreal Revision Control (URC) Befehlszeile Interface (CLI) ermöglicht es dir, mit einem Befehlszeilenwerkzeug eines Drittanbieters, wie z. B. PowerShell, Aktionen zur Revisionskontrolle in deinem Projekt durchzuführen. Obwohl diese Aktionen oft mit der Benutzeroberfläche durchgeführt werden können, erlauben einige, über das hinauszugehen, was die Benutzeroberfläche derzeit unterstützt.
Dieses Dokument gibt einen Überblick über:
Erste Schritte mit CLI
Gängige Anwendungsfälle und wie man sie mit dem CLI erzielt
Bevor es losgehen kann
Um Befehlszeilen zu verwenden, musst du wissen, wo sich die URC-Dateien im Windows Explorer befinden und eine Umgebungsvariable einrichten, um Befehlszeilen mit URC zu erstellen und zu verwenden.
Bevor du die Umgebungsvariable setzt, stelle sicher, dass du den Ordner, in dem die urc.exe in deiner Pfadvariable existiert.
Öffne deine Windows-Einstellungen und wähle System > Über > Erweiterte Systemeinstellungen. Das Panel Systemeigenschaften wird geöffnet.
Klicke auf Umgebungsvariablen...
Klicke, um das Bild zu vergrößern.
Wähle Pfad > Bearbeiten aus der Liste Nutzervariablen, um die Umgebungsvariablen für den Pfad zu bearbeiten.
Klicke, um das Bild zu vergrößern.
Dein Name erscheint nach C:\Benutzer\
Wähle Durchsuchen und wähle den Dateipfad, der zu deinen urc.exe-Dateien führt. Diese befinden sich normalerweise unter
C:\Programme\Epic Games\Fortnite\FortniteGame\Binaries\Win64Klicke auf OK, bis alle offenen Panels geschlossen sind.
Du hast erfolgreich eine Umgebungsvariable bearbeitet.
PowerShell starten
Öffne das Unreal Editor für Fortnite (UEFN)-Projekt, an dem du gerade arbeitest, mit dem Windows Explorer.
Stelle sicher, dass du dich zuerst bei UEFN anmeldest, bevor du andere URC-CLI-Befehle verwendest.
Dies hängt davon ab, ob du dich kürzlich bei UEFN angemeldet hast. Du musst urc auth login nicht aufrufen, wenn UEFN offen ist und du eingeloggt bist, es sei denn, das Token läuft ab. Wenn du die CLI ohne geöffnetes UEFN oder nach Ablauf des Tokens verwendest, musst du dich bei der CLI anmelden.
Umschalttaste + Rechtsklick, um das kontextbezogene Menü zu öffnen.
Wähle Öffne PowerShell-Fenster hier.
Gängige CLI Anwendungsfälle
Auflistung aller Projekte, auf die du Zugriff hast, wenn du mit deinem Konto eingeloggt bist.
| CLI Befehle |
|---|
urc project list |
urc p list |
Klicke, um das Bild zu vergrößern.
Alle Schnappschüsse deines Projekts sehen.
| CLI Befehle |
|---|
urc project snapshot list |
urc p s list |
Synchronisierung mit einem vorherigen Schnappschuss, um im Projektverlauf zurückzugehen.
Schließe das Projekt oder den Editor vor der Synchronisierung mit einem bestimmten Schnappschuss, um zu vermeiden, dass die Projektdateien nicht synchronisiert werden.
| CLI Befehle |
|---|
urc project snapshot get <number of snapshot> |
urc p s get <number of snapshot> |
Klicke, um das Bild zu vergrößern.
Synchronisierung auf den neuesten Stand, so dass du die Aktualisierungen aller Personen auf der Insel abrufen kannst.
| CLI Befehle |
|---|
urc project snapshot get |
urc p s get |
Klicke, um das Bild zu vergrößern.
Verschaffe dir vor dem Absenden einen Überblick über alle Assets und deren Status im aktuellen Schnappschuss.
| CLI Befehle |
|---|
urc project status --extended |
urc p status --extended |
Klicke, um das Bild zu vergrößern.
Auf einen bestimmten Schnappschuss zurückgehen, um die Arbeit mit einer früheren Sicherung fortzusetzen.
Synchronisiere dein Projekt mit einem früheren Schnappschuss
| CLI Befehle |
|---|
urc projects snapshots get <number of snapshot> |
Wenn du eine Liste von Schnappschüssen sehen willst, um die Projektversion auszuwählen, mit der du synchronisieren willst, benutze den Befehl:
| CLI Befehle |
|---|
urc projects snapshots list |
Klicke, um das Bild zu vergrößern.
Kopiere den Ordner Plugins und füge ihn auf deinem Desktop ein, um eine Sicherungskopie deiner Assets zu erstellen.
Synchronisiere anschließend wieder mit dem letzten Schnappschuss.
| CLI Befehle |
|---|
urc projects snapshots get |
Sobald du das Projekt erfolgreich mit dem neuesten Schnappschuss synchronisiert hast, gehe wie folgt vor:
Lösche Plugins aus deinem aktuellen UEFN-Projektordner.
Kopiere den vorherigen Ordner Plugins vom Desktop und füge ihn in den Projektordner ein.
Öffne dein Projekt in UEFN und vergewissere dich, dass es so aussieht, wie du es dir vorgestellt hast.
Klicke auf Änderungen einchecken, wenn dein Projekt so aussieht, wie du es erwartest, um einen neuen Schnappschuss zu erstellen, der den neuen Zustand deines Projekts widerspiegelt.
Rückgängigmachen eines Assets zum aktuellen Schnappschuss, um deine Änderungen rückgängig zu machen.
| CLI Befehle |
|---|
urc asset revert .\pathname |
urc a revert .\pathname |
Klicke, um das Bild zu vergrößern.
Freigabe von Assets, die von einem bestimmten Teammitglied ausgecheckt wurden, so dass du weiterarbeiten kannst, ohne dass jemand deine Arbeit blockiert.
Rufe die Projekt-ID ab, indem du das Projekt im Creator-Portal öffnest. Du kannst die Projekt-ID in der Url sehen.
Klicke, um das Bild zu vergrößern.
Diese Funktion kann nur von einem Teamadministrator ausgeführt werden. Überprüfe deine Teamrolle im Creator-Portal.
| CLI Befehle |
|---|
urc project forcerelease <projectID> –-user UserName |
urc p forcerelease <projectID> –-user UserName |
Klicke, um das Bild zu vergrößern.