Интерфейс командной строки (CLI — Command Line Interface) в Unreal Revision Control (URC) позволяет выполнять действия по контролю версий в проекте с помощью сторонних инструментов командной строки, например PowerShell. Многие из этих действий можно выполнять и с помощью пользовательского интерфейса, однако некоторые из них на данный момент доступны только через командную строку.
В этом документе описаны:
-
подготовка к работе с CLI;
-
типовые случаи применения CLI.
Подготовка
Чтобы использовать интерфейс командной строки, нужно знать, где находятся файлы URC в проводнике Windows, и настроить переменную среды для работы с URC.
Перед настройкой переменной среды убедитесь, что в пути к переменной указана именно та папка, где находится файл urc.exe.

-
Откройте настройки Windows и выберите Система > О системе > Дополнительные параметры системы. Откроется панель Свойства системы.
-
Нажмите на Переменные среды…
Нажмите, чтобы увеличить изображение.
-
Выберите Path > Изменить из списка Переменных пользователя, чтобы отредактировать переменные среды, определяющие путь.
Нажмите, чтобы увеличить изображение.
После C:\Users\ отобраажется имя пользователя.
-
Нажмите Обзор и укажите путь к файлу urc.exe.
Нажмите, чтобы увеличить изображение.
-
Нажимайте ОК, пока не закроются все открытые панели.
Вы успешно изменили переменную среды.
Запуск PowerShell
В провдонике Windows перейдите к текущему проекту Unreal Editor для Fortnite (UEFN).

Прежде чем использовать команды CLI в URC, не забудьте войти в учётную запись UEFN.
Этот шаг зависит от того, входили ли вы недавно в UEFN. Вам не нужно вызывать urc auth login
, если UEFN открыт, вы уже вошли в систему и срок действия токена не истёк. Если вы будете использовать CLI, не открыв UEFN или после истечения срока действия токена, вам потребуется войти в CLI.

-
Нажмите Shift + правую кнопку мыши, чтобы открыть контекстное меню.
-
Выберите Открыть окно PowerShell здесь.
Типовые случаи применения CLI
Список всех проектов, доступных с текущей учётной записью
Команды CLI |
---|
urc project list |
urc p list |
Нажмите, чтобы увеличить изображение.
Просмотр всех снимков состояния вашего проекта
Команды CLI |
---|
urc project snapshot list |
urc p s list |
Синхронизация с предыдущим снимком состояния из истории проекта
Перед синхронизацией с определённым снимком состояния закройте проект или редактор, чтобы избежать ошибки синхронизации с файлами проекта.
Команды CLI |
---|
urc project snapshot get <номер снимка состояния> |
urc p s get <номер снимка состояния> |
Нажмите, чтобы увеличить изображение.
Синхронизация с последними обновлениями острова других участников команды
Команды CLI |
---|
urc project snapshot get |
urc p s get |
Нажмите, чтобы увеличить изображение.
Обзор всех ресурсов и их статуса в текущем снимке состояния перед фиксацией
Команды CLI |
---|
urc project status --extended |
urc p status --extended |
Нажмите, чтобы увеличить изображение.
Откат к определённому снимку состояния для работы из предыдущей резервной копии
Синхронизируйте проект с предыдущим снимком состояния.
Команды CLI |
---|
urc projects snapshots get <номер снимка состояния> |
Используйте следующую команду, чтобы посмотреть список снимков состояния для выбора версии проекта, с которой хотите синхронизироваться:
Команды CLI |
---|
urc projects snapshots list |
Нажмите, чтобы увеличить изображение.
Скопируйте папку Plugins на рабочий стол, чтобы сохранить резервную копию своих ресурсов.

После этого выполните синхронизацию с последним снимком состояния.
Команды CLI |
---|
urc projects snapshots get |
После успешной синхронизации проекта с последним снимком состояния выполните следующие действия:
-
Удалите папку Plugins из папки текущего проекта UEFN.
-
Вставьте предыдущую папку Plugins с рабочего стола в папку проекта.
-
Откройте свой проект в UEFN и убедитесь, что состояние проекта отвечает ожиданиям.
-
Если всё хорошо, нажмите Зафиксировать изменения, чтобы создать новый снимок состояния проекта.
Возврат ресурса в текущий снимок состояния для отмены внесённых изменений.
Команды CLI |
---|
urc asset revert .\имяпути |
urc a revert .\имяпути |
Нажмите, чтобы увеличить изображение.
Разблокировка ресурсов, извлечённых другим участником команды, для продолжения работы
Узнайте идентификатор проекта. Для этого откройте проект на творческом портале. Идентификатор указан в URL-адресе.
Нажмите, чтобы увеличить изображение.
Эту функцию может использовать только администратор команды. Не забудьте проверить свою роль в команде на творческом портале.
Команды CLI |
---|
urc project forcerelease <идентификатор проекта> --user <имя пользователя> |
urc p forcerelease <идентификатор проекта> --user <имя пользователя> |
Нажмите, чтобы увеличить изображение.