언리얼 엔진의 언리얼 게임 싱크 클라이언트 설정 | 언리얼 엔진 5.3 문서

이 가이드에서는 신규 사용자를 위해 언리얼 게임 싱크(UnrealGameSync, UGS) 클라이언트 를 설정하는 가장 간단한 방법을 설명합니다. 더 자세한 정보나 추가적인 방법을 알아보려면 UGS 퀵스타트 가이드를 참조하세요. 여기서는 또한 사용자의 팀에서 이미 퍼포스(Perforce) 서버를 설정하고 적절한 소스와 콘텐츠 파일을 모두 추가했으며 UGS를 사용할 기기에 적절한 버전의 퍼포스를 설치하였고 UGS를 사용할 팀원에게 모두 배포했다고 가정하고 설명합니다.

더 자세한 설정 정보가 필요한 경우에는 UGS 개요를 참조해주세요.

UGS를 설치하기 전에 Perforce Workspace를 설정하여 프로젝트를 동기화하려는 스트림을 가리키도록 했는지 확인합니다. 워크스페이스의 로컬 경로는 가능한 한 짧게 만듭니다.

일반적으로 퍼포스(P4) 설정은 버전 관리 시스템을 다뤄 봤으며 언리얼 엔진(UE) 과 함께 사용해 본 경험이 있는 사람이 수행합니다. 퍼포스에서 적절한 권한은 모두 가지고 있지만 파일을 보는 데 문제가 생기는 이유는 퍼포스가 구버전이어서 에픽 툴의 최신 기능을 처리하지 못하기 때문일 수 있습니다. 2020.1 버전부터는 UGS 작업을 할 수 있습니다.
스튜디오에서 UGS의 오너가 배포한 UGS 인스톨러(UGS Installer) 를 실행합니다. 실행 시 관리자 권한이 있는지 확인해주세요.
UGS가 시작되면 이러한 UI가 표시됩니다.
- 서버(Server) 및 사용자(User) 필드에 P4V를 통해 연결하기 위하여 사용하는 퍼포스 연결 세팅을 입력합니다.
- Depot 경로 를 퍼포스에서 UGS 바이너리가 저장되는 위치로 설정합니다.
- 이러한 필드가 퍼포스 크리덴셜 및 UGS 바이너리의 위치와 일치하는지 확인한 후에 연결(Connect) 을 클릭합니다.
UGS가 퍼포스 서버에 성공적으로 연결되면 시작하기(Getting Started) 메뉴가 나타납니다. 프로젝트 열기(Open Project) 를 클릭합니다.
프로젝트 열기(Open Project) 대화창에서 탐색(Browse) 을 클릭하고 1단계에서 설정한 워크스페이스를 찾습니다.

프로젝트 열기(Open Project) 를 클릭한 후에는 UGS 퀵스타트 가이드에 자세히 설명된 워크스페이스 방법을 안전하게 따르며 프로젝트 파일을 열 수 있습니다. 로컬 파일(Local File) 방법을 사용하려면 UGS 퀵스타트 가이드의 로컬 파일 부분을 참조하세요. 이러한 단계는 업데이트된 스크린샷과 함께 여기에도 설명되어 있습니다.

Workspace가 설정된 방식에 따라, 사용자의 워크스페이스를 보려면 왼쪽 아래에 있는 이 컴퓨터용 워크스페이스만 표시(Only show workspaces for this computer) 를 체크 해제해야 할 수도 있습니다.
이전에 생성한 워크스페이스를 선택했다면 경로(Path) 필드 옆에 있는 탐색(Browse) 을 클릭하고 .uprojectdirs 파일(프로젝트 선택(Select Project) 대화창에서 .uprojectdirs 파일 표시(Show .uprojectdirs files) 를 활성화하여 표시) 또는 .uproject 파일을 해당 스트림의 프로젝트 중 하나에서 선택합니다. 이 예시에서는 .uprojectidirs 파일을 사용하겠지만, .uproject 파일 또한 손쉽게 선택할 수 있습니다.

그러면 경로(Path) 필드가 채워지고 확인(Ok) 을 눌러 계속할 수 있습니다.
머신에 모든 것을 동기화하고 프로젝트를 빌드 / 실행하는 과정을 진행하기에 앞서, UGS 싱크 필터 설정 문서를 다시 보면서 싱크 필터(Sync Filters) 가 워크플로에 도움이 되는지 확인해보세요.

싱크 필터는 필요한 것보다 더 많은 데이터를 동기화하지 않도록 하는 데 유용합니다. 예를 들어 동일한 스트림에 대규모 프로젝트가 여러 개 있다면, 작업할 프로젝트만 동기화하도록 필터를 설정할 수 있습니다. 이는 매우 강력한 도구지만 너무 광범위하게 적용하면 의도하지 않은 결과로 이어질 수 있습니다. 주의해서 사용하시고 의심스러운 경우에는 싱크 필터 사용에 익숙한 다른 팀원과 다시 확인하십시오.
프로젝트를 열고 나면 일반적으로 매일 작업하게 되는 메인 메뉴가 나타납니다.

이 메뉴에 관한 전체 개요는 UGS 메뉴 개요 문서를 참조해주세요.

빌드의 최신 체인지리스트와 동기화하기 위해서는, 체인지리스트(Changelists) 영역 제일 위에 있는 체인지리스트를 더블클릭하거나 프로젝트 개요(Project Overview) 영역에 있는 지금 동기화(Sync Now) 를 클릭합니다.

체인지리스트 영역에서 최신(Latest) 빌드를 선택합니다.

지금 동기화 를 선택합니다.

지금 동기화 로 동기화할 체인지리스트의 대상(To…) 에 선택할 수 있는 옵션은 최신(Latest) , 최신 승인(Latest Good) , 최신 표시(Latest Starred) 입니다. 이는 각각 최신 빌드, 최근에 승인된 빌드, 최근에 수동으로 표시한 빌드를 뜻합니다.
프로젝트가 동기화된 후에는 프로젝트 개요(Project Overview) 영역에 있는 Visual Studio 옵션을 사용하여 Visual Studio에서 프로젝트를 열 수 있으며, 사전 컴파일링된 바이너리를 사용하거나 에디터를 빌드한 경우에는 같은 영역에서 언리얼 에디터 옵션을 사용하여 프로젝트의 에디터를 열 수 있습니다.

이전에 프로젝트를 빌드하지 않았고 사전 컴파일링된 바이너리를 사용하지 않는 경우에는, 에디터를 열 때 프로젝트를 빌드하라는 메시지가 표시될 수 있습니다.

창 아래쪽에 있는 동기화 후(After syncing) 옵션을 사용하여 Visual Studio 프로젝트 빌드, 열기, 프로젝트 실행을 자동으로 할 수 있습니다.