
이 가이드에서는 언리얼 게임 동기화(UnrealGameSync, UGS) 를 사용하여 언리얼 프로젝트(.uproject
)를 동기화하는 기본 워크플로를 살펴봅니다. 이 튜토리얼을 마치면 UGS가 포함된 언리얼 프로젝트를 여는 방법과 애플리케이션 메인 메뉴의 프로젝트 개요(Project Overview) 및 체인지리스트 영역(Changelist Areas) 에서 동기화하는 방법을 알 수 있습니다.
필수 구성: 다음 단계에서는 머신에 UGS가 배포 및 구성되어 있다고 가정합니다.
1 - 로컬 파일 열기
다음 단계에서는 UGS를 사용하여 로컬 언리얼 프로젝트 파일을 여는 방법을 살펴봅니다.
-
프로젝트 열기...(Open project...) 링크를 클릭하여 로컬 드라이브에서
.uproject
를 엽니다. -
프로젝트 열기 창이 열리면 UGS에서 로컬 파일(Local File) 라디오 버튼이 기본적으로 활성화됩니다. 로컬 파일을 선택하려면 탐색...(Browse...) 버튼을 클릭합니다.
-
.uproject
파일을 찾아서 선택한 다음 열기(Open) 를 클릭합니다.여기에서는 언리얼 프로젝트 예시로 라이라 샘플 게임이 사용됩니다.
-
확인(Ok) 버튼을 클릭하여 UGS를 사용하여 언리얼 프로젝트를 엽니다.
2 - 워크스페이스 파일 열기
다음 단계에서는 UGS를 사용하여 워크스페이스 언리얼 프로젝트 파일을 여는 방법을 살펴봅니다.
-
프로젝트 열기... 링크를 클릭하여 로컬 드라이브에서
.uproject
파일을 엽니다. -
프로젝트 열기 창이 열리면 UGS에서 로컬 파일 라디오 버튼이 기본적으로 선택됩니다. 워크스페이스(Workspace) 라디오 버튼을 선택하여 작업을 시작합니다.
-
가장 먼저 워크스페이스의 이름 필드를 채워야 합니다. 이미 UGS를 연결할 워크스페이스가 있으면 이름:(Name:) 필드 옆에 있는 탐색... 버튼을 클릭합니다.
새 워크스페이스를 생성해야 하는 경우 신규...(New...) 버튼을 클릭하여 새 워크스페이스를 구성합니다.
-
워크스페이스 선택(Select Workspace) 메뉴가 열리면 선택할 수 있는 워크스페이스 목록이 표시됩니다. 계속해서 워크스페이스(1) 를 선택하고 확인 버튼(2) 을 클릭합니다.
-
이제 경로:(Path:) 필드 옆에 있는 탐색... 버튼을 클릭합니다.
-
프로젝트 선택(Select Project) 메뉴가 열리면 워크스페이스 트리를 확장하고
.uproject
파일 (1) 을 선택하고 확인 버튼 (2) 을 클릭합니다.여기에서는 언리얼 프로젝트 예시로 라이라 샘플 게임이 사용됩니다.
-
이제 워크스페이스 이름 과 경로 가 지정되었으므로 확인 버튼을 클릭하여 UGS를 사용하여 언리얼 프로젝트를 열 수 있습니다.
3 - 체인지리스트 영역에서 동기화하기
USG를 사용하여 프로젝트를 열었으므로 이제는 UGS를 통해 일반적인 작업을 수행하고 체인지리스트 영역 에서 동기화할 수 있습니다.
다음 단계를 진행하기 전에 Perforce 에 로그인되어 있는지 확인합니다.
-
UGS를 사용하여 프로젝트를 열었으므로 메인 메뉴 에서 체인지리스트 영역 을 찾습니다.
-
수행하려는 변경사항을 찾습니다. 옆에 화살표 아이콘 이 표시됩니다.
-
프로젝트의 스트림에 커밋된 다른 변경사항을 업데이트하려면 체인지리스트 영역 내에서 다른 변경사항을 더블클릭합니다.
동기화가 완료되면 UGS에서 출력 로그(Output Log) (3), 체인지리스트 영역 (2), 프로젝트 개요 영역(Project Overview Area) (1)(다음 단계에서 프로젝트 동기화되는 부분)이 업데이트됩니다.

4 - 프로젝트 개요 영역에서 동기화하기
체인지리스트 영역 에서 동기화를 수행하고 UGS를 사용하여 프로젝트를 이미 열었으므로, 이제는 UGS를 통해 다른 일반적인 작업을 수행하고 프로젝트 개요 영역 에서 동기화할 수 있습니다.
-
먼저 메인 메뉴 에서 프로젝트 개요 영역 을 찾습니다.
-
지금 동기화 - 대상...(Sync Now - To...) 버튼 링크 옆에 있는 아래쪽 화살표 버튼을 클릭하여 바로가기 메뉴를 엽니다.
-
이제 최신 변경사항(Latest Change) 옵션을 선택합니다.
인터페이스 탐색, 옵션, UGS에 포함된 메뉴에 대한 자세한 내용은 UGS 레퍼런스 가이드를 확인하세요.
동기화가 완료되면 UGS에서 최신 변경사항 으로 성공적으로 업데이트되었다는 알림이 표시됩니다.

이것으로 이 가이드의 설명을 마칩니다. 지금까지 프로젝트를 열고 유저 인터페이스의 체인지리스트 및 프로젝트 개요 영역 에서 동기화하는 방법을 알아봤습니다. 프로젝트의 바이너리 버전 디플로이 또는 전체 메뉴 및 옵션이 포함된 인터페이스 사용 방법을 포함하여 계속해서 UGS에 대해 자세히 알아보려면 이 가이드의 다음 섹션을 참고하세요.
5 - 직접 해보기!
프로젝트를 열고 UGS를 사용하여 몇 가지 일반적인 동기화 방법을 수행하는 방법을 알아봤으므로, 이제 다음을 시도할 수 있습니다.
-
언리얼 프로젝트 동기화, 빌드 및 실행을 위해 UGS 메인 메뉴 하단에 있는 빌드(Build) 및 실행(Run) 체크박스를 활성화합니다.
-
UGS 레퍼런스 가이드는 소스에서 컴파일이 필요하지 않은 크리에이터를 위해 사전 컴파일된 바이너리 기능을 사용하려는 개발자에게 도움이 됩니다. 여기에서는 에디터 바이너리가 포함된 zip 파일을 Perforce에 주기적으로 제출하여 UGS가 크리에이티브 워크스페이스에 추출할 수 있도록 빌드 시스템을 구성하는 방법을 확인할 수 있습니다.