BuildGraph-Script-Aufgabenreferenz für Unreal Engine | Unreal Engine 5.7 Dokumentation

Normalerweise werden projektspezifische Hilfs-Scripts als BuildCommand-Klassen des Unreal Automatisierungswerkzeugs (UAT) implementiert. Es gibt jedoch Situationen, in denen Sie benutzerdefinierte Aufgaben für Ihr Projekt automatisieren müssen. Hier kann BuildGraph Hilfe leisten, da Sie BuildGraph um eine beliebige Anzahl von Automatisierungsaufgaben erweitern können, die Ihren spezifischen Bedürfnissen entsprechen. Der folgende Abschnitt führt Sie durch verschiedene Methoden zum Erstellen benutzerdefinierter Aufgaben mit BuildGraph, darunter auch eine Auflistung vordefinierter Aufgaben, die Ihnen einen guten Ausgangspunkt für die Erstellung benutzerdefinierter Aufgaben bieten.

Benutzerdefinierte Aufgaben

Zum Erstellen einer neuen benutzerdefiniert Aufgabe müssen Sie eine von der CustomTask-Klasse abgeleitete Klasse implementieren und das TaskElement-Attribut auf sie anwenden. Der TaskElement-Constructor akzeptiert zwei Argumente: den Namen des XML-Elements, durch das er repräsentiert wird, und den Typ der Klasse, die seine Parameter enthält (der zum Laden an den Constructor übergeben wird).

Wenn Sie Parameter-Klassenfelder aus einer XML-Datei auslesen möchten, hängen Sie das Attribut TaskParameter an die Aufgabe an. Das Anhängen des TaskParameter-Attributs zeigt an, ob der Parameter erforderlich oder optional ist, einschließlich zusätzlicher Validierung, die auf das Argument angewendet werden sollte.

Vordefinierte Aufgaben

Wenn Sie einen Ausgangspunkt für die Erstellung von Aufgaben benötigen, bieten wir Ihnen eine Reihe vordefinierter Aufgaben als Vorlagen an, mit denen Sie arbeiten können. Wenn Sie nach einer einfachen, vordefinierten Aufgabe suchen, mit der Sie anfangen können, empfehlen wir LogTask als einen guten Ausgangspunkt. Wenn Sie in Bezug auf unsere neuesten Verbesserungen für BuildGraph immer auf dem Laufenden bleiben wollen, setzen Sie eine Lesezeichen für diese Seite. Die folgende Liste vordefinierter Aufgaben wird regelmäßig aktualisiert.

BuildCookRun ist ein mächtiger und häufig verwendeter Befehl für die Paketierung von Aufgaben. Weitere Informationen finden Sie in der Übersicht zu Build-Operationen.

AgeStore

Aufgabe, die Symbole aus einer Reihe von Dateien entfernt. Diese Aufgabe ist nach dem Dienstprogramm AGESTORE benannt, das im SDK der Microsoft-Debuggertools enthalten ist, handelt es sich jedoch tatsächlich um eine separate Implementierung. Der Hauptunterschied besteht darin, dass zur Ermittlung der zu löschenden Dateien der Zeitpunkt der letzten Änderung und nicht der Zeitpunkt des letzten Zugriffs verwendet wird.


Plattform	UnrealTargetPlatform	Erforderlich	Die Zielplattform, für die Symbole altern sollen.
StoreDir	String	Erforderlich	Das Symbolserververzeichnis.
Tage	Integer	Erforderlich	Anzahl der aufzubewahrenden Symbole in Tagen.
BuildDir	String	Optional	Das Stammverzeichnis des Build-Verzeichnisses, um nach vorhandenen Verzeichnissen mit Buildversion-Namen zu suchen.
Filter	String	Optional	Eine Teilzeichenfolge, die in Verzeichnisdateinamen abgeglichen werden soll, bevor Symbole gelöscht werden. Dadurch kann die Aufgabe „Age Store“ das Löschen von Symbolen aus anderen Builds vermeiden, wenn mehrere Builds denselben Symbolserver gemeinsam nutzen. Die spezifische Verwendung des Filterwerts wird durch die von der Plattform-Toolchain definierte Symbolserverstruktur bestimmt.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Aws

Erzeugt AWS CLI und wartet auf dessen Abschluss.


Argumente	String	Optional	Argumente für den neu erstellten Prozess.
Umgebung	String	Optional	Umgebungsvariablen.
Umgebungsdatei	String	Optional	Datei, aus der die Umgebung gelesen werden soll.
Protokoll-Outputs	boolesch	Optional	Output in das Protokoll schreiben.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Aws-AssumeRole

Übernimmt eine AWS-Rolle.


Arn	String	Erforderlich	Zu übernehmende Rolle
Sitzung	String	Erforderlich	Name dieser Sitzung.
Dauer	Integer	Optional	Dauer des Tokens in Sekunden.
Umgebung	String	Optional	Umgebungsvariablen.
Umgebungsdatei	String	Optional	Datei, aus der Umgebungsvariablen gelesen werden.
Outputdatei	String	Erforderlich	Outputdatei für die neue Umgebung.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Aws-EcsDeploy

Erstellt eine neue AWS ECS-Aufgabendefinition und aktualisiert den ECS-Dienst, um diese neue Revision der Aufgabendefinition zu verwenden


TaskDefinitionFile	String	Erforderlich	Zu verwendende Aufgabendefinitionsdatei.
DockerImage	String	Erforderlich	Docker-Image zum Einrichten in der neuen Aufgabendefinition (ersetzt %%DOCKER_PATTERN%% mit diesem Wert).
Version	String	Optional	App-Version, die in der neuen Aufgabendefinition festgelegt werden soll (ersetzt %%VERSION%% mit diesem Wert).
Cluster	String	Erforderlich	Cluster-ARN, der den zu bearbeitenden AWS ECS-Cluster darstellt.
Service	String	Erforderlich	Name des zu aktualisierenden und bereitzustellenden Dienstes.
Umgebung	String	Optional	Umgebungsvariablen.
Umgebungsdatei	String	Optional	Datei, aus der die Umgebung gelesen werden soll.
Protokoll-Outputs	boolesch	Optional	Output in das Protokoll schreiben.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

CheckMarkdown

Überprüft, ob alle Markdown-Links zwischen den angegebenen Dateien gültig sind.


Dateien	FileSpec	Optional	Optionaler Filter, der auf die Liste der Inputdateien angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Befehl

