Los proyectos creados después de la versión 36.00 no podrán utilizar la ruta de archivo que se indica a continuación para utilizar los comandos de la CLI. Al buscar la ruta del archivo, busca urc2.exe.
Utiliza los siguientes comandos de la CLI para proyectos posteriores a la 36.00:
Ver todas las revisiones en tu repositorio
urc2 revision list
Sincronizar con la última revisión del proyecto
urc2 revision sync
Sincroniza con una revisión anterior en el historial de tu repositorio
urc2 revision sync @[revision]
Obtener una descripción general de todos los recursos y su estado dentro de una revisión determinada
urc2 repository status
Retrocede a una revisión específica para seguir trabajando desde una copia de seguridad anterior
urc2 revision promote "description"
Revierte un recurso a la revisión actual para deshacer los cambios
urc2 file reset .\pathname
Libera recursos de los que un miembro específico del equipo haya cerrado sesión para desbloquearte
urc2 lock release --force --owner <username>
La interfaz de línea de comandos (CLI) de Unreal Revision Control (URC) te permite realizar acciones de control de revisión en tu proyecto a través de una herramienta de línea de comandos de terceros como PowerShell. Aunque, con frecuencia, estas acciones pueden realizarse con la interfaz de usuario, algunas permiten ir más allá de lo que la interfaz admite actualmente.
En este documento, se ofrece un resumen de lo siguiente:
Cómo empezar a utilizar la CLI
Casos de uso comunes y cómo lograrlos con la CLI
Antes de empezar
Para utilizar líneas de comandos es necesario saber dónde se encuentran los archivos de URC en el explorador de Windows y también configurar una variable de entorno para crear y utilizar líneas de comandos con URC.
Antes de establecer la variable de entorno, asegúrate de establecer tu carpeta donde existe el archivo 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 de variables de usuario para editar las variables de entorno de la ruta.
Haz clic en la imagen para ampliarla.
Tu nombre aparecerá después de C:\Users\
Selecciona Examinar y elige la ruta de acceso a tus archivos urc.exe. Normalmente, esto se encuentra en
C:\Program Files\Epic Games\Fortnite\FortniteGame\Binaries\Win64.Haz clic en la imagen para ampliarla. Haz clic en Aceptar hasta que se cierren todos los paneles abiertos.
Editaste correctamente una variable de entorno.
Cómo 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 en UEFN antes de utilizar otros comandos de la CLI de URC.
Esto depende de si iniciaste sesión recientemente en UEFN. No tendrás que llamar a urc auth login si UEFN está abierto e iniciaste sesión a menos que el token haya caducado. Si usas la CLI sin que UEFN esté abierto o después de que haya caducado la ficha, tendrás que iniciar sesión en la CLI.
Presiona la tecla Shift + clic derecho para abrir el menú contextual.
Selecciona Abrir ventana de PowerShell aquí.
Casos comunes de uso de la CLI
Listado de todos los proyectos a los que tienes acceso con tu cuenta iniciada.
| Comandos de la CLI |
|---|
urc project list |
urc p list |
Haz clic en la imagen para ampliarla.
Cómo ver todas las instantáneas de tu proyecto.
| Comandos de la CLI |
|---|
urc project snapshot list |
urc p s list |
Cómo sincronizar con una instantánea anterior para retroceder en el historial del proyecto.
Cierra el proyecto o el editor antes de sincronizar con una instantánea específica para evitar que no se sincronicen los archivos del proyecto.
| Comandos de la CLI |
|---|
urc project snapshot get <number of snapshot> |
urc p s get <number of snapshot> |
Haz clic en la imagen para ampliarla.
Cómo sincronizar con la última para poder recuperar las actualizaciones de todos 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 instantánea actual antes de enviarlos.
| Comandos de la CLI |
|---|
urc project status –-extended |
urc p status –-extended |
Haz clic en la imagen para ampliarla.
Retrocede a una instantánea concreta para seguir trabajando a partir de una copia de seguridad anterior.
Sincroniza tu proyecto con una instantánea anterior
| Comandos de la CLI |
|---|
urc projects snapshots get <number of snapshot> |
Si quieres ver una lista de instantáneas para poder seleccionar la versión del proyecto con la que deseas 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 mantener una copia de seguridad de tus recursos.
Después, sincroniza de vuelta a la última instantánea.
| Comandos de la CLI |
|---|
urc projects snapshots get |
Una vez que hayas sincronizado correctamente el proyecto con la última 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 sea el deseado.
Haz clic en Cargar cambios si el proyecto tiene el aspecto que esperas para crear una nueva instantánea que refleje el nuevo estado del proyecto.
Cómo revertir un recurso a la instantánea actual para deshacer los 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 hayan sido protegidos por un miembro concreto del equipo, para que puedas seguir trabajando sin que nadie bloquee tu trabajo.
Abre el proyecto en el Portal de creadores para obtener el projectID. 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. Comprueba tu rol de equipo en el Portal de creadores.
| Comandos de la CLI |
|---|
urc project forcerelease <projectID> –-user UserName |
urc p forcerelease <projectID> –-user UserName |
Haz clic en la imagen para ampliarla.