En règle générale, les scripts d'utilitaires spécifiques aux projets sont implémentés en tant que classes Unreal Automation Tool (UAT) BuildCommand. Il arrive toutefois que vous deviez automatiser des tâches personnalisées pour votre projet. C'est là que BuildGraph peut s'avérer utile, car il vous permet d'ajouter autant de tâches d'automatisation que nécessaire, selon vos besoins spécifiques. La section suivante décrit comment créer des tâches personnalisées à l'aide de BuildGraph. Elle propose notamment une liste de tâches prédéfinies qui vous offrira un bon point de départ pour créer des tâches personnalisées.
Tâches personnalisées
Pour créer une nouvelle tâche personnalisée, implémentez une classe dérivée de la classe CustomTask et appliquez l'attribut TaskElement à celle-ci. Le constructeur TaskElement prend deux arguments : le nom de l'élément XML qu'il représente et le type de classe contenant ses paramètres (qui est transmis au constructeur au moment du chargement).
Si vous souhaitez lire des champs de classe de paramètre à partir d'un fichier XML, associez l'attribut TaskParameter à la tâche. L'attribution de l'attribut TaskParameter permet d'indiquer si un paramètre est requis ou facultatif, tout en définissant les règles de validation supplémentaires à appliquer à l'argument.
Tâches prédéfinies
Si vous souhaitez avoir un point de départ pour créer des tâches, nous mettons à votre disposition un large éventail de tâches prédéfinies qui peuvent servir de modèles sur lesquels vous appuyer. Si vous cherchez une tâche prédéfinie simple pour vous lancer, nous vous recommandons LogTask comme point de départ. Si vous voulez suivre les dernières améliorations de BuildGraph, ajoutez cette page à vos favoris. Cette liste de tâches prédéfinies sera mise à jour régulièrement.
BuildCookRun est une commande puissante et couramment utilisée pour les tâches d'empaquetage. Pour plus d'informations, consultez la présentation consacrée aux opérations de création.
AgeStore
Cette tâche permet de retirer les symboles d'un ensemble de fichiers. Cette tâche tire son nom de l'utilitaire AGESTORE, fourni avec le SDK des outils du débogueur Microsoft, mais il s'agit en réalité d'une implémentation distincte. La différence principale est qu'il utilise l'heure de la dernière modification plutôt que l'heure du dernier accès pour déterminer les fichiers à supprimer.
Plateforme | UnrealTargetPlatform | Requis | Plateforme cible de laquelle retirer les symboles. |
StoreDir | Chaîne | Requis | Répertoire du serveur de symboles. |
Jours | Entier | Requis | Nombre de jours de conservation des symboles. |
BuildDir | Chaîne | Facultatif | Racine du répertoire de build dans laquelle rechercher les répertoires nommés de version de build existants. |
Filtre | Chaîne | Facultatif | Sous-chaîne à associer dans les noms de fichier de répertoire avant la suppression des symboles. Cela permet à la tâche « age store » d'éviter de supprimer les symboles d'autres builds dans le cas où plusieurs builds partagent le même serveur de symboles. L'utilisation spécifique de la valeur de filtre est déterminée par la structure de serveur de symboles définie par la chaîne d'outils de la plateforme. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Aws
Fait apparaître la CLI AWS et attend la fin de l'opération.
Arguments | Chaîne | Facultatif | Arguments du processus nouvellement créé. |
Environnement | Chaîne | Facultatif | Variables d'environnement. |
EnvironmentFile | Chaîne | Facultatif | Fichier à partir duquel lire l'environnement. |
LogOutput | Outil Booléen | Facultatif | Écrit la sortie dans le journal. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Aws-AssumeRole
Assume un rôle AWS.
Arn | Chaîne | Requis | Rôle à assumer. |
Session | Chaîne | Requis | Nom de cette session. |
Durée | Entier | Facultatif | Durée du jeton, en secondes. |
Environnement | Chaîne | Facultatif | Variables d'environnement. |
EnvironmentFile | Chaîne | Facultatif | Fichier à partir duquel lire les variables d'environnement. |
OutputFile | Chaîne | Requis | Fichier de sortie du nouvel environnement. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Aws-EcsDeploy
Crée une nouvelle définition de tâche ECS AWS et met à jour le service ECS afin qu'il utilise cette nouvelle révision de la définition de tâche.
TaskDefinitionFile | Chaîne | Requis | Fichier de définition de tâche à utiliser. |
DockerImage | Chaîne | Requis | Image Docker à définir dans la nouvelle définition de tâche (remplace %%DOCKER_PATTERN%% par cette valeur). |
Version | Chaîne | Facultatif | Version de l'application à définir dans la nouvelle définition de tâche (remplace %%VERSION%% par cette valeur). |
Cluster | Chaîne | Requis | ARN du cluster qui représente le cluster ECS AWS sur lequel opérer. |
Service | Chaîne | Requis | Nom du service à mettre à jour et à déployer. |
Environnement | Chaîne | Facultatif | Variables d'environnement. |
EnvironmentFile | Chaîne | Facultatif | Fichier à partir duquel lire l'environnement. |
LogOutput | Outil Booléen | Facultatif | Écrit la sortie dans le journal. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
CheckMarkdown
Contrôle que tous les liens markdown entre les fichiers donnés sont valides.
.udatasmith | FileSpec | Facultatif | Filtre facultatif à appliquer à la liste des fichiers de commande. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Commande
Invoque un processus enfant AutomationTool qui permet d'exécuter la commande donnée.
Nom | Chaîne | Requis | Nom de la commande à exécuter. |
Arguments | Chaîne | Facultatif | Arguments à transmettre à la commande. |
MergeTelemetryWithPrefix | Chaîne | Facultatif | Si cette chaîne est non nulle, elle indique que la télémétrie de la commande doit être fusionnée avec la télémétrie de cette instance UAT avec le préfixe donné. Peut être une chaîne vide (non nulle). |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Commandlet
Fait apparaître l'éditeur en vue d'exécuter un applet de commande.
Nom | Chaîne | Requis | Nom de l'applet de commande à exécuter. |
Projeter | FileSpec | Facultatif | Projet dans lequel l'éditeur doit être exécuté. |
Arguments | Chaîne | Facultatif | Arguments à transmettre à l'applet de commande. |
EditorExe | FileReference | Facultatif | Exécutable de l'éditeur à utiliser. Définit par défaut l'exécutable de l'UnrealEditor en cours de développement pour la plateforme actuelle. |
ErrorLevel | Entier | Facultatif | Code de sortie minimal, qui est traité comme une erreur. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Compile
Compile une cible avec UnrealBuildTool.
Cible | Chaîne | Facultatif | Cible à compiler. |
Configuration | UnrealTargetConfiguration | Requis | Configuration à compiler. |
Plateforme | UnrealTargetPlatform | Requis | Plateforme pour laquelle effectuer la compilation. |
Projeter | FileSpec | Facultatif | Projet avec lequel effectuer la compilation. |
Arguments | Chaîne | Facultatif | Arguments supplémentaires pour UnrealBuildTool. |
AllowGEX | Outil Booléen | Facultatif | Détermine s'il convient d'autoriser l'utilisation de XGE pour la compilation. |
AllowParallelExecutor | Outil Booléen | Facultatif | Détermine s'il convient d'autoriser l'utilisation de l'exécuteur parallèle pour cette compilation. |
AllowAllCores | Outil Booléen | Facultatif | Détermine s'il convient d'autoriser UBT pour utiliser tous les cœurs disponibles lorsque AllowXGE est désactivé. |
Clean | Outil Booléen | Facultatif | Détermine s'il convient d'autoriser le nettoyage de cette cible. Si ce paramètre n'est pas spécifié, les cibles sont nettoyées lorsque l'argument -Clean est transmis dans la ligne de commande. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Préparation
Prépare une sélection de cartes pour une plateforme spécifique
Projeter | Chaîne | Requis | Fichier de projet à préparer. |
Plateforme | Chaîne | Requis | Plateforme de préparation à cibler (par exemple, Windows). |
Cartes | Chaîne | Facultatif | Liste des cartes à préparer, séparées par les caractères « + ». |
Versioned | Outil Booléen | Facultatif | Arguments supplémentaires à transmettre à l'outil de préparation. |
Arguments | Chaîne | Facultatif | Arguments supplémentaires à transmettre à l'outil de préparation. |
EditorExe | Chaîne | Facultatif | Chemin facultatif vers l'exécutable de l'éditeur à lancer pour la préparation. |
TagOutput | Outil Booléen | Facultatif | Détermine s'il convient de baliser le résultat de la préparation. Étant donné que les préparations produisent un grand nombre de fichiers, il peut être contre-productif de passer du temps à les baliser si cela n'est pas nécessaire dans un nœud dépendant. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Copier
Copie les fichiers d'un répertoire à un autre.
.udatasmith | FileSpec | Facultatif | Filtre facultatif à appliquer à la liste des fichiers de commande. |
From | FileSpec | Requis | Le ou les modèles à copier (par exemple, Engine/*.txt). |
To | FileSpec | Requis | Répertoire sur lequel effectuer la copie. |
Overwrite | Outil Booléen | Facultatif | Détermine s'il convient d'écraser les fichiers existants. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
ErrorIfNotFound | Outil Booléen | Facultatif | Détermine s'il convient de générer une erreur si aucun fichier à copier n'a été trouvé. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
CreateArtifact
Importe un artefact vers Horde.
Nom | Chaîne | Requis | Nom de l'artefact. |
Type | Chaîne | Requis | Type d'artefact. Détermine les autorisations et la politique d'expiration de l'artefact. |
Description | Chaîne | Facultatif | Description de l'artefact. Cette option s'affiche dans le tableau Horde. |
BaseDir | Chaîne | Facultatif | Chemin d'accès de base des fichiers mis en ligne. Tous les fichiers balisés doivent se trouver dans ce répertoire. Par défaut, il s'agit du répertoire racine de l'espace de travail. |
StreamId | Chaîne | Facultatif | Flux contenant l'artefact. |
Commit | Chaîne | Facultatif | Validation pour l'artefact mis en ligne. |
.udatasmith | FileSpec | Requis | Fichiers à inclure dans l'artefact. |
Keys | Chaîne | Facultatif | Clés pouvant être interrogées pour cet artefact, séparées par des points-virgules. |
Métadonnées | Chaîne | Facultatif | Autres métadonnées de l'artefact, séparées par des points-virgules. |
Symbols | Outil Booléen | Facultatif | Détermine s'il convient d'ajouter des alias pour les fichiers de symboles. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
CsCompile
Compile les fichiers de projet C# et leurs dépendances.
Projeter | Chaîne | Requis | Fichier de projet C# à compiler. Il est possible de spécifier plusieurs fichiers de projet à l'aide de points-virgules. |
Configuration | Chaîne | Facultatif | Configuration à compiler. |
Plateforme | Chaîne | Facultatif | Plateforme à compiler. |
Cible | Chaîne | Facultatif | Cible à générer. |
Propriétés | Chaîne | Facultatif | Propriétés de la commande |
Arguments | Chaîne | Facultatif | Options supplémentaires à transmettre au compilateur. |
EnumerateOnly | Outil Booléen | Facultatif | Énumère uniquement les produits de build ; ne compile pas les projets. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
TagReferences | TagList | Facultatif | Balise à appliquer à toutes les références non privées que comportent les projets (par exemple, celles qui sont externes et qui ne sont pas copiées dans le répertoire de sortie). |
UseSystemCompiler | Outil Booléen | Facultatif | Détermine s'il convient d'utiliser la chaîne d'outils du système plutôt que le SDK de l'UE empaqueté. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Delete
Supprime un ensemble de fichiers.
.udatasmith | FileSpec | Facultatif | Liste de spécifications de fichier séparées par des points-virgules (par exemple, |
Directories | Chaîne | Facultatif | Liste des noms de répertoire |
DeleteEmptyDirectories | Outil Booléen | Facultatif | Détermine s'il convient de supprimer les répertoires vides après la suppression des fichiers. Ce paramètre est par défaut défini sur True. |
Verbose | Outil Booléen | Facultatif | Détermine s'il convient d'utiliser la journalisation détaillée. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
DeployTool
Déploie une mise à jour de l'outil via Horde.
Id | Chaîne | Requis | Identificateur de l'outil. |
Settings | Chaîne | Requis | Fichier de paramètres à utiliser pour le déploiement. Il doit s'agir d'un fichier JSON contenant le nom du serveur et le jeton d'accès. |
Version | Chaîne | Requis | Numéro de version du nouvel outil |
Durée | Entier | Facultatif | Durée de déploiement de l'outil, en minutes. |
Paused | Outil Booléen | Facultatif | Détermine s'il convient de créer le déploiement en pause. |
Fichier | Chaîne | Facultatif | Fichier .zip contenant les fichiers à importer. |
Dossier | Chaîne | Facultatif | Répertoire pour sauvegarder l'outil. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Docker
Fait apparaître Docker et attend la fin de l'opération.
Arguments | Chaîne | Requis | Arguments de ligne de commande Docker. |
Environnement | Chaîne | Facultatif | Variables d'environnement à définir. |
EnvironmentFile | Chaîne | Facultatif | Fichier à partir duquel lire les variables d'environnement. |
WorkingDir | Chaîne | Facultatif | Répertoire de base pour l'exécution de la commande. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Docker-Build
Fait apparaître Docker et attend la fin de l'opération.
BaseDir | Chaîne | Requis | Répertoire de base du build. |
.udatasmith | Chaîne | Requis | Fichiers à mettre à disposition avant la création de l'image. |
DockerFile | Chaîne | Facultatif | Chemin d'accès au fichier Docker. Utilise la racine de basedir s'il n'est pas spécifié. |
DockerIgnoreFile | Chaîne | Facultatif | Chemin d'accès vers un .dockerignore. Est copié dans le répertoire de base s'il est spécifié. |
UseBuildKit | Outil Booléen | Facultatif | Utilise BuildKit dans Docker. |
ProgressOutput | Chaîne | Facultatif | Type de sortie de progression (--progress). |
Tag | Chaîne | Facultatif | Balise de l'image. |
Arguments | Chaîne | Facultatif | Arguments facultatifs. |
OverlayDirs | Chaîne | Facultatif | Liste des répertoires supplémentaires à superposer dans les fichiers de commande mis à disposition. Permet de mettre à disposition les informations d'identification, etc. |
Environnement | Chaîne | Facultatif | Variables d'environnement à définir. |
EnvironmentFile | Chaîne | Facultatif | Fichier à partir duquel lire les variables d'environnement. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Docker-Compose-Down
Fait apparaître Docker et attend la fin de l'opération.
Fichier | Chaîne | Requis | Chemin d'accès au fichier docker-compose. |
Arguments | Chaîne | Facultatif | Arguments de la commande. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Docker-Compose-Up
Fait apparaître Docker et attend la fin de l'opération.
Fichier | Chaîne | Requis | Chemin d'accès au fichier docker-compose. |
Arguments | Chaîne | Facultatif | Arguments de la commande. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Docker-Push
Fait apparaître Docker et attend la fin de l'opération.
Repository | Chaîne | Requis | Repository |
Image | Chaîne | Requis | Image source à envoyer. |
TargetImage | Chaîne | Facultatif | Nom de l'image cible. |
Environnement | Chaîne | Facultatif | Variables d'environnement supplémentaires. |
EnvironmentFile | Chaîne | Facultatif | Fichier à partir duquel lire l'environnement. |
AwsEcr | Outil Booléen | Facultatif | Détermine s'il convient de se connecter à AWS ECR. |
RepositoryAuthFile | Chaîne | Facultatif | Chemin d'accès à un fichier JSON pour l'authentification auprès du référentiel à des fins d'envoi. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
DotNet
Fait apparaître Docker et attend la fin de l'opération.
Arguments | Chaîne | Facultatif | Arguments de ligne de commande Docker. |
BaseDir | Chaîne | Facultatif | Répertoire de base pour l'exécution de la commande. |
Environnement | Chaîne | Facultatif | Variables d'environnement à définir. |
EnvironmentFile | Chaîne | Facultatif | Fichier à partir duquel lire les variables d'environnement. |
ErrorLevel | Entier | Facultatif | Code de sortie minimal, qui est traité comme une erreur. |
DotNetPath | FileReference | Facultatif | Chemin d'accès de remplacement vers l'exécutable dotnet. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
FindModifiedFiles
Compile les fichiers de projet C# et leurs dépendances.
Chemin | FileSpec | Facultatif | Liste de spécifications de fichier séparées par un point-virgule (par défaut is …). |
Change | Entier | Facultatif | Configuration à compiler. |
MinChange | Entier | Facultatif | Configuration à compiler. |
MaxChange | Entier | Facultatif | Configuration à compiler. |
Sortie | FileReference | Facultatif | Fichier dans lequel écrire. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Git
Fait apparaître Git et attend la fin de l'opération.
Arguments | Chaîne | Facultatif | Arguments de ligne de commande Git. |
BaseDir | Chaîne | Facultatif | Répertoire de base pour l'exécution de la commande. |
ErrorLevel | Entier | Facultatif | Code de sortie minimal, qui est traité comme une erreur. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Git-Clone
Clone un référentiel Git dans un chemin local.
Dir | Chaîne | Requis | Répertoire du référentiel. |
Remote | Chaîne | Facultatif | Exécuteur distant à ajouter. |
Branch | Chaîne | Requis | Branche à extraire sur l'exécuteur distant. |
ConfigFile | Chaîne | Facultatif | Fichier de configuration du référentiel. Il permet de configurer un exécuteur distant en vue de le récupérer et/ou de fournir des informations d'identification. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Helm
Fait apparaître Helm et attend la fin de l'opération.
Chart | Chaîne | Requis | Arguments de ligne de commande Helm. |
Deployment | Chaîne | Requis | Nom de la version. |
Namespace | Chaîne | Facultatif | Espace de noms Kubernetes. |
KubeContext | Chaîne | Facultatif | Contexte kubectl. |
KubeConfig | Chaîne | Facultatif | Fichier de configuration kubectl à utiliser. |
Values | Chaîne | Facultatif | Valeurs à définir pour l'exécution du graphique. |
ValuesFile | Chaîne | Facultatif | Valeurs à définir pour l'exécution du graphique. |
Environnement | Chaîne | Facultatif | Variables d'environnement à définir. |
EnvironmentFile | Chaîne | Facultatif | Fichier à partir duquel analyser les variables d'environnement. |
Arguments | Chaîne | Facultatif | Arguments supplémentaires. |
WorkingDir | Chaîne | Facultatif | Répertoire de base pour l'exécution de la commande. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Horde-CreateReport
Crée un fichier de rapport Horde, qui s'affiche sur le tableau de bord avec tous les travaux qui exécutent cette tâche.
Nom | Chaîne | Requis | Nom du rapport. |
Portée | Chaîne | Requis | Emplacement d'affichage du rapport. |
Placement | Chaîne | Requis | Emplacement d'affichage du rapport. |
Text | Chaîne | Requis | Texte à afficher. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Horde-GetSecrets
Remplace les chaînes dans un fichier texte par les clés secrètes envoyées par Horde.
Fichier | Chaîne | Requis | Fichier à mettre à jour avec les clés secrètes. |
Text | Chaîne | Facultatif | Texte à mettre à jour avec les clés secrètes. |
Replace | Chaîne | Facultatif | Paires de chaînes et noms secrets à développer dans le fichier texte, sous la forme SOURCE_TEXT=secret-name;SOURCE_TEXT_2=secret-name-2. Si ces paires ne sont pas spécifiées, les clés secrètes intégrées dans le texte seront développées à partir des chaînes {{secret-name.value}} . |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Horde-SetSecretEnvVar
Remplace les chaînes dans un fichier texte par les clés secrètes envoyées par Horde.
Nom | Chaîne | Requis | Nom de la variable d'environnement à définir. |
Secret | Chaîne | Requis | Nom de la clé secrète à récupérer. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Kubectl
Fait apparaître Kubectl et attend la fin de l'opération.
Arguments | Chaîne | Requis | Arguments de ligne de commande. |
BaseDir | Chaîne | Facultatif | Répertoire de base pour l'exécution de la commande. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Journal
Consigne un message (et d'autres informations de diagnostic facultatives) dans le journal de sortie.
Message | Chaîne | Facultatif | Message à consigner. |
.udatasmith | FileSpec | Facultatif | Si ce paramètre est spécifié, la liste de fichiers est consignée après le message donné. |
IncludeContents | Outil Booléen | Facultatif | Si ce paramètre est spécifié, le contenu des fichiers spécifiés est consigné. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
ModifyConfig
Modifie un fichier de configuration.
Fichier | FileSpec | Requis | Chemin d'accès au fichier de configuration. |
Section | Chaîne | Requis | Nom de la section à modifier. |
Clé | Chaîne | Requis | Nom de la propriété à définir. |
Valeur | Chaîne | Requis | Valeur de la propriété à définir. |
Tag | TagList | Facultatif | Balise à appliquer aux fichiers extraits. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
ModifyJsonValue
Modifie les fichiers JSON en définissant une valeur spécifiée dans le chemin d'accès de la clé.
.udatasmith | FileSpec | Requis | Chemins d'accès au fichier JSON, qui seront modifiés. |
KeyPath | Chaîne | Requis | Chemin d'accès à la clé JSON à rechercher dans chaque fichier. |
NewValue | Entier | Requis | Nouvelle valeur à appliquer. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Move
Déplace les fichiers d'un répertoire vers un autre.
.udatasmith | FileSpec | Facultatif | Filtre facultatif à appliquer à la liste des fichiers de commande. |
From | FileSpec | Requis | Le ou les modèles à copier (par exemple, Engine/*.txt). |
To | FileSpec | Requis | Répertoire sur lequel effectuer la copie. |
Overwrite | Outil Booléen | Facultatif | Facultatif si les fichiers doivent être écrasés ; la valeur par défaut est false. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
ErrorIfNotFound | Outil Booléen | Facultatif | Détermine s'il convient de générer une erreur si aucun fichier à copier n'a été trouvé. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
MsBuild
Exécute MsBuild.
Projeter | Chaîne | Requis | Fichier de projet C# à compiler. Il est possible de spécifier plusieurs fichiers de projet à l'aide de points-virgules. |
Configuration | Chaîne | Facultatif | Configuration à compiler. |
Plateforme | Chaîne | Facultatif | Plateforme à compiler. |
Arguments | Chaîne | Facultatif | Options supplémentaires à transmettre au compilateur. |
Verbosity | Chaîne | Facultatif | Verbosité de sortie de MSBuild. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
NuGet-LicenseCheck
Fait apparaître Docker et attend la fin de l'opération.
BaseDir | Chaîne | Requis | Répertoire de base pour l'exécution de la commande. |
IgnorePackages | Chaîne | Facultatif | Spécifie une liste de paquets à ignorer pour les contrôles de version, séparés par des points-virgules. Il est possible que le numéro de version facultatif soit spécifié avec la syntaxe « nom@version ». |
LicenseDir | DirectoryReference | Facultatif | Répertoire contenant les licences autorisées. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
OnExit
Génère un exécutable externe et attend la fin de l'opération.
Commande | Chaîne | Requis | Exécutable à faire apparaître. |
Lease | Outil Booléen | Facultatif | Détermine s'il convient de lancer l'exécution à la fin du bail. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
PakFile
Crée un fichier PAK à partir d'un ensemble de fichiers donné.
.udatasmith | FileSpec | Requis | Liste des fichiers, caractères génériques et ensembles de balises à ajouter au fichier PAK, séparés par des points-virgules (;). |
Sortie | FileReference | Requis | Fichier PAK à générer. |
ResponseFile | FileReference | Facultatif | Chemin d'accès à un fichier de réponse contenant une liste de fichiers à ajouter au fichier PAK (au lieu de les spécifier individuellement). |
RebaseDir | DirectoryList | Facultatif | Répertoires à utiliser pour rebaser les fichiers. Si ce paramètre est spécifié, le chemin le plus court d'un répertoire listé est utilisé pour chaque fichier. |
Ordre | FileReference | Facultatif | Script qui indique l'ordre des fichiers. |
Sign | FileReference | Facultatif | Clés de chiffrement pour ce fichier .pak. |
Compress | Outil Booléen | Facultatif | Indique s'il convient de compresser les fichiers. |
Arguments | Chaîne | Facultatif | Arguments supplémentaires à transmettre à UnrealPak. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
QueryTargets
Exécute UBT pour interroger toutes les cibles d'un projet donné.
ProjectFile | FileReference | Facultatif | Chemin d'accès au fichier de projet à interroger. |
OutputFile | FileReference | Facultatif | Chemin d'accès au fichier de sortie destiné à recevoir des informations sur les cibles. |
IncludeAllTargets | Outil Booléen | Facultatif | Écrase toutes les cibles, même si une valeur par défaut est spécifiée dans la section BuildSettings des fichiers Default*.ini . |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
RandomData
Crée des fichiers contenant des données aléatoires dans le répertoire de sortie spécifié. Sert à générer des données de test pour le système de stockage temporaire.
Taille | Entier | Facultatif | La taille de chaque fichier. |
Count | Entier | Facultatif | Nombre de fichiers à écrire. |
Different | Outil Booléen | Facultatif | Détermine s'il convient de générer des données différentes pour chaque fichier de sortie. |
OutputDir | Chaîne | Facultatif | Répertoire de sortie. |
Tag | Chaîne | Facultatif | Filtre facultatif à appliquer à la liste des fichiers de commande. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Reconcile
Crée une nouvelle liste de modifications et réconcilie un ensemble de fichiers à soumettre à un flux Perforce.
Description | Chaîne | Requis | Description de la liste de modifications envoyée. |
.udatasmith | FileSpec | Facultatif | Fichiers à réconcilier. |
Directories | Chaîne | Facultatif | Répertoires à réconcilier, délimités par des points-virgules, avec la syntaxe p4 relative. |
Workspace | Chaîne | Facultatif | Nom de l'espace de travail. Si ce paramètre est spécifié, un nouvel espace de travail est créé avec le flux et le répertoire racine spécifiés pour envoyer les fichiers. Dans le cas contraire, l'espace de travail actuel est utilisé. |
Stream | Chaîne | Facultatif | Flux de l'espace de travail, qui est par défaut défini sur le flux actuel. Ignoré, sauf si l'attribut Workspace est également spécifié. |
Branch | Chaîne | Facultatif | Branche de l'espace de travail (chemin d'accès au dépôt P4 hérité). Ne peut pas être utilisé en conjonction avec Stream. |
RootDir | DirectoryReference | Facultatif | Répertoire racine du flux. Si ce paramètre n'est pas spécifié, le répertoire racine actuel est utilisé par défaut. |
Force | Outil Booléen | Facultatif | Force l'envoi, même si une résolution est nécessaire (toujours accepter la version actuelle). |
P4Verbose | Outil Booléen | Facultatif | Autorise la sortie P4 détaillée (spew). |
Preview | Outil Booléen | Requis | Exécute un aperçu de réconciliation, mais ne l'envoie pas. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Rename
Permet de renommer un fichier ou un groupe de fichiers.
.udatasmith | FileSpec | Requis | Le ou les fichiers à renommer. |
From | Chaîne | Facultatif | Nom de fichier actuel ou modèle à respecter (par exemple, *.txt). Ne doit pas inclure de séparateurs de chemin. |
To | Chaîne | Requis | Nouveau nom pour le ou les fichiers. Ne doit pas inclure de séparateurs de chemin. |
Tag | TagList | Facultatif | Balise à appliquer aux fichiers renommés. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
SanitizeReceipt
Tâche qui balise les produits de build et/ou les dépendances d'exécution en lisant les fichiers *.target.
.udatasmith | FileSpec | Requis | Ensemble de fichiers de réception ( |
EngineDir | DirectoryReference | Facultatif | Chemin d'accès au dossier du moteur, utilisé pour développer les propriétés $(EngineDir) dans les fichiers de réception. Détermine par défaut le répertoire du moteur pour l'espace de travail actuel. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
SetVersion
Met à jour les fichiers de version locale (Engine/Source/Runtime/Launch/Resources/Version.h, Engine/Build/Build.version et Engine/Source/Programs/Shared/Metadata.cs) avec les informations de version fournies.
Change | Entier | Requis | Liste des modifications à définir dans les fichiers de version. |
CompatibleChange | Entier | Facultatif | Liste des modifications compatible avec le moteur à définir dans les fichiers de version. |
Branch | Chaîne | Requis | Chaîne de la branche. |
Mise en place | Chaîne | Facultatif | Chaîne de version de build. |
BuildURL | Chaîne | Facultatif | URL d'une tâche d'intégration continue en cours d'exécution. |
Licensee | Outil Booléen | Facultatif | Détermine s'il convient de définir l'indicateur IS_LICENSEE_VERSION sur true. |
Promoted | Outil Booléen | Facultatif | Détermine s'il convient de définir l'indicateur ENGINE_IS_PROMOTED_BUILD sur true. |
SkipWrite | Outil Booléen | Facultatif | Si ce paramètre est défini, les fichiers ne sont pas écrits, mais renvoient uniquement les fichiers de version qui doivent être mis à jour. Utile pour les builds locaux. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Sign
Signe un ensemble de fichiers exécutables avec un certificat installé.
.udatasmith | FileSpec | Requis | Liste de spécifications de fichier séparées par des points-virgules (par exemple, |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Faire apparaître
Génère un exécutable externe et attend la fin de l'opération.
Exe | Chaîne | Requis | Exécutable à faire apparaître. |
Arguments | Chaîne | Facultatif | Arguments du processus nouvellement créé. |
WorkingDir | Chaîne | Facultatif | Répertoire de travail pour l'apparition de la nouvelle tâche. |
Environnement | Chaîne | Facultatif | Variables d'environnement à définir. |
EnvironmentFile | Chaîne | Facultatif | Fichier à partir duquel lire l'environnement. |
LogOutput | Outil Booléen | Facultatif | Résultat de l'écriture sur le journal. |
ErrorLevel | Entier | Facultatif | Code de sortie minimal, qui est traité comme une erreur. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Stage
Met à disposition les fichiers répertoriés dans une réception de build pour un répertoire de sortie.
Projeter | FileReference | Facultatif | Projet auquel appartient cette cible. |
Cible | Chaîne | Requis | Nom de la cible à mettre à disposition. |
Plateforme | UnrealTargetPlatform | Requis | Plateforme à mettre à disposition. |
Configuration | UnrealTargetConfiguration | Requis | Configuration à mettre à disposition. |
Architecture | Chaîne | Facultatif | Architecture à mettre à disposition. |
ToDir | DirectoryReference | Requis | Répertoire dans lequel les fichiers de réception doivent mis à disposition. |
Overwrite | Outil Booléen | Facultatif | Détermine s'il convient d'écraser les fichiers existants. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Strip
Supprime les informations de débogage d'un ensemble de fichiers.
Plateforme | UnrealTargetPlatform | Requis | Chaîne d'outils de la plateforme qui consiste à supprimer les fichiers binaires. |
BaseDir | DirectoryReference | Facultatif | Répertoire dans lequel se trouvent les fichiers. |
.udatasmith | FileSpec | Requis | Liste de spécifications de fichier séparées par des points-virgules (par exemple, |
OutputDir | DirectoryReference | Facultatif | Répertoire de sortie des fichiers supprimés. Sélectionne par défaut le chemin d'entrée et remplace les fichiers d'entrée. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Submit
Crée une nouvelle liste de modifications et envoie un ensemble de fichiers à un flux Perforce.
Description | Chaîne | Requis | Description de la liste de modifications envoyée. |
.udatasmith | FileSpec | Requis | Fichiers à envoyer. |
FileType | Chaîne | Facultatif | Type de fichier Perforce pour les fichiers envoyés (par exemple, binary+FS32). |
Workspace | Chaîne | Facultatif | Nom de l'espace de travail. Si ce paramètre est spécifié, un nouvel espace de travail est créé avec le flux et le répertoire racine spécifiés pour envoyer les fichiers. Dans le cas contraire, l'espace de travail actuel est utilisé. |
Stream | Chaîne | Facultatif | Flux de l'espace de travail, qui est par défaut défini sur le flux actuel. Ignoré, sauf si l'attribut Workspace est également spécifié. |
Branch | Chaîne | Facultatif | Branche de l'espace de travail (chemin d'accès au dépôt P4 hérité). Ne peut pas être utilisé en conjonction avec Stream. |
RootDir | DirectoryReference | Facultatif | Répertoire racine du flux. Si ce paramètre n'est pas spécifié, le répertoire racine actuel est utilisé par défaut. |
RevertUnchanged | Outil Booléen | Facultatif | Détermine s'il convient de rétablir les fichiers non modifiés avant de tenter l'envoi. |
Force | Outil Booléen | Facultatif | Force l'envoi, même si une résolution est nécessaire (toujours accepter la version actuelle). |
P4Verbose | Outil Booléen | Facultatif | Autorise la sortie P4 détaillée (spew). |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
SymGen
Génère un fichier de vidage de symbole portable à partir des fichiers binaires spécifiés.
.udatasmith | FileSpec | Requis | Liste de spécifications de fichier séparées par des points-virgules (p. ex., *.cpp;Engine/.../*.bat), ou nom d'un ensemble de balises. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
UseRadSym | Outil Booléen | Facultatif | Si ce paramètre est spécifié, il utilise le programme de vidage de symboles pdb du débogueur rad ainsi que rad symbol_path_fixer. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
SymStore
Cette tâche permet de retirer les symboles d'un ensemble de fichiers.
Plateforme | UnrealTargetPlatform | Requis | Chaîne d'outils de plateforme requise pour gérer les fichiers de symboles. |
.udatasmith | Chaîne | Requis | Liste des fichiers de sortie. Les PDB associés sont extraits de cette liste. |
StoreDir | Chaîne | Requis | Répertoire de sortie des symboles compressés. |
Product | Chaîne | Requis | Nom du produit dans les enregistrements du magasin de symboles. |
Branch | Chaîne | Facultatif | Nom de la branche sur laquelle baser tous les fichiers sources du dépôt. Utilisé lorsque la valeur IndexSources est définie sur true (utilisable uniquement sur certaines plateformes). |
Change | Entier | Facultatif | Liste de modifications avec laquelle tous les fichiers sources du dépôt ont été synchronisés. Utilisé lorsque la valeur IndexSources est définie sur true (utilisable uniquement sur certaines plateformes). |
BuildVersion | Chaîne | Facultatif | Version de build associée à ces symboles. Attribut utilisé pour effectuer le nettoyage dans AgeStore, en mettant en correspondance cette version avec un nom de répertoire dans un partage de build. |
IndexSources | Outil Booléen | Facultatif | Détermine s'il convient d'inclure l'index de code source dans les symboles sauvegardés. Si cet attribut est activé, la tâche génère les données requises par un serveur source (seuls certaines plateformes et certains serveurs de contrôle de source sont pris en charge). Le serveur source permet aux débogueurs de récupérer automatiquement le code source correspondant lors du débogage des builds ou de l'analyse des vidages. |
SourceFiles | Chaîne | Facultatif | Filtre les fichiers sources du dépôt devant être indexés. Il s'agit d'une liste de filtres Perforce séparés par des points-virgules, p. ex., Engine/....cpp;Engine/....h. Il peut également s'agir du nom d'une balise préalablement définie, p. ex., "#SourceFiles Used lorsque IndexSources est défini sur true (disponible uniquement sur certaines plateformes). |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Tag
Applique une balise à un ensemble de fichiers donné. Pour localiser la liste des fichiers, il convient d'énumérer les balises et les spécifications de fichier fournies par le paramètre « Files ». Dans cette liste, tous les fichiers qui ne correspondent pas au paramètre « Filter » sont supprimés, suivis de tous les fichiers qui correspondent au paramètre « Except ».
BaseDir | DirectoryReference | Facultatif | Détermine le répertoire de base à utiliser pour résoudre les chemins et modèles relatifs. Si ce paramètre est défini, tous les modèles absolus (par exemple, /Engine/Build/...) sont considérés comme relatifs à ce chemin. Dans le cas contraire, ils sont considérés comme absolus. |
.udatasmith | FileSpec | Facultatif | Ensemble de fichiers à utiliser, y compris les caractères génériques et les noms de balise, séparés par des points-virgules. Si ce paramètre est défini, il est résolu par rapport à BaseDir ; dans le cas contraire, il est résolu par rapport au répertoire racine de la branche. |
FileLists | FileSpec | Facultatif | Ensemble de fichiers texte à partir duquel ajouter des fichiers supplémentaires. Chaque liste de fichiers doit contenir un fichier par ligne. |
Filtre | FileSpec | Facultatif | Modèles pour filtrer la liste de fichiers, notamment les noms de balise ou les caractères génériques. Si ce paramètre est défini, il peut inclure des modèles qui s'appliquent au répertoire de base. S'il n'est pas spécifié, tous les fichiers sont utilisés par défaut. |
Except | FileSpec | Facultatif | Ensemble de modèles à exclure de la liste de correspondances. Peut inclure des noms de balise de modèles qui s'appliquent au répertoire de base. |
With | TagList | Requis | Nom de la balise à appliquer. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
TagReceipt
Tâche qui balise les produits de build et/ou les dépendances d'exécution en lisant les fichiers *.target.
.udatasmith | FileSpec | Requis | Ensemble de fichiers de réception (*.target) à lire, y compris les caractères génériques et les noms de balise, séparés par des points-virgules. |
EngineDir | DirectoryReference | Facultatif | Chemin d'accès au dossier du moteur, utilisé pour développer les propriétés $(EngineDir) dans les fichiers de réception. Détermine par défaut le répertoire du moteur pour l'espace de travail actuel. |
ProjectDir | DirectoryReference | Facultatif | Chemin d'accès au dossier du projet, utilisé pour développer les propriétés $(ProjectDir) dans les fichiers de réception. Ce paramètre est par défaut défini sur le répertoire du moteur pour l'espace de travail actuel -- OBSOLÈTE. |
BuildProducts | Outil Booléen | Facultatif | Détermine s'il convient de baliser les produits de build répertoriés dans les réceptions. |
BuildProductType | Chaîne | Facultatif | Détermine le type de produits de build à baliser (voir TargetReceipt.cs - UnrealBuildTool.BuildProductType pour les valeurs valides). |
RuntimeDependencies | Outil Booléen | Facultatif | Détermine s'il convient de baliser les dépendances d'exécution répertoriées dans les réceptions. |
StagedFileType | Chaîne | Facultatif | Détermine le type de dépendances d'exécution à baliser (voir TargetReceipt.cs - UnrealBuildTool.StagedFileType pour les valeurs valides). |
With | TagList | Requis | Nom de la balise à appliquer. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Unzip
Extrait les fichiers d'une archive .zip.
ZipFile | FileSpec | Requis | Chemin d'accès au fichier .zip à extraire. |
ToDir | DirectoryReference | Requis | Répertoire de sortie des fichiers extraits. |
UseLegacyUnzip | Outil Booléen | Facultatif | Détermine s'il convient d'utiliser l'ancien code de décompression. |
OverwriteFiles | Outil Booléen | Facultatif | Détermine s'il convient d'écraser les fichiers lors de la décompression. |
Tag | TagList | Facultatif | Balise à appliquer aux fichiers extraits. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Upload
Met en ligne un ensemble de fichiers sur Jup à des fins de récupération.
FromDir | DirectoryReference | Requis | Répertoire à partir duquel lire les fichiers compressés. |
.udatasmith | FileSpec | Facultatif | Liste de spécifications de fichier séparées par des points-virgules (par exemple, |
JupiterNamespace | Chaîne | Requis | Espace de noms jupiter utilisé pour mettre en ligne le build. Permet de contrôler qui a accès au build. |
JupiterKey | Chaîne | Requis | Clé du build utilisée pour télécharger de nouveau le build. Celle-ci doit être unique à cette mise en ligne particulière. |
ArchiveType | Chaîne | Requis | Type d'archive dont proviennent ces fichiers, qui sera ajouté aux métadonnées. |
ProjectName | Chaîne | Requis | Nom du projet auquel cet ensemble de fichiers est associé, qui sera ajouté aux métadonnées. |
Branch | Chaîne | Requis | Branche du contrôle de source à partir de laquelle ces fichiers ont été générés, qui sera ajoutée aux métadonnées. |
Changelist | Chaîne | Requis | Révision du contrôle de source à partir de laquelle ces fichiers sont générés, qui sera ajoutée aux métadonnées. |
JupiterUrl | Chaîne | Requis | Spécifie l'URL de l'instance vers laquelle effectuer la mise en ligne. |
AdditionalMetadata | Chaîne | Facultatif | Liste de mappages de valeurs de clé séparés par « = » à ajouter aux métadonnées. P. ex., Foo=bar;spam=eggs |
LimitMemoryUsage | Outil Booléen | Facultatif | Si ce paramètre est activé, le contenu des fichiers n'est pas conservé en mémoire ; cela réduit l'utilisation de la mémoire, mais augmente les E/S, car le contenu des fichiers doit être lu plusieurs fois (à des fins de hachage et lors de la mise en ligne). |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Wait
Attend un nombre défini de secondes.
Seconds | Entier | Requis | Durée d'attente, en secondes. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
WriteJsonValue
Modifie les fichiers JSON en définissant une valeur spécifiée dans le chemin d'accès de la clé.
Fichier | FileSpec | Requis | Le ou les fichiers JSON qui seront modifiés. |
Clé | Chaîne | Requis | Élément JSON à définir dans chaque fichier. La syntaxe de cette chaîne est un sous-ensemble limité de la notation JsonPath. Elle peut prendre en charge les propriétés d'objet et les index de matrice. Tous les index de matrice qui sont omis ou hors plage ajoutent un nouvel élément à la matrice (p. ex., « $.foo.bar[] » ajoute un élément à la matrice « bar » dans l'objet « foo »). |
Valeur | Chaîne | Requis | Nouvelle valeur à définir. Il peut s'agir d'une valeur JSON quelconque (chaîne, matrice, objet, nombre, booléen ou nul). |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
WriteTextFile
Écrit du texte dans un fichier.
Fichier | FileReference | Requis | Chemin d'accès au fichier à écrire. |
Append | Outil Booléen | Facultatif | Facultatif. Détermine s'il convient d'ajouter une pièce jointe au fichier plutôt que de l'écraser. |
Text | Chaîne | Facultatif | Texte à écrire dans le fichier. |
.udatasmith | FileSpec | Facultatif | Si ce paramètre est spécifié, la liste de fichiers est consignée après le message donné. |
Tag | TagList | Facultatif | Balise à appliquer pour créer le build des produits de cette tâche. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
ZenExportSnapshot
Exporte un instantané depuis Zen vers une destination spécifiée.
Projeter | FileReference | Facultatif | Projet à partir duquel exporter l'instantané. |
Plateforme | Chaîne | Facultatif | Plateformes cibles vers lesquelles exporter l'instantané. |
SnapshotDescriptorFile | FileReference | Facultatif | Fichier à créer avec des informations sur l'instantané exporté. |
DestinationStorageType | Chaîne | Requis | Type de destination vers laquelle exporter l'instantané (cloud, etc.). |
DestinationCloudHost | Chaîne | Facultatif | Nom d'hôte à utiliser lors de l'exportation vers une destination sur le cloud. |
DestinationCloudNamespace | Chaîne | Facultatif | Espace de noms à utiliser lors de l'exportation vers une destination sur le cloud. |
DestinationCloudIdentifier | Chaîne | Facultatif | Identificateur à utiliser lors de l'exportation vers une destination sur le cloud. |
DestinationCloudBucket | Chaîne | Facultatif | Nom d'un compartiment personnalisé à utiliser lors de l'exportation vers une destination sur le cloud. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
ZenImportOplog
Importe un journal d'opérations depuis Zen vers une destination spécifiée.
ImportType | Chaîne | Requis | Type de destination vers laquelle importer les fichiers (cloud, fichier, etc.). |
.udatasmith | Chaîne | Facultatif | Chemin complet séparé par des virgules vers le répertoire oplog à importer dans le serveur Zen local Files="Path1,Path2". |
Projeter | FileReference | Facultatif | Projet à partir duquel effectuer l'importation. |
ProjectName | Chaîne | Facultatif | Nom du projet Zen nouvellement créé dans lequel effectuer l'importation. |
Plateforme | Chaîne | Facultatif | Plateforme cible vers laquelle importer l'instantané. |
RootDir | Chaîne | Facultatif | Répertoire racine du projet UE. Utilisé pour dériver le dossier du moteur et le dossier du projet. |
OplogName | Chaîne | Facultatif | Nom du journal d'opérations importé. |
HostName | Chaîne | Facultatif | URL hôte du serveur Zen à partir duquel effectuer l'importation. |
HostPort | Chaîne | Facultatif | Port hôte du serveur Zen à partir duquel effectuer l'importation. |
CloudURL | Chaîne | Facultatif | URL du cloud à partir de laquelle effectuer l'importation. |
Namespace | Chaîne | Facultatif | Espace de noms à utiliser lors de l'importation depuis le cloud. |
Bucket | Chaîne | Facultatif | Compartiment à utiliser lors de l'importation depuis le cloud. |
Clé | Chaîne | Facultatif | Clé à utiliser lors de l'importation depuis le cloud. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
ZenLaunch
Lance le serveur Zen.
Projeter | FileReference | Requis | Projet pour lequel lancer le serveur Zen. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
ZenMirror
Exporte un instantané depuis Zen vers une destination spécifiée.
Projeter | FileReference | Facultatif | Projet à partir duquel exporter l'instantané. |
Plateforme | Chaîne | Facultatif | Plateforme cible pour laquelle dupliquer l'instantané. |
DestinationFileDir | DirectoryReference | Facultatif | Chemin d'accès sur le disque local vers lequel répliquer les données. S'il est vide, le chemin est défini sur le répertoire %Project%\Saved\Cooked\%Platform%. |
If | Condtion | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |
Zip
Compresse les fichiers dans une archive .zip.
FromDir | DirectoryReference | Requis | Répertoire à partir duquel lire les fichiers compressés. |
.udatasmith | FileSpec | Facultatif | Liste de spécifications de fichier séparées par des points-virgules (par exemple, |
ExecutableFiles | FileSpec | Facultatif | Liste des fichiers sur lesquels un bit exécutable doit être défini. |
ZipFile | FileReference | Requis | Fichier .zip à créer. |
Tag | TagList | Facultatif | Balise à appliquer au fichier .zip créé. |
If | Condition | Facultatif | Détermine s'il convient d'exécuter cette tâche. Ignoré si cette condition est définie sur false. |