Ruft einen untergeordneten AutomationTool-Prozess auf, um den angegebenen Befehl auszuführen.


Name	String	Erforderlich	Der Name des auszuführenden Befehls.
Argumente	String	Optional	An den Befehl zu übergebende Argumente.
MergeTelemetryWithPrefix	String	Optional	Wenn ungleich null, wird angewiesen, die Telemetriedaten aus dem Befehl mit dem angegebenen Präfix in die Telemetriedaten für diese UAT-Instanz einzufügen. Kann eine leere (nicht null) Zeichenfolge sein.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Commandlet

Startet den Editor zum Ausführen eines Commandlets.


Name	String	Erforderlich	Der Name des auszuführenden Commandlets.
Project	FileSpec	Optional	Das Projekt, mit dem der Editor ausgeführt werden soll.
Argumente	String	Optional	An das Cmdlet zu übergebende Argumente.
EditorExe	Dateireferenz	Optional	Die zu verwendende ausführbare Editordatei. Standardmäßig wird die ausführbare Entwicklungsdatei von UnrealEditor für die aktuelle Plattform verwendet.
Fehlerebene	Integer	Optional	Der minimale Exitcode, der als Fehler behandelt wird.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Kompilieren

Kompiliert ein Ziel mit UnrealBuildTool.


Ziel	String	Optional	Das zu kompilierende Ziel.
Konfiguration	UnrealTargetConfiguration	Erforderlich	Die zu kompilierende Konfiguration.
Plattform	UnrealTargetPlatform	Erforderlich	Die Plattform, für die kompiliert werden soll.
Project	FileSpec	Optional	Das zu kompilierende Projekt.
Argumente	String	Optional	Zusätzliche Argumente für UnrealBuildTool.
AllowXGE	boolesch	Optional	Ob die Verwendung von XGE zur Kompilierung zulässig ist.
AllowParallelExecutor	boolesch	Optional	Ob die Verwendung des parallelen Executors für diese Kompilierung zulässig sein soll.
AllowAllCores	boolesch	Optional	Ob UBT alle verfügbaren Kerne verwenden darf, wenn AllowXGE deaktiviert ist.
Sauber	boolesch	Optional	Ob die Bereinigung dieses Ziels zulässig sein soll. Wenn nichts angegeben ist, werden Ziele bereinigt, wenn das Argument -Clean in der Befehlszeile übergeben wird.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Cooken

Bereiten Sie eine Auswahl von Karten für eine bestimmte Plattform vor


Project	String	Erforderlich	Zu kochende Projektdatei.
Plattform	String	Erforderlich	Die Ziel-Cook-Plattform (z. B. Windows).
Karten	String	Optional	Liste der zu erstellenden Karten, getrennt durch das Zeichen „+“.
Versioniert	boolesch	Optional	Zusätzliche Argumente, die an den Cooker übergeben werden sollen.
Argumente	String	Optional	Zusätzliche Argumente, die an den Cooker übergeben werden sollen.
EditorExe	String	Optional	Optionaler Pfad zur ausführbaren Editordatei, die zum Kochen ausgeführt werden soll.
TagOutput	boolesch	Optional	Ob die Output des Cooks markiert werden soll. Da Cooks viele Dateien produzieren, kann es nachteilig sein, Zeit mit dem Taggen dieser Dateien zu verbringen, wenn wir sie in einem abhängigen Knoten nicht benötigen.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Kopieren

Kopiert Dateien von einem Verzeichnis in ein anderes.


