Les projets créés après la version 36.00 ne pourront pas recourir au chemin de fichier indiqué ci-dessous pour utiliser les commandes de la CLI. Lorsque vous recherchez le chemin d'accès au fichier, recherchez urc2.exe.
Utilisez les commandes de la CLI suivantes pour les projets postérieurs à la version 36.00 :
Voir toutes les révisions dans votre référentiel
urc2 revision list
Synchroniser avec la dernière révision du projet
urc2 revision sync
Synchroniser avec une révision précédente dans l'historique de votre référentiel
urc2 revision sync @[revision]
Obtenir une vue d'ensemble de toutes les ressources et de leur statut avec une certaine révision
urc2 repository status
Revenir à une révision spécifique pour continuer à travailler à partir d'une sauvegarde précédente
urc2 revision promote "description"
Revenir à la révision actuelle d'une ressource pour annuler vos modifications
urc2 file reset .\pathname
Libérer les ressources signées par un membre spécifique de l'équipe pour vous débloquer
urc2 lock release --force --owner <username>
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 :
Premiers pas avec 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 Chemin d'accès > 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. Il s'agit généralement du suivant :
C:\Program Files\Epic Games\Fortnite\FortniteGame\Binaries\Win64Cliquez 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 une fenêtre PowerShell ici.
Cas d'utilisation courants de la CLI
Dresser la liste de tous les projets auxquels vous avez accès avec votre compte connecté.
| 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 |
Synchroniser avec une capture précédente pour revenir 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 <numéro de l'instantané> |
urc p s get <numéro de l'instantané> |
Cliquez sur l'image pour l'agrandir.
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 état 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 <numéro de l'instantané> |
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.
Copier le dossier Plug-ins précédent sur le bureau et le coller 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 <identifiant du projet> –-user UserName |
urc p forcerelease <identifiant du projet> –-user UserName |
Cliquez sur l'image pour l'agrandir.