В проектах, созданных после выпуска версии 36.00, не получится использовать путь к файлам, указанный ниже, для применения команд CLI. При просмотре пути к файлу найдите urc2.exe.
Используйте следующие команды CLI для проектов после 36.00:
Просмотр всех версий в репозитории
urc2 revision list
Синхронизация с последней версией проекта
urc2 revision sync
Синхронизация с предыдущей версией в истории репозитория
urc2 revision sync @[revision]
Получение обзора всех ресурсов и их статуса в определённой версии
urc2 repository status
Возврат к определённой версии для продолжения работы из предыдущей резервной копии
urc2 revision promote "description"
Откат ресурса до текущей версии для отмены внесённых изменений
urc2 file reset .\pathname
Разблокировка ресурсов, которые были извлечены другим участником команды, чтобы вы могли продолжить работу
urc2 lock release --force --owner <имя пользователя>
Интерфейс командной строки (CLI) Unreal Revision Control (URC) позволяет выполнять действия по контролю версий в проекте с помощью стороннего инструмента командной строки, такого как PowerShell. Многие из этих действий можно выполнять и с помощью пользовательского интерфейса, однако некоторые из них на данный момент доступны только через командную строку.
В этом документе вы узнаете следующее:
Как начать работать с CLI
Частые задачи и как их решать с помощью CLI
Предварительная подготовка
Чтобы использовать командные строки, нужно знать, где находятся файлы URC в проводнике Windows, и настроить переменную среды для создания и использования командных строк с URC.
Перед настройкой переменной среды убедитесь, что в переменной пути указана именно та папка, где находится файл urc.exe.
Откройте настройки Windows и выберите Система > Информация > Расширенные настройки системы. Откроется панель Свойства системы.
Найдите Переменные среды…
Нажмите, чтобы увеличить изображение.
Выберите Путь > Редактировать из списка пользовательских переменных, чтобы отредактировать переменные среды, определяющие путь.
Нажмите, чтобы увеличить изображение.
Ваше имя будет отображаться после C:\Users\
Нажмите Поиск и укажите путь к своим файлам urc.exe. Обычное местоположение таково:
C:\Program Files\Epic Games\Fortnite\FortniteGame\Binaries\Win64Щёлкните, чтобы увеличить изображение. Нажимайте ОК, пока не закроются все открытые панели.
Вы успешно отредактировали переменную среды.
Запуск PowerShell
Откройте проект Unreal Editor для Fortnite (UEFN), над которым вы работаете, в проводнике Windows.
Не забудьте войти в учётную запись UEFN, прежде чем использовать другие команды CLI URC.
Всё зависит от того, открывали ли вы недавно 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 <number of snapshot> |
Если вы хотите просмотреть список снимков состояния, чтобы выбрать версию проекта, с которой хотите синхронизироваться, используйте следующую команду:
| Команды CLI |
|---|
urc projects snapshots list |
Нажмите, чтобы увеличить изображение.
Скопируйте и вставьте папку Плагины на рабочий стол, чтобы сохранить резервную копию своих ресурсов.
После этого выполните обратную синхронизацию с последним снимком состояния.
| Команды CLI |
|---|
urc projects snapshots get |
После успешной синхронизации проекта с последним снимком состояния выполните следующие действия:
Удалите подключаемые модули из папки текущего проекта UEFN.
Скопируйте и вставьте предыдущую папку Модули с рабочего стола в папку проекта.
Откройте свой проект в UEFN и убедитесь, что состояние проекта отвечает ожиданиям.
Если всё хорошо, нажмите Зафиксировать изменения, чтобы создать новый снимок состояния, в котором будет отражено новое состояние проекта.
Откат ресурса до текущего снимка состояния для отмены внесённых изменений.
| Команды CLI |
|---|
urc asset revert .\pathname |
urc a revert .\pathname |
Нажмите, чтобы увеличить изображение.
Разблокировка ресурсов, которые были извлечены другим участником команды, чтобы вы могли продолжить работу.
Узнайте идентификатор проекта, открыв проект на творческом портале. Он содержится в URL.
Нажмите, чтобы увеличить изображение.
Эту функцию может использовать только администратор команды. Не забудьте проверить свою роль в команде на творческом портале.
| Команды CLI |
|---|
urc project forcerelease <идентификатор проекта> –-user Имя пользователя |
urc p forcerelease <идентификатор проекта> –-user Имя пользователя |
Нажмите, чтобы увеличить изображение.