턴키(Turnkey) 는 언리얼 엔진 5 에 도입된 시스템으로, SDK 설치 및 개발 키트 플래싱을 위한 소스 파일 검색을 비롯하여 플랫폼 지원 구성에 필요한 단계 대부분을 자동화합니다.
조직 내에 턴키용 파일 소스 저장소를 구성하고 나면 각 팀원은 타깃 플랫폼용 시스템을 클릭 한 번으로 간편하게 구성할 수 있습니다. 이 페이지에 나와 있는 가이드는 턴키용 SDK를 호스팅하는 방법과 턴키를 사용하여 언리얼 엔진의 개별 인스턴스에 SDK를 다운로드 및 설치하는 방법을 안내합니다.
개요
턴키는 RunUAT.bat
를 통해 액세스할 수 있는 AutomationTool SDK와 인터랙션하는 데 사용할 수 있는 다양한 툴을 갖추고 있습니다. 턴키는 조직용으로 구성한 저장소에 액세스하여 해당 저장소에서 자동으로 파일을 다운로드하고 SDK를 구성합니다.
SDK를 설치하기 위해 턴키를 실행하면 다음과 같은 프로세스가 실행됩니다.
- 턴키가 실행되어
TurnkeyManifest.xml
에서 제공된 정보를 사용하여 SDK를 스캔합니다. - 턴키에서 사용자의 입력을 기반으로 플랫폼을 선택합니다.
- 빌드 시스템에서 현재 언리얼 엔진 버전에서 유효한 SDK 버전을 턴키에 알려줍니다.
- 사용할 수 있는 모든 유효한 SDK 중에서 최적의 SDK가 선택됩니다.
- 턴키는 일련의 플랫폼별 규칙을 사용하여 버전 번호를 정수로 변환하며, 유효한 SDK 범위 중 가장 큰 숫자가 선택됩니다. 이러한 규칙은
*PlatformSDK.cs
파일에 지정됩니다.
- 턴키는 일련의 플랫폼별 규칙을 사용하여 버전 번호를 정수로 변환하며, 유효한 SDK 범위 중 가장 큰 숫자가 선택됩니다. 이러한 규칙은
- 턴키에서 해당하는 SDK 파일을 사용자의 머신에 다운로드합니다.
- SDK 파일이
.zip
파일에 포함되어 있는 경우 임시 위치에 자동으로 압축이 해제됩니다.
- SDK 파일이
- 빌드 시스템에서 다운로드된 SDK를 설치합니다.
이를 통해 사용할 수 있는 SDK 버전이 여러 개인 경우에도 언리얼 엔진 프로젝트를 빠르게 구성할 수 있으며, 이러한 SDK를 업데이트해야 할 때도 언제든 유지보수를 간소화할 수 있습니다.
턴키 구성하기
턴키를 사용하려면 파일 소스 저장소에서 SDK를 호스팅한 후 턴키가 해당 SDK를 검색하는 데 필요한 정보와 함께 TurnkeyManifest.xml
및 TurnkeyStudioSettings.xml
파일을 구성해야 합니다.
아래에 나와 있는 페이지에서 위에서 언급된 컴포넌트를 구성하는 방법과 턴키 자동화에서 SDK 버전을 인식할 수 있도록 디렉터리를 구조화하는 방법에 대한 지침을 확인할 수 있습니다.
사용
조직에서 사용할 턴키를 구성한 후에는 언리얼 엔진에서 직접 또는 RunUAT.bat
를 사용하여 명령줄 인터페이스로 인터랙션할 수 있습니다. 아래에 나와 있는 페이지에서 이러한 사용법에 대한 정보를 확인할 수 있습니다.