La interfaz de línea de comandos (CLI) de Unreal Revision Control (URC) te permite realizar acciones de control de versiones en tu proyecto utilizando una herramienta de línea de comandos de terceros, como PowerShell. Aunque estas acciones a menudo se pueden realizar con la interfaz de usuario, algunas te permiten ir más allá de lo que la interfaz admite actualmente.
Este documento ofrece una visión general de lo siguiente:
-
Cómo empezar con la CLI.
-
Casos de uso habituales y cómo conseguirlos con la CLI.
Antes de empezar
Para utilizar líneas de comandos necesitas saber dónde se encuentran los archivos de URC en el Explorador de Windows y configurar una variable de entorno para crear y utilizar líneas de comandos con URC.
Antes de configurar la variable de entorno, asegúrate de establecer la carpeta donde existe el urc.exe dentro de tu variable de ruta.

-
Abre la configuración de Windows y selecciona Sistema > Acerca de > Configuración avanzada del sistema. Se abrirá el panel Propiedades del sistema.
-
Haz clic en Variables de entorno....
Haz clic en la imagen para ampliarla.
-
Selecciona Ruta > Editar de la lista Variables de usuario para editar las variables de entorno de la ruta.
Haz clic en la imagen para ampliarla.
Tu nombre aparece después de C:\Users.
-
Selecciona Examinar y elige la ruta de acceso a tus archivos urc.exe.
Haz clic en la imagen para ampliarla.
-
Haz clic en Aceptar hasta que se cierren todos los paneles abiertos.
Has editado correctamente una variable de entorno.
Iniciar PowerShell
Abre el proyecto de Unreal Editor para Fortnite (UEFN) en el que estás trabajando con el Explorador de Windows.

Asegúrate de iniciar sesión primero en UEFN antes de utilizar otros comandos de la CLI de URC.
Esto depende de si te has conectado recientemente a UEFN. No necesitarás llamar a urc auth login
si UEFN está abierto y has iniciado sesión, a menos que el token caduque. Si utilizas la CLI sin UEFN abierto o después de que caduque el token, tendrás que iniciar sesión en la CLI.

-
Mayús + Clic derecho para abrir el menú contextual.
-
Selecciona Abrir en la ventana de PowerShell.
Casos de uso habituales de la CLI
Listado de todos los proyectos a los que tienes acceso con la sesión iniciada
Comandos de la CLI |
---|
urc project list |
urc p list |
Haz clic en la imagen para ampliarla.
Cómo ver todas las copias instantáneas de tu proyecto
Comandos de la CLI |
---|
urc project snapshot list |
urc p s list |
Cómo sincronizar con una copia instantánea anterior para retroceder en el historial del proyecto
Cierra el proyecto o el editor antes de sincronizar con una copia instantánea concreta para evitar que no se sincronicen los archivos del proyecto.
Comandos de la CLI |
---|
urc project snapshot get |
urc p s get |
Haz clic en la imagen para ampliarla.
Cómo sincronizar a la versión más reciente para recibir las actualizaciones de los colaboradores en la isla
Comandos de la CLI |
---|
urc project snapshot get |
urc p s get |
Haz clic en la imagen para ampliarla.
Cómo obtener un resumen de todos los recursos y su estado en la copia instantánea actual antes de enviarla
Comandos de la CLI |
---|
urc project status –-extended |
urc p status –-extended |
Haz clic en la imagen para ampliarla.
Cómo retroceder a una copia instantánea concreta para seguir trabajando a partir de una copia de seguridad anterior
Sincroniza tu proyecto con una copia instantánea anterior.
Comandos de la CLI |
---|
urc projects snapshots get |
Si necesitas ver una lista de copias instantáneas para poder seleccionar con qué versión del proyecto quieres sincronizar, utiliza el siguiente comando:
Comandos de la CLI |
---|
urc projects snapshots list |
Haz clic en la imagen para ampliarla.
Copia y pega la carpeta Complementos en tu escritorio para guardar una copia de seguridad de tus recursos.

Después, sincroniza de nuevo con la última copia instantánea.
Comandos de la CLI |
---|
urc projects snapshots get |
Una vez que hayas sincronizado correctamente el proyecto con la última copia instantánea, haz lo siguiente:
-
Elimina los complementos de la carpeta actual de tu proyecto de UEFN.
-
Copia y pega la carpeta Complementos anterior del escritorio en la carpeta del proyecto.
-
Abre tu proyecto en UEFN y confirma que el estado del proyecto es el que pretendías.
-
Haz clic en Registrar cambios si tu proyecto tiene el aspecto que esperas para crear una nueva copia instantánea que refleje el nuevo estado de tu proyecto.
Cómo revertir un recurso a la copia instantánea actual para deshacer tus cambios
Comandos de la CLI |
---|
urc asset revert .\pathname |
urc a revert .\pathname |
Haz clic en la imagen para ampliarla.
Cómo liberar recursos que han sido reservados por un miembro concreto del equipo, para que puedas seguir trabajando sin que nadie bloquee tu trabajo
Obtén el ID del proyecto abriéndolo en el portal para creadores. Puedes ver el ID del proyecto en la URL.
Haz clic en la imagen para ampliarla.
Esta función solo puede realizarla un administrador de equipo. Asegúrate de comprobar tu rol de equipo en el portal para creadores.
Comandos de la CLI |
---|
urc project forcerelease |
urc p forcerelease |
Haz clic en la imagen para ampliarla.