36.00 버전이 출시된 후 생성된 프로젝트에서는 아래 지정된 파일 경로를 사용하여 CLI 명령을 사용할 수 없습니다. 파일 경로를 탐색할 때 urc2.exe를 검색합니다.
36.00 버전 이후 프로젝트의 경우 다음 CLI 명령을 사용합니다.
저장소의 모든 리비전 보기
urc2 revision list
프로젝트의 최신 리비전으로 동기화
urc2 revision sync
저장소 이력의 이전 리비전으로 동기화
urc2 revision sync @[리비전]
특정 리비전 내의 모든 에셋 및 해당 상태 개요 확인
urc2 repository status
이전 백업에서 계속 작업하기 위해 특정 리비전으로 롤백
urc2 revision promote "description"
변경사항을 취소하기 위해 현재 리비전으로 에셋 되돌리기
urc2 file reset .\pathname
자신의 차단을 해제하기 위해 특정 팀원이 서명한 에셋 릴리즈
urc2 lock release --force --owner <username>
언리얼 리비전 컨트롤(Unreal Revision Control, URC) 명령줄 인터페이스(Command Line Interface, CLI)는 PowerShell 같은 서드파티 명령줄 툴을 사용하여 프로젝트에서 리비전 컨트롤 작업을 수행할 수 있게 해 줍니다. 이러한 작업은 보통 유저 인터페이스를 통해 수행할 수 있지만, 일부 작업은 현재 인터페이스에서 지원되지 않을 수도 있습니다.
이 문서에서는 다음에 대한 개요를 제공합니다.
CLI 시작 방법
CLI의 일반적인 사용 사례와 구현 방법
시작하기 전에
명령줄을 사용하려면 먼저 Windows 탐색기에서 URC 파일이 어디 있는지 알아야 하며, URC로 명령줄을 생성 및 사용할 수 있도록 환경 변수를 구성해야 합니다.
환경 변수를 설정하기 전에, 경로 변수 내에 urc.exe가 있는 폴더를 설정합니다.
Windows에서 '설정(Settings)'을 열고 시스템(System) > 정보(About) > 고급 시스템 설정(Advanced system settings)을 선택합니다. 그러면 시스템 속성(System Properties) 창이 열립니다.
환경 변수...(Environment Variables...)를 클릭합니다.
이미지를 클릭하면 확대됩니다.
사용자 변수(User variables) 목록에서 Path > 편집(Edit)을 선택하여 경로의 환경 변수를 편집합니다.
이미지를 클릭하면 확대됩니다.
이름은 C:\Users\ 뒤에 표시됩니다.
찾아보기(Browse)를 선택하고 urc.exe 파일로 가는 파일 경로를 선택합니다. 일반적으로
C:\Program Files\Epic Games\Fortnite\FortniteGame\Binaries\Win64에서 찾을 수 있습니다.클릭하면 이미지가 확대됩니다. 열린 창이 모두 닫힐 때까지 확인(OK)을 클릭합니다.
이제 환경 변수를 모두 편집했습니다.
PowerShell 실행하기
현재 Windows 탐색기에서 작업 중이던 포트나이트 언리얼 에디터(Unreal Editor for Fortnite, UEFN) 프로젝트를 실행합니다.
다른 URC CLI 명령을 사용하기 전에 먼저 UEFN에 로그인해야 합니다.
이것은 최근에 UEFN에 로그인했는지 여부에 따라 달라집니다. UEFN이 실행되어 있고 로그인되어 있는 경우 토큰이 만료되지 않는 한 urc auth login을 호출하지 않아도 됩니다. 하지만 UEFN이 실행되어 있지 않거나 토큰이 만료된 후 CLI를 사용하는 경우 CLI에 로그인해야 합니다.
Shift + 우클릭으로 컨텍스트 메뉴를 엽니다.
여기에 PowerShell 창 열기(Open PowerShell window)를 선택합니다.
일반적인 CLI 사용 사례
계정에 로그인하면 액세스 가능한 모든 프로젝트가 나열됩니다.
| CLI 명령 |
|---|
urc project list |
urc p list |
이미지를 클릭하면 확대됩니다.
프로젝트의 모든 스냅샷을 확인합니다.
| CLI 명령 |
|---|
urc project snapshot list |
urc p s list |
이전 스냅샷과 동기화하여 프로젝트 히스토리로 돌아갑니다.
프로젝트 파일의 동기화가 실패하는 것을 방지하려면 특정 스냅샷으로 동기화하기 전에 프로젝트 또는 에디터를 닫습니다.
| CLI 명령 |
|---|
urc project snapshot get <number of snapshot> |
urc p s get <number of snapshot> |
이미지를 클릭하면 확대됩니다.
최신으로 동기화하여 섬에 대한 모든 업데이트를 얻습니다.
| 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 |
이미지를 클릭하면 확대됩니다.
Plugins 폴더를 복사해 데스크톱으로 붙여넣어 에셋의 백업을 유지합니다.
그런 다음, 최신 스냅샷으로 다시 동기화합니다.
| CLI 명령 |
|---|
urc projects snapshots get |
최신 스냅샷으로 프로젝트를 동기화하는 데 성공한 후에는 다음 단계를 따릅니다.
현재 UEFN 프로젝트 폴더에서 플러그인을 삭제합니다.
이전 Plugins 폴더를 데스크톱에서 프로젝트 폴더로 복사하여 붙여넣습니다.
UEFN에서 프로젝트를 열고 프로젝트 상태가 의도한 대로 표시되는지 확인합니다.
프로젝트가 의도한 대로 표시되면 변경사항 체크인(Check In Changes)을 클릭하여 프로젝트의 새 상태를 반영하는 새 스냅샷을 생성합니다.
에셋을 현재 스냅샷으로 되돌리면 변경사항을 취소할 수 있습니다.
| CLI 명령 |
|---|
urc asset revert .\pathname |
urc a revert .\pathname |
이미지를 클릭하면 확대됩니다.
특정 팀 멤버가 체크아웃한 에셋을 릴리즈하면 다른 사람의 방해를 받지 않고 작업을 계속할 수 있습니다.
프로젝트 ID를 구해 크리에이터 포털에서 프로젝트를 엽니다. 프로젝트 ID는 URL에서 확인할 수 있습니다.
이미지를 클릭하면 확대됩니다.
이 기능은 팀 관리자만 수행할 수 있습니다. 자신의 팀 역할은 크리에이터 포털에서 확인할 수 있습니다.
| CLI 명령 |
|---|
urc project forcerelease <projectID> –-user 사용자 이름 |
urc p forcerelease <projectID> –-user 사용자 이름 |
이미지를 클릭하면 확대됩니다.