Dateien	FileSpec	Optional	Optionaler Filter, der auf die Liste der Inputdateien angewendet werden soll.
Von	FileSpec	Erforderlich	Das/Die Muster, aus dem/denen kopiert werden soll(en) (z. B. Engine/*.txt).
An	FileSpec	Erforderlich	Das Verzeichnis, in das kopiert werden soll.
Überschreiben	boolesch	Optional	Ob vorhandene Dateien überschrieben werden sollen oder nicht.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
FehlerWennNichtGefunden	boolesch	Optional	Gibt an, ob ein Fehler ausgegeben werden soll, wenn keine zu kopierenden Dateien gefunden wurden.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Artefakt erstellen

Lädt ein Artefakt zur Horde hoch.


Name	String	Erforderlich	Name des Artefakts.
Typ	String	Erforderlich	Der Artefakttyp. Bestimmt die Berechtigungen und Ablaufrichtlinien für das Artefakt.
Beschreibung	String	Optional	Beschreibung des Artefakts. Wird über das Horde-Dashboard angezeigt.
Basisverzeichnis	String	Optional	Basispfad für die hochgeladenen Dateien. Alle markierten Dateien müssen sich in diesem Verzeichnis befinden. Standardmäßig ist dies das Stammverzeichnis des Arbeitsbereichs.
StreamId	String	Optional	Stream, der das Artefakt enthält.
Begehen	String	Optional	Commit für das hochgeladene Artefakt.
Dateien	FileSpec	Erforderlich	In das Artefakt aufzunehmende Dateien.
Keys	String	Optional	Abfragbare Schlüssel für dieses Artefakt, durch Semikolons getrennt.
Metadaten	String	Optional	Andere Metadaten für das Artefakt, durch Semikolons getrennt.
Symbole	boolesch	Optional	Ob Aliase für Symboldateien hinzugefügt werden sollen.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

CsCompile

Kompiliert C#-Projektdateien und ihre Abhängigkeiten.


Project	String	Erforderlich	Die zu kompilierende C#-Projektdatei. Durch die Verwendung von Semikolons können mehrere Projektdateien angegeben werden.
Konfiguration	String	Optional	Die zu kompilierende Konfiguration.
Plattform	String	Optional	Die Plattform zum Kompilieren.
Ziel	String	Optional	Das zu erstellende Ziel.
Eigenschaften	String	Optional	Eigenschaften für den Befehl
Argumente	String	Optional	Zusätzliche Optionen, die an den Compiler übergeben werden sollen.
Nur aufzählen	boolesch	Optional	Listen Sie nur die Build-Produkte auf – kompilieren Sie die Projekte nicht wirklich.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
TagReferences	TagList	Optional	Tag, der auf alle nicht privaten Referenzen der Projekte angewendet werden soll. (zum Beispiel solche, die extern sind und nicht in das Outputverzeichnis kopiert werden).
UseSystemCompiler	boolesch	Optional	Ob die System-Toolchain anstelle des mitgelieferten UE SDK verwendet werden soll
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Löschen

Löschen Sie eine Reihe von Dateien.


Dateien	FileSpec	Optional	Liste der durch Semikolons getrennten Dateispezifikationen (z. B. `.cpp;Engine/.../.bat`) oder der Name eines Tag-Sets
Verzeichnisse	String	Optional	Liste der Verzeichnisnamen
Leere Verzeichnisse löschen	boolesch	Optional	Ob leere Verzeichnisse nach dem Löschen der Dateien gelöscht werden sollen. Der Standardwert lautet „True“.
Verbose	boolesch	Optional	Ob ausführliche Protokollierung verwendet werden soll oder nicht.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Bereitstellungstool

Stellt ein Tool-Update über Horde bereit


ID	String	Erforderlich	Kennung für das Werkzeug
Einstellungen	String	Erforderlich	Für die Bereitstellung zu verwendende Einstellungsdatei. Sollte eine JSON-Datei sein, die den Servernamen und das Zugriffstoken enthält.
Version	String	Erforderlich	Versionsnummer für das neue Tool
Dauer	Integer	Optional	Dauer der Bereitstellung des Tools in Minuten.
Pausiert	boolesch	Optional	Ob die Bereitstellung als angehalten erstellt werden soll
Datei	String	Optional	ZIP-Datei mit den hochzuladenden Dateien
Verzeichnis	String	Optional	Verzeichnis zum Hochladen für das Tool
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Docker

Startet Docker und wartet auf dessen Abschluss.


Argumente	String	Erforderlich	Docker-Befehlszeilenargumente
Umgebung	String	Optional	Zu setzende Umgebungsvariablen
Umgebungsdatei	String	Optional	Datei zum Lesen von Umgebungsvariablen
Arbeitsverzeichnis	String	Optional	Basisverzeichnis zum Ausführen des Befehls
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Docker-Build

Startet Docker und wartet auf dessen Abschluss.


Basisverzeichnis	String	Erforderlich	Basisverzeichnis für den Build
Dateien	String	Erforderlich	Vor dem Erstellen des Images zu inszenierende Dateien
DockerFile	String	Optional	Pfad zur Docker-Datei. Verwendet das Stammverzeichnis von basedir, wenn nicht anders angegeben.
DockerIgnoreFile	String	Optional	Pfad zu einer.dockerignore. Wird in das Basisverzeichnis kopiert, falls angegeben.
UseBuildKit	boolesch	Optional	Verwenden Sie BuildKit in Docker
Fortschritts-Output	String	Optional	Art der Fortschritts-Output (--progress)
Tag	String	Optional	Tag für das Bild
Argumente	String	Optional	Optionale Argumente
OverlayDirs	String	Optional	Liste zusätzlicher Verzeichnisse, die in die bereitgestellten Inputdateien eingefügt werden sollen. Ermöglicht die Bereitstellung von Anmeldeinformationen usw.
Umgebung	String	Optional	Zu setzende Umgebungsvariablen
Umgebungsdatei	String	Optional	Datei zum Lesen von Umgebungsvariablen
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Docker-Compose-Down

Startet Docker und wartet auf dessen Abschluss.


Datei	String	Erforderlich	Pfad zur Docker-Compose-Datei
Argumente	String	Optional	Argumente für den Befehl
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Docker-Compose-Up

Startet Docker und wartet auf dessen Abschluss.


Datei	String	Erforderlich	Pfad zur Docker-Compose-Datei
Argumente	String	Optional	Argumente für den Befehl
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Docker-Push

Startet Docker und wartet auf dessen Abschluss.


Repository	String	Erforderlich	Repository
Bild	String	Erforderlich	Quellbild zum Pushen
Zielbild	String	Optional	Name des Zielbildes
Umgebung	String	Optional	Zusätzliche Umgebungsvariablen
Umgebungsdatei	String	Optional	Datei zum Lesen der Umgebung
AwsEcr	boolesch	Optional	Ob eine Anmeldung bei AWS ECR erfolgen soll
RepositoryAuthFile	String	Optional	Pfad zu einer JSON-Datei zur Authentifizierung beim Repository zum Pushen.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

DotNet

Startet Docker und wartet auf dessen Abschluss.


Argumente	String	Optional	Docker-Befehlszeilenargumente
Basisverzeichnis	String	Optional	Basisverzeichnis zum Ausführen des Befehls
Umgebung	String	Optional	Zu setzende Umgebungsvariablen
Umgebungsdatei	String	Optional	Datei zum Lesen von Umgebungsvariablen
Fehlerebene	Integer	Optional	Der minimale Exitcode, der als Fehler behandelt wird.
DotNetPath	Dateireferenz	Optional	Pfad zur ausführbaren Dotnet-Datei überschreiben
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Geänderte Dateien suchen

Kompiliert C#-Projektdateien und ihre Abhängigkeiten.


Pfad	FileSpec	Optional	Liste der durch Semikolon getrennten Dateispezifikationen (Standard ist...)
Ändern	Integer	Optional	Die zu kompilierende Konfiguration.
MinÄnderung	Integer	Optional	Die zu kompilierende Konfiguration.
MaxChange	Integer	Optional	Die zu kompilierende Konfiguration.
Output	Dateireferenz	Optional	Die Datei, in die geschrieben werden soll
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Git

Erzeugt Git und wartet auf dessen Abschluss.


Argumente	String	Optional	Git-Befehlszeilenargumente
Basisverzeichnis	String	Optional	Basisverzeichnis zum Ausführen des Befehls
Fehlerebene	Integer	Optional	Der minimale Exitcode, der als Fehler behandelt wird.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Git-Klon

Klont ein Git-Repository in einen lokalen Pfad.


Richt	String	Erforderlich	Verzeichnis für das Repository
Remote	String	Optional	Die hinzuzufügende Fernbedienung
Verzweigung	String	Erforderlich	Der auszucheckende Zweig auf der Fernbedienung
Konfigurationsdatei	String	Optional	Konfigurationsdatei für das Repo. Damit kann ein Remote-Abruf eingerichtet und/oder Anmeldeinformationen bereitgestellt werden.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Helm

Erzeugt Helm und wartet, bis es abgeschlossen ist.


Diagramm	String	Erforderlich	Helm-Befehlszeilenargumente
Bereitstellung	String	Erforderlich	Name der Veröffentlichung
Namespace	String	Optional	Der Kubernetes-Namespace
KubeContext	String	Optional	Der kubectl-Kontext
KubeConfig	String	Optional	Die zu verwendende kubectl-Konfigurationsdatei
Werte	String	Optional	Zum Ausführen des Diagramms festzulegende Werte
Wertedatei	String	Optional	Zum Ausführen des Diagramms festzulegende Werte
Umgebung	String	Optional	Zu setzende Umgebungsvariablen
Umgebungsdatei	String	Optional	Datei zum Analysieren von Umgebungsvariablen
Argumente	String	Optional	Zusätzliche Argumente
Arbeitsverzeichnis	String	Optional	Basisverzeichnis zum Ausführen des Befehls
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Horde-Erstellungsbericht

Erstellt eine Horde-Berichtsdatei, die bei jedem Job, der diese Aufgabe ausführt, auf dem Dashboard angezeigt wird.


Name	String	Erforderlich	Name für den Bericht
Bereich	String	Erforderlich	Wo der Bericht angezeigt werden soll
Platzierung	String	Erforderlich	Wo soll der Bericht angezeigt werden?
Text	String	Erforderlich	Anzuzeigender Text
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Horde-GetSecrets

Ersetzt Zeichenfolgen in einer Textdatei durch von Horde erhaltene Geheimnisse.


Datei	String	Erforderlich	Mit Geheimnissen zu aktualisierende Datei.
Text	String	Optional	Mit Geheimnissen zu aktualisierender Text.
Ersetzen	String	Optional	Paare aus Zeichenfolgen und geheimen Namen, die in der Textdatei erweitert werden sollen, in der Form SOURCE_TEXT=geheimer Name;SOURCE_TEXT_2=geheimer Name-2. Wenn nicht angegeben, werden im Text eingebettete Geheimnisse aus {{secret-name.value}} erweitert. Saiten.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Horde-SetSecretEnvVar

Ersetzt Zeichenfolgen in einer Textdatei durch von Horde erhaltene Geheimnisse.


Name	String	Erforderlich	Name der festzulegenden Umgebungsvariablen.
Geheimnis	String	Erforderlich	Name des abzurufenden Geheimnisses.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Kubectl

Erzeugt Kubectl und wartet auf dessen Abschluss.


Argumente	String	Erforderlich	Befehlszeilenargumente
Basisverzeichnis	String	Optional	Basisverzeichnis zum Ausführen des Befehls
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Log

Drucken Sie eine Nachricht (und andere optionale Diagnoseinformationen) in das Outputprotokoll.


Nachricht	String	Optional	Nachricht zum Ausdrucken.
Dateien	FileSpec	Optional	Wenn angegeben, wird die angegebene Dateiliste nach der angegebenen Nachricht gedruckt.
Inhalt einschließen	boolesch	Optional	Wenn angegeben, wird der Inhalt der angegebenen Dateien ausgedruckt.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

ModifyConfig

Ändert eine Konfigurationsdatei


Datei	FileSpec	Erforderlich	Pfad zur Konfigurationsdatei
Abschnitt	String	Erforderlich	Der zu ändernde Abschnittsname
Schlüssel	String	Erforderlich	Der festzulegende Eigenschaftsname
Wert	String	Erforderlich	Der festzulegende Eigenschaftswert
Tag	TagList	Optional	Auf die extrahierten Dateien anzuwendendes Tag
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

ModifyJsonValue

Ändert JSON-Dateien durch Festlegen eines im Schlüsselpfad angegebenen Werts


Dateien	FileSpec	Erforderlich	JSON-Dateipfade, die geändert werden
KeyPath	String	Erforderlich	JSON-Schlüsselpfad, der in jeder Datei zu finden ist
NewValue	Integer	Erforderlich	neuer anzuwendender Wert
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Verschieben

Verschiebt Dateien von einem Verzeichnis in ein anderes.


Dateien	FileSpec	Optional	Optionaler Filter, der auf die Liste der Inputdateien angewendet werden soll.
Von	FileSpec	Erforderlich	Das/Die Muster, aus dem/denen kopiert werden soll(en) (z. B. Engine/*.txt).
An	FileSpec	Erforderlich	Das Verzeichnis, in das kopiert werden soll.
Überschreiben	boolesch	Optional	Optional: Wenn Dateien überschrieben werden sollen, ist der Standardwert „false“.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
FehlerWennNichtGefunden	boolesch	Optional	Gibt an, ob ein Fehler ausgegeben werden soll, wenn keine zu kopierenden Dateien gefunden wurden.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

MsBuild

Führt MsBuild aus


Project	String	Erforderlich	Die zu kompilierende C#-Projektdatei. Durch die Verwendung von Semikolons können mehrere Projektdateien angegeben werden.
Konfiguration	String	Optional	Die zu kompilierende Konfiguration.
Plattform	String	Optional	Die Plattform zum Kompilieren.
Argumente	String	Optional	Zusätzliche Optionen, die an den Compiler übergeben werden sollen.
Ausführlichkeit	String	Optional	Die Ausführlichkeit der MSBuild-Output.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

NuGet-Lizenzprüfung

Startet Docker und wartet auf dessen Abschluss.


Basisverzeichnis	String	Erforderlich	Basisverzeichnis zum Ausführen des Befehls
Pakete ignorieren	String	Optional	Gibt eine durch Semikolons getrennte Liste von Paketen an, die bei Versionsprüfungen ignoriert werden sollen. Optional kann die Versionsnummer mit der Syntax „Name@Version“ angegeben werden.
Lizenzverzeichnis	Verzeichnisreferenz	Optional	Verzeichnis mit zulässigen Lizenzen
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Beim Verlassen

Erzeugt eine externe ausführbare Datei und wartet auf deren Abschluss.


Befehl	String	Erforderlich	Ausführbare Datei zum Erstellen.
Lease	boolesch	Optional	Ob bei einer Kündigung des Mietvertrags eine Ausführung erfolgen soll
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

PakFile

Erstellt eine PAK-Datei aus einem bestimmten Satz von Dateien.


Dateien	FileSpec	Erforderlich	Liste der Dateien, Platzhalter und Tag-Sets, die der Pak-Datei hinzugefügt werden sollen, getrennt durch das Zeichen „;“.
Output	Dateireferenz	Erforderlich	Auszugebende PAK-Datei.
Antwortdatei	Dateireferenz	Optional	Pfad zu einer Antwortdatei, die eine Liste von Dateien enthält, die der Pak-Datei hinzugefügt werden sollen – anstatt sie einzeln anzugeben.
RebaseDir	Verzeichnisliste	Optional	Verzeichnisse, auf die die Dateien relativ neu basiert werden sollen. Falls angegeben, wird für jede Datei der kürzeste Pfad unter einem aufgelisteten Verzeichnis verwendet.
Reihenfolge	Dateireferenz	Optional	Skript, das die Reihenfolge der Dateien angibt.
Zeichen	Dateireferenz	Optional	Verschlüsselungsschlüssel für diese Pak-Datei.
Kompresse	boolesch	Optional	Ob Dateien komprimiert werden sollen.
Argumente	String	Optional	Zusätzliche Argumente zur Übergabe an UnrealPak.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Abfrageziele

Führt UBT aus, um alle Ziele für ein bestimmtes Projekt abzufragen


Projektdatei	Dateireferenz	Optional	Pfad zur abzufragenden Projektdatei
Outputdatei	Dateireferenz	Optional	Pfad zur Outputdatei, um Informationen zu den Zielen zu erhalten
Alle Ziele einschließen	boolesch	Optional	Alle Ziele ausgeben, auch wenn im Abschnitt BuildSettings der Default*.ini ein Standardwert angegeben ist Dateien.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Zufallsdaten

Erstellt Dateien mit zufälligen Daten im angegebenen Outputverzeichnis. Wird zum Generieren von Testdaten für das temporäre Speichersystem verwendet.


Größe	Integer	Optional	Die Größe jeder Datei.
Anzahl	Integer	Optional	Anzahl der zu schreibenden Dateien.
Anders	boolesch	Optional	Ob für jede Outputdatei unterschiedliche Daten generiert werden sollen.
Outputverzeichnis	String	Optional	Outputverzeichnis
Tag	String	Optional	Optionaler Filter, der auf die Liste der Inputdateien angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Versöhnen

Erstellt eine neue Änderungsliste und gleicht eine Reihe von Dateien ab, um sie an einen Perforce-Stream zu senden.


Beschreibung	String	Erforderlich	Die Beschreibung für die übermittelte Änderungsliste.
Dateien	FileSpec	Optional	Die abzugleichenden Dateien.
Verzeichnisse	String	Optional	Die abzugleichenden Verzeichnisse, durch Semikolon getrennt, relative P4-Syntax.
Arbeitsbereich	String	Optional	Der Name des Arbeitsbereichs. Falls angegeben, wird ein neuer Arbeitsbereich mit dem angegebenen Stream und Stammverzeichnis erstellt, um die Dateien zu übermitteln. Wenn nicht, wird der aktuelle Arbeitsbereich verwendet.
Stream	String	Optional	Der Stream für den Arbeitsbereich – standardmäßig der aktuelle Stream. Wird ignoriert, sofern das Workspace-Attribut nicht ebenfalls angegeben ist.
Verzweigung	String	Optional	Zweig für den Arbeitsbereich (alter P4-Depotpfad). Darf nicht in Verbindung mit Stream verwendet werden.
Stammverzeichnis	Verzeichnisreferenz	Optional	Stammverzeichnis für den Stream. Wenn nicht angegeben, wird standardmäßig das aktuelle Stammverzeichnis verwendet.
Erzwingen	boolesch	Optional	Erzwingen Sie die Übermittlung – auch wenn eine Lösung erforderlich ist (immer die aktuelle Version akzeptieren).
P4Verbose	boolesch	Optional	Ausführliche P4-Output zulassen (spew).
Vorschau	boolesch	Erforderlich	Führt eine Abstimmungsvorschau aus, sendet aber nicht.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Umbenennen

Benennt eine Datei oder eine Gruppe von Dateien um.


Dateien	FileSpec	Erforderlich	Die umzubenennende(n) Datei(en).
Von	String	Optional	Der aktuelle Dateiname oder das zu vergleichende Muster (z. B. *.txt). Sollte keine Pfadtrennzeichen enthalten.
An	String	Erforderlich	Der neue Name für die Datei(en). Sollte keine Pfadtrennzeichen enthalten.
Tag	TagList	Optional	Auf die umbenannten Dateien anzuwendendes Tag.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

SanitizeReceipt

Aufgabe, die Build-Produkte und/oder Laufzeitabhängigkeiten durch Lesen aus *.target-Dateien markiert.


Dateien	FileSpec	Erforderlich	Satz von Quittungsdateien (`*.target`) zum Lesen, einschließlich Platzhaltern und Tag-Namen, getrennt durch Semikolons.
EngineDir	Verzeichnisreferenz	Optional	Pfad zum Engine-Ordner, der zum Erweitern von $(EngineDir)-Eigenschaften in Quittungsdateien verwendet wird. Standardmäßig wird das Engine-Verzeichnis für den aktuellen Arbeitsbereich verwendet.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

SetVersion

Aktualisiert die lokalen Versionsdateien (Engine/Source/Runtime/Launch/Resources/Version.h, Engine/Build/Build.version und Engine/Source/Programs/Shared/Metadata.cs) mit den angegebenen Versionsinformationen.


Ändern	Integer	Erforderlich	Die in den Versionsdateien festzulegende Änderungsliste.
KompatibelÄndern	Integer	Optional	Die Engine-kompatible Änderungsliste, die in den Versionsdateien festgelegt werden soll.
Verzweigung	String	Erforderlich	Die Verzweigungszeichenfolge.
Build	String	Optional	Die Build-Versionszeichenfolge.
BuildURL	String	Optional	Die URL für einen laufenden Continuous Integration-Job.
Lizenznehmer	boolesch	Optional	Ob das Flag IS_LICENSEE_VERSION auf „true“ gesetzt werden soll.
Gefördert	boolesch	Optional	Ob das Flag ENGINE_IS_PROMOTED_BUILD auf „true“ gesetzt werden soll.
ÜberspringenSchreiben	boolesch	Optional	Wenn festgelegt, wird nicht in die Dateien geschrieben – geben Sie einfach die Versionsdateien zurück, die aktualisiert werden sollen. Nützlich für lokale Builds.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Zeichen

Signiert eine Reihe ausführbarer Dateien mit einem installierten Zertifikat.


Dateien	FileSpec	Erforderlich	Liste der durch Semikolons getrennten Dateispezifikationen (z. B. `.cpp;Engine/.../.bat`) oder der Name eines Tag-Sets.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Spawnen

Erzeugt eine externe ausführbare Datei und wartet auf deren Abschluss.


Exe	String	Erforderlich	Ausführbare Datei zum Erstellen.
Argumente	String	Optional	Argumente für den neu erstellten Prozess.
Arbeitsverzeichnis	String	Optional	Arbeitsverzeichnis zum Erstellen der neuen Aufgabe
Umgebung	String	Optional	Zu setzende Umgebungsvariablen
Umgebungsdatei	String	Optional	Datei zum Lesen der Umgebung
Protokoll-Outputs	boolesch	Optional	Output in das Protokoll schreiben
Fehlerebene	Integer	Optional	Der minimale Exitcode, der als Fehler behandelt wird.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Phase

Leitet die in einer Build-Bestätigung aufgeführten Dateien in ein Outputverzeichnis weiter.


Project	Dateireferenz	Optional	Das Projekt, zu dem dieses Ziel gehört.
Ziel	String	Erforderlich	Name des zu inszenierenden Ziels.
Plattform	UnrealTargetPlatform	Erforderlich	Von der Plattform zur Bühne.
Konfiguration	UnrealTargetConfiguration	Erforderlich	Zu inszenierende Konfiguration.
Architektur	String	Optional	Architektur zum Inszenieren.
ToDir	Verzeichnisreferenz	Erforderlich	Verzeichnis, in dem die Belegdateien bereitgestellt werden sollen.
Überschreiben	boolesch	Optional	Ob vorhandene Dateien überschrieben werden sollen.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Zerlegen

Entfernt Debuginformationen aus einer Reihe von Dateien.


Plattform	UnrealTargetPlatform	Erforderlich	Die Plattform-Toolchain zum Entfernen von Binärdateien.
Basisverzeichnis	Verzeichnisreferenz	Optional	Das Verzeichnis, in dem Dateien gesucht werden sollen.
Dateien	FileSpec	Erforderlich	Liste der durch Semikolons getrennten Dateispezifikationen (z. B. `Engine/.../*.pdb`) oder der Name eines Tag-Sets.
Outputverzeichnis	Verzeichnisreferenz	Optional	Outputverzeichnis für die entfernten Dateien. Standardmäßig wird der Inputpfad verwendet, wobei die Inputdateien überschrieben werden.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Übermitteln

Erstellt eine neue Änderungsliste und übermittelt einen Satz von Dateien an einen Perforce-Stream.


Beschreibung	String	Erforderlich	Die Beschreibung für die übermittelte Änderungsliste.
Dateien	FileSpec	Erforderlich	Die zu übermittelnden Dateien.
FileType	String	Optional	Der Perforce-Dateityp für die übermittelten Dateien (z. B. binär+FS32).
Arbeitsbereich	String	Optional	Der Name des Arbeitsbereichs. Falls angegeben, wird ein neuer Arbeitsbereich mit dem angegebenen Stream und Stammverzeichnis erstellt, um die Dateien zu übermitteln. Wenn nicht, wird der aktuelle Arbeitsbereich verwendet.
Stream	String	Optional	Der Stream für den Arbeitsbereich – standardmäßig der aktuelle Stream. Wird ignoriert, sofern das Workspace-Attribut nicht ebenfalls angegeben ist.
Verzweigung	String	Optional	Zweig für den Arbeitsbereich (alter P4-Depotpfad). Darf nicht in Verbindung mit Stream verwendet werden.
Stammverzeichnis	Verzeichnisreferenz	Optional	Stammverzeichnis für den Stream. Wenn nicht angegeben, wird standardmäßig das aktuelle Stammverzeichnis verwendet.
Unverändert zurücksetzen	boolesch	Optional	Ob unveränderte Dateien vor dem Übermittlungsversuch wiederhergestellt werden sollen.
Erzwingen	boolesch	Optional	Erzwingen Sie die Übermittlung – auch wenn eine Lösung erforderlich ist (immer die aktuelle Version akzeptieren).
P4Verbose	boolesch	Optional	Ausführliche P4-Output zulassen (spew).
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

SymGen

Generiert eine portable Symbol-Dump-Datei aus den angegebenen Binärdateien.


Dateien	FileSpec	Erforderlich	Liste der durch Semikolons getrennten Dateispezifikationen (z. B. .cpp;Engine/.../.bat) oder der Name eines Tag-Sets.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
UseRadSym	boolesch	Optional	Wenn festgelegt, wird der PDB-Symbol-Dumper des Rad-Debuggers sowie der Rad-Symbol_Path_Fixer verwendet.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

SymStore

Aufgabe, die Symbole aus einer Reihe von Dateien entfernt.


Plattform	UnrealTargetPlatform	Erforderlich	Die Plattform-Toolchain, die zum Verarbeiten von Symboldateien erforderlich ist.
Dateien	String	Erforderlich	Liste der Outputdateien. PDBs werden aus dieser Liste extrahiert.
StoreDir	String	Erforderlich	Outputverzeichnis für die komprimierten Symbole.
Produkt	String	Erforderlich	Name des Produkts für die Symbolspeicherdatensätze.
Verzweigung	String	Optional	Name des Zweigs, auf dem alle Depot-Quelldateien basieren. Wird verwendet, wenn IndexSources True ist (kann nur auf einigen Plattformen verwendet werden).
Ändern	Integer	Optional	Änderungsliste, mit der alle Depot-Quelldateien synchronisiert wurden. Wird verwendet, wenn IndexSources True ist (kann nur auf einigen Plattformen verwendet werden).
BuildVersion	String	Optional	Mit diesen Symbolen verknüpfte BuildVersion. Wird zur Bereinigung in AgeStore verwendet, indem diese Version mit einem Verzeichnisnamen in einer Build-Freigabe abgeglichen wird.
IndexQuellen	boolesch	Optional	Ob der Quellcodeindex in die hochgeladenen Symbole aufgenommen werden soll. Wenn diese Option aktiviert ist, generiert die Aufgabe die von einem Quellserver benötigten Daten (es werden nur einige Plattformen und Quellcodeverwaltungsserver unterstützt). Der Quellserver ermöglicht es Debuggern, beim Debuggen von Builds oder Analysieren von Dumps automatisch den passenden Quellcode abzurufen.
Quelldateien	String	Optional	Filter für die Depotquelldateien, die indiziert werden sollen. Es handelt sich um eine durch Semikolon getrennte Liste von Perforce-Filtern, z. B. Motor/....cpp;Motor/....h. Es kann sich auch um den Namen eines zuvor definierten Tags handeln, z. B. "#SourceFiles Wird verwendet, wenn IndexSources True ist (kann nur auf einigen Plattformen verwendet werden).
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Tag

Wendet ein Tag auf einen bestimmten Satz von Dateien an. Die Liste der Dateien wird durch Aufzählen der Tags und Dateispezifikationen ermittelt, die durch den Parameter „Dateien“ angegeben werden. Aus dieser Liste werden alle Dateien entfernt, die nicht mit dem Parameter „Filter“ übereinstimmen, gefolgt von allen Dateien, die mit dem Parameter „Except“ übereinstimmen.


Basisverzeichnis	Verzeichnisreferenz	Optional	Legen Sie das Basisverzeichnis fest, anhand dessen relative Pfade und Muster aufgelöst werden sollen. Wenn festgelegt, werden alle absoluten Muster (z. B. /Engine/Build/...) als relativ zu diesem Pfad betrachtet. Wenn nicht, werden sie als wirklich absolut angesehen.
Dateien	FileSpec	Optional	Satz von Dateien, mit denen gearbeitet werden soll, einschließlich Platzhaltern und Tag-Namen, durch Semikolons getrennt. Wenn festgelegt, wird die Auflösung relativ zu BaseDir vorgenommen, andernfalls erfolgt die Auflösung zum Stammverzeichnis des Zweigs.
Dateilisten	FileSpec	Optional	Satz von Textdateien, aus denen zusätzliche Dateien hinzugefügt werden können. Jede Dateiliste sollte eine Datei pro Zeile enthalten.
Filter	FileSpec	Optional	Muster zum Filtern der Dateiliste, einschließlich Tag-Namen oder Platzhaltern. Wenn festgelegt, können Muster enthalten sein, die für das Basisverzeichnis gelten. Wenn nicht angegeben, werden standardmäßig alle Dateien verwendet.
Außer	FileSpec	Optional	Satz von Mustern, die aus der Übereinstimmungsliste ausgeschlossen werden sollen. Kann Tag-Namen von Mustern enthalten, die für das Basisverzeichnis gelten.
Mit	TagList	Erforderlich	Name des anzuwendenden Tags.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

TagReceipt

Aufgabe, die Build-Produkte und/oder Laufzeitabhängigkeiten durch Lesen aus *.target-Dateien markiert.


Dateien	FileSpec	Erforderlich	Satz von Quittungsdateien (*.target) zum Lesen, einschließlich Platzhaltern und Tag-Namen, durch Semikolon getrennt.
EngineDir	Verzeichnisreferenz	Optional	Pfad zum Engine-Ordner, der zum Erweitern von $(EngineDir)-Eigenschaften in Quittungsdateien verwendet wird. Standardmäßig wird das Engine-Verzeichnis für den aktuellen Arbeitsbereich verwendet.
Projektverzeichnis	Verzeichnisreferenz	Optional	Pfad zum Projektordner, der zum Erweitern der $(ProjectDir)-Eigenschaften in Belegdateien verwendet wird. Standardmäßig das Engine-Verzeichnis für den aktuellen Arbeitsbereich – VERALTET.
BuildProducts	boolesch	Optional	Ob die in den Quittungen aufgeführten Build-Produkte markiert werden sollen.
BuildProductType	String	Optional	Welche Art von Build-Produkten markiert werden soll (gültige Werte finden Sie unter TargetReceipt.cs – UnrealBuildTool.BuildProductType).
Laufzeitabhängigkeiten	boolesch	Optional	Ob die in den Quittungen aufgeführten Laufzeitabhängigkeiten markiert werden sollen.
StagedFileType	String	Optional	Welche Art von Laufzeitabhängigkeiten markiert werden sollen (gültige Werte finden Sie unter TargetReceipt.cs – UnrealBuildTool.StagedFileType).
Mit	TagList	Erforderlich	Name des anzuwendenden Tags.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Entpacken

Extrahieren Sie Dateien aus einem ZIP-Archiv.


ZipFile	FileSpec	Erforderlich	Pfad zur zu extrahierenden ZIP-Datei.
ToDir	Verzeichnisreferenz	Erforderlich	Outputverzeichnis für die extrahierten Dateien.
UseLegacyUnzip	boolesch	Optional	Ob der alte Entzip-Code verwendet werden soll oder nicht.
Dateien überschreiben	boolesch	Optional	Ob Dateien beim Entpacken überschrieben werden sollen oder nicht.
Tag	TagList	Optional	Auf die extrahierten Dateien anzuwendendes Tag.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Hochladen

Lädt eine Reihe von Dateien zum späteren Abrufen auf Jupiter hoch


FromDir	Verzeichnisreferenz	Erforderlich	Das Verzeichnis, aus dem komprimierte Dateien gelesen werden sollen.
Dateien	FileSpec	Optional	Liste der durch Semikolons getrennten Dateispezifikationen (z. B. `.cpp;Engine/.../.bat`) oder der Name eines Tag-Sets. Relative Pfade werden aus FromDir übernommen.
JupiterNamespace	String	Erforderlich	Der zum Hochladen des Builds verwendete Jupiter-Namespace. Wird verwendet, um zu steuern, wer Zugriff auf den Build hat.
JupiterKey	String	Erforderlich	Der Schlüssel des Builds wird verwendet, um den Build erneut herunterzuladen. Dies muss für diesen bestimmten Upload global eindeutig sein.
Archivtyp	String	Erforderlich	Der Archivtyp, aus dem diese Dateien stammen, wird den Metadaten hinzugefügt
Projektname	String	Erforderlich	Der Name des Projekts, mit dem dieser Satz von Dateien verknüpft ist, wird den Metadaten hinzugefügt
Verzweigung	String	Erforderlich	Der Quellcodeverwaltungszweig, aus dem diese Dateien generiert wurden, wird den Metadaten hinzugefügt
Changelist	String	Erforderlich	Die Version der Quellcodeverwaltung, aus der diese Dateien generiert wurden, wird den Metadaten hinzugefügt.
JupiterUrl	String	Erforderlich	Geben Sie die URL der Jupiter-Instanz an, in die hochgeladen werden soll.
Zusätzliche Metadaten	String	Optional	Durch Semikolon getrennte Liste von durch '=' getrennten Schlüsselwertzuordnungen, die den Metadaten hinzugefügt werden sollen. z. B. Foo=Bar;Spam=Eier
Speichernutzung begrenzen	boolesch	Optional	Wenn aktiviert, wird der Dateiinhalt nicht im Speicher behalten. Dies führt zu einer geringeren Speichernutzung, aber zu einer erhöhten E/A, da der Dateiinhalt mehrmals gelesen werden muss (sowohl für das Hashing als auch beim Hochladen).
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Wait

Wartet eine definierte Anzahl von Sekunden.


Seconds	Integer	Erforderlich	Anzahl der zu wartenden Sekunden.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

WriteJsonValue

Ändert JSON-Dateien durch Festlegen eines im Schlüsselpfad angegebenen Werts


Datei	FileSpec	Erforderlich	JSON-Datei(en), die geändert werden
Schlüssel	String	Erforderlich	In jeder Datei festzulegendes JSON-Element. Die Syntax für diese Zeichenfolge ist eine begrenzte Teilmenge der JsonPath-Notation und unterstützt möglicherweise Objekteigenschaften und Array-Indizes. Alle Array-Indizes, die ausgelassen werden oder außerhalb des gültigen Bereichs liegen, fügen dem Array ein neues Element hinzu (z. B. „$.foo.bar[]“ fügt dem Array „bar“ im Objekt „foo“ ein Element hinzu.)
Wert	String	Erforderlich	Neuer festzulegender Wert. Kann ein beliebiger JSON-Wert sein (Zeichenfolge, Array, Objekt, Zahl, Boolescher Wert oder Null).
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Textdatei schreiben

Schreibt Text in eine Datei.


Datei	Dateireferenz	Erforderlich	Pfad zur zu schreibenden Datei.
Anhängen	boolesch	Optional	Optional, ob an die Datei angehängt oder nicht überschrieben werden soll.
Text	String	Optional	Der in die Datei zu schreibende Text.
Dateien	FileSpec	Optional	Wenn angegeben, wird die angegebene Dateiliste nach der angegebenen Nachricht gedruckt.
Tag	TagList	Optional	Tag, der zum Erstellen von Produkten dieser Aufgabe angewendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

ZenExportSnapshot

Exportiert einen Snapshot von Zen an ein angegebenes Ziel.


Project	Dateireferenz	Optional	Das Projekt, aus dem der Snapshot exportiert werden soll
Plattform	String	Optional	Die Zielplattform(en), für die der Snapshot exportiert werden soll
SnapshotDescriptorFile	Dateireferenz	Optional	Eine zu erstellende Datei mit Informationen zum exportierten Snapshot
Zielspeichertyp	String	Erforderlich	Der Zieltyp, in den der Snapshot exportiert werden soll (Cloud usw.)
DestinationCloudHost	String	Optional	Der Hostname, der beim Exportieren in ein Cloud-Ziel verwendet werden soll
DestinationCloudNamespace	String	Optional	Der Namespace, der beim Exportieren in ein Cloud-Ziel verwendet werden soll
Zielwolkenkennung	String	Optional	Die Kennung, die beim Exportieren in ein Cloud-Ziel verwendet werden soll
ZielCloudBucket	String	Optional	Ein benutzerdefinierter Bucket-Name, der beim Exportieren in ein Cloud-Ziel verwendet werden soll
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

ZenImportOplog

Importiert ein Oplog von Zen in ein angegebenes Ziel.


Importtyp	String	Erforderlich	Der Zieltyp, von dem importiert werden soll (Cloud, Datei usw.).
Dateien	String	Optional	Durch Kommas getrennter vollständiger Pfad zum Oplog-Verzeichnis, das in die lokalen Zen-Server-Dateien „Path1,Path2“ importiert werden soll.
Project	Dateireferenz	Optional	Das Projekt, aus dem importiert werden soll.
Projektname	String	Optional	Der Name des neu erstellten Zen-Projekts, in das wir importieren werden.
Plattform	String	Optional	Die Zielplattform, für die der Snapshot importiert werden soll.
Stammverzeichnis	String	Optional	Stammverzeichnis für das UE-Projekt. Wird verwendet, um den Engine-Ordner und den Projektordner abzuleiten.
OplogName	String	Optional	Der Name des importierten Oplogs.
Hostname	String	Optional	Die Host-URL für den Zen-Server, von dem wir importieren.
HostPort	String	Optional	Der Host-Port für den Zen-Server, von dem wir importieren.
CloudURL	String	Optional	Die Cloud-URL, aus der importiert werden soll.
Namespace	String	Optional	Welcher Namespace beim Importieren aus der Cloud verwendet werden soll.
Eimer	String	Optional	Welcher Bucket beim Importieren aus der Cloud verwendet werden soll.
Schlüssel	String	Optional	Welcher Schlüssel beim Importieren aus der Cloud verwendet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

ZenLaunch

Startet ZenServer.


Project	Dateireferenz	Erforderlich	Das Projekt, für das ZenServer gestartet werden soll.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

ZenMirror

Exportiert einen Snapshot von Zen an ein angegebenes Ziel.


Project	Dateireferenz	Optional	Das Projekt, aus dem der Snapshot exportiert werden soll.
Plattform	String	Optional	Die Zielplattform, für die der Snapshot gespiegelt werden soll.
Zieldateiverzeichnis	Verzeichnisreferenz	Optional	Der Pfad auf der lokalen Festplatte, auf den die Daten gespiegelt werden. Wenn dieser Pfad leer ist, wird er auf das Verzeichnis %Project%\Saved\Cooked\%Platform% gesetzt.
Wenn	Zustand	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.

Zip

Komprimiert Dateien in ein ZIP-Archiv.


FromDir	Verzeichnisreferenz	Erforderlich	Das Verzeichnis, aus dem komprimierte Dateien gelesen werden sollen.
Dateien	FileSpec	Optional	Liste der durch Semikolons getrennten Dateispezifikationen (z. B. `.cpp;Engine/.../.bat`) oder der Name eines Tag-Sets. Relative Pfade werden aus FromDir übernommen.
Ausführbare Dateien	FileSpec	Optional	Liste der Dateien, bei denen ein Ausführungsbit gesetzt sein sollte.
ZipFile	Dateireferenz	Erforderlich	Die zu erstellende ZIP-Datei.
Tag	TagList	Optional	Auf die erstellte ZIP-Datei anzuwendendes Tag.
Wenn	Bedingung	Optional	Ob diese Aufgabe ausgeführt werden soll. Es wird ignoriert, wenn diese Bedingung als False ausgewertet wird.