L'interface de ligne de commande (CLI) Unreal Revision Control (URC) vous permet d'exécuter des actions de contrôle de révision sur votre projet à l'aide d'un outil de ligne de commande tiers tel que PowerShell. Bien que ces actions soient souvent possibles avec l'interface utilisateur, la CLI permet d'aller au-delà des configurations actuellement prises en charge par l'interface.
Dans ce document, nous abordons les thèmes suivants :
-
Utilisation de la CLI
-
Cas d'utilisation courants et mise en pratique avec la CLI
Avant de commencer
Pour utiliser les lignes de commande, vous devez savoir où se trouvent les fichiers URC dans l'explorateur Windows et configurer une variable d'environnement pour créer et utiliser des lignes de commande avec l'URC.
Avant de définir la variable d'environnement, assurez-vous de définir le dossier où se trouve le fichier urc.exe dans votre variable de chemin d'accès.

-
Ouvrez les paramètres Windows et sélectionnez Système > Informations système > Paramètres avancés du système. Le panneau Propriétés système s'ouvre.
-
Cliquez sur Variables d'environnement…
Cliquez sur l'image pour l'agrandir.
-
Sélectionnez Path > Modifier dans la liste Variables utilisateur pour modifier les variables d'environnement du chemin.
Cliquez sur l'image pour l'agrandir.
Votre nom s'affiche après C:\Users\
-
Sélectionnez Parcourir et choisissez le chemin d'accès menant à vos fichiers urc.exe.
Cliquez sur l'image pour l'agrandir.
-
Cliquez sur OK jusqu'à ce que tous les panneaux ouverts soient fermés.
Vous venez de modifier une variable d'environnement.
Lancer PowerShell
Ouvrez le projet Unreal Editor pour Fortnite (UEFN) sur lequel vous travaillez avec l'explorateur Windows.

Veillez à vous connecter à l'UEFN avant d'utiliser les autres commandes de la CLI de l'URC.
Vérifiez si vous vous êtes récemment connecté à l'UEFN. Vous n'aurez pas besoin d'appeler urc auth login
si l'UEFN est ouvert et que vous êtes connecté, à moins que le jeton n'expire. Si vous utilisez la CLI alors que l'UEFN est fermé ou après l'expiration du jeton, vous devrez vous connecter à la CLI.

-
Appuyez sur Maj + clic droit pour ouvrir le menu contextuel.
-
Choisissez Ouvrir la fenêtre PowerShell ici.
Cas d'utilisation courants de la CLI
Dresser la liste de tous les projets auxquels vous avez accès après avoir connecté votre compte.
Commandes de la CLI |
---|
urc project list |
urc p list |
Cliquez sur l'image pour l'agrandir.
Afficher tous les instantanés de votre projet.
Commandes de la CLI |
---|
urc project snapshot list |
urc p s list |
Se synchroniser avec un instantané précédent pour revenir en arrière dans l'historique du projet.
Fermez le projet ou l'éditeur avant de procéder à la synchronisation avec un instantané spécifique pour bien synchroniser les fichiers du projet.
Commandes de la CLI |
---|
urc project snapshot get |
urc p s get |
Cliquez sur l'image pour l'agrandir.
Se synchroniser avec la dernière version afin de récupérer les mises à jour de tous les utilisateurs sur l'île.
Commandes de la CLI |
---|
urc project snapshot get |
urc p s get |
Cliquez sur l'image pour l'agrandir.
Obtenir une vue d'ensemble de toutes les ressources et de leur statut dans l'instantané actuel avant de les envoyer.
Commandes de la CLI |
---|
urc project status –-extended |
urc p status –-extended |
Cliquez sur l'image pour l'agrandir.
Revenir à un instantané spécifique pour continuer à travailler à partir d'une sauvegarde précédente.
Synchroniser votre projet avec un instantané précédent
Commandes de la CLI |
---|
urc projects snapshots get |
Si vous avez besoin d'une liste d'instantanés pour sélectionner la version du projet sur laquelle vous souhaitez vous synchroniser, utilisez la commande suivante :
Commandes de la CLI |
---|
urc projects snapshots list |
Cliquez sur l'image pour l'agrandir.
Copiez-collez le dossier Plug-ins sur votre bureau pour conserver une sauvegarde de vos ressources.

Ensuite, synchronisez à nouveau le projet avec le dernier instantané.
Commandes de la CLI |
---|
urc projects snapshots get |
Une fois que vous avez synchronisé le projet avec le dernier instantané, procédez comme suit :
-
Supprimez les plug-ins de votre dossier de projet UEFN actuel.
-
Copiez-collez le dossier Plug-ins précédent du bureau dans le dossier du projet.
-
Ouvrez votre projet dans l'UEFN et confirmez que l'état du projet est conforme à vos attentes.
-
Cliquez sur Archiver les modifications si votre projet est conforme à vos attentes pour créer un nouvel instantané reflétant le nouvel état de votre projet.
Revenir à l'instantané actuel d'une ressource pour annuler vos modifications.
Commandes de la CLI |
---|
urc asset revert .\pathname |
urc a revert .\pathname |
Cliquez sur l'image pour l'agrandir.
Libérer les ressources extraites par un membre spécifique de l'équipe, afin de pouvoir continuer à travailler sans que personne ne bloque votre travail.
Obtenez l'identifiant du projet en ouvrant le projet dans le portail de créateur. L'identifiant du projet est indiqué dans l'URL.
Cliquez sur l'image pour l'agrandir.
Seul l'administrateur de l'équipe peut exécuter cette fonction. Vérifiez votre rôle au sein de l'équipe dans le portail de créateur.
Commandes de la CLI |
---|
urc project forcerelease |
urc p forcerelease |
Cliquez sur l'image pour l'agrandir.