턴키 명령줄 사용

RunUAT.bat에서 명령줄 인터페이스를 사용하여 턴키를 실행하는 방법을 설명하는 참조 정보입니다.

Choose your operating system:

Windows

macOS

Linux

턴키(Turnkey) 는 `RunUAT.bat`에서 액세스할 수 있는 **언리얼 빌드 툴(UBT)** 스크립트입니다. 언리얼 에디터 내에서 턴키를 사용하는 툴만으로도 대다수의 사용자에게는 충분하지만, 명령줄은 SDK를 관리하는 데 보다 세부적인 고급 옵션을 제공합니다. 이 가이드에서는 턴키 명령줄 액세스 방법과 이 명령줄의 다양한 옵션에 대한 레퍼런스를 살펴봅니다.

턴키 명령줄 액세스

명령줄을 사용하여 턴키에 액세스하려면 다음 단계를 따르세요.

  1. Windows 명령 프롬프트 같은 원하는 명령줄을 실행합니다.

  2. 언리얼 엔진이 설치된 디렉터리로 이동합니다.

  3. `RunUAT.bat turnkey`를 입력하여 턴키를 실행합니다.

이 명령줄은 잠시 동안 AutomationTool을 빌드한 후 턴키 스크립트를 실행하여 번호가 지정된 명령 목록을 표시합니다.

턴키 명령줄 인터페이스

이 메뉴에서 명령에 해당하는 번호를 입력하고 Enter 키를 눌러 실행할 수 있습니다. 이러한 명령 대부분은 해당 명령과 관련된 추가 옵션을 제공하는 서브메뉴를 표시합니다.

모든 메뉴에 0 을 입력하면 현재 작업을 취소합니다. 서브메뉴에서 취소하면 턴키 메인 메뉴로 돌아가고, 메인 메뉴에서 취소하면 스크립트가 중지 및 종료됩니다. 아래 섹션에는 사용할 수 있는 다른 명령과 해당 명령의 서브메뉴가 나와 있습니다.

턴키 명령줄 인수 사용

또 다른 방법으로는 .bat 파일을 실행할 때 일련의 지정자를 추가하면 이러한 알림을 건너뛰고 명령을 즉시 실행할 수 있습니다. -command=[command name] 인수를 사용하여 명령을 선택한 후 다른 옵션을 처리할 추가 지정자를 제공합니다.

예를 들어 다음 입력은 플랫폼이 Android로 설정된 InstallSdk 명령을 실행합니다.

`RunUAT.bat turnkey -command=InstallSdk -platform=Android`

사용 가능한 지정자에 대한 자세한 내용은 아래 섹션을 참고하세요.

SDK 설치

InstallSdk 명령을 사용하면 턴키에서 어떤 유형의 SDK를 설치할지 선택하라는 알림을 표시합니다.

SDK 설치 메뉴

옵션은 다음과 같습니다.

  1. `Full or Auto Sdk`는 AutoSDK와 전체 SDK 중에서 하나를 설치하려고 시도하며 가능한 경우 AutoSDK를 선택합니다.

  2. `Full SDK`는 프로젝트에서 사용할 수 있고 모든 컴포넌트 배열을 갖춘 전체 SDK를 다운로드합니다.

  3. `AutoSdk`는 가능한 경우 AutoSDK를 설치하려고 시도합니다.

  4. `Device Software / Flash`는 프로젝트에서 사용할 수 있는 플래시 SDK 중에서 가장 적합한 것을 다운로드하며, 개발 키트 플래싱 및 테스트에 필요한 컴포넌트만 갖춥니다.

선택된 SDK 유형을 턴키에서 검색하지 못하면 작업을 멈추고 오류를 표시합니다.

SDK 유형을 선택한 후에는 턴키에서 어떤 플랫폼의 SDK를 설치할지 선택하라는 알림도 표시합니다.

플랫폼 선택 메뉴

구성하려는 플랫폼의 번호를 입력하면 턴키에서 해당 플랫폼의 SDK를 다운로드 및 설치하는 프로세스를 시작합니다. 사용 가능한 SDK가 없으면 프로세스가 실패하고 오류 메시지가 표시되며 메인 메뉴로 돌아갑니다.

지정자

다음 지정자는 명령줄에 `-command=InstallSdks`를 사용하는 경우 호환됩니다.

지정자

설명

-Platform=

플랫폼을 선택합니다. 플랫폼 선택 알림에 표시된 플랫폼 이름을 사용합니다. 예를 들어 -Platform=Win64`는 유효하지만 -Platform=Windows`는 유효하지 않습니다. 이 지정자를 사용하면 플랫폼 선택 서브메뉴를 건너뜁니다.

`-Platform=All`은 사용 가능한 모든 플랫폼을 대상으로 반복작업합니다.

-NeededOnly

턴키가 SDK 유형으로 AutoSDK를 검색하도록 지정합니다.

-BestAvailable

턴키가 SDK 유형으로 전체 SDK를 검색하도록 지정합니다. '-NeededOnly'와 조합하면 전체 SDK나 AutoSDK 중 하나를 검색합니다.

-UpdateOnly

턴키가 전체 설치를 수행하지 않고 이미 설치된 SDK를 업데이트하도록 지정합니다.

Auto Install All Needed SDKs 명령은 -command=InstallSdk -Platform=All -NeededOnly -BestAvailable 지정자와 함께 턴키를 실행합니다. 이는 전체 또는 AutoSDK를 선택하고 플랫폼을 모두 해당(All of the Above) 으로 선택한 것과 같습니다.

Auto Update Installed Sdks 명령은 -command=InstallSdk -Platform=All -UpdateOnly -BestAvailable 지정자로 턴키를 실행합니다.

SDK 검증

'VerifySdk' 명령은 검증할 SDK의 플랫폼을 선택하라는 알림을 표시합니다. 그러면 턴키에서 현재 SDK 설치와 관련된 정보를 출력하고, 이것이 언리얼 엔진에서 예상하는 파라미터와 일치하는지 확인합니다.

턴키 검증 SDK 예시

지정자

-command=VerifySdk`는 -Platform=` 지정자와 호환됩니다.

빌드 실행

ExecuteBuild 명령을 실행하면 선택된 플랫폼용 프로젝트를 빌드합니다. 이 옵션을 선택하면 타깃 플랫폼 목록이 표시되고, 빌드할 프로젝트를 나열한 알림도 이어서 표시됩니다.

프로젝트 선택 메뉴

프로젝트는 인식된 .uproject 이름을 기반으로 합니다. 예를 들어 `ShooterGame`은 샘플 프로젝트로 나열됩니다. 플랫폼과 프로젝트를 선택하면 턴키에서 프로젝트의 쿠킹 및 패키징 프로세스를 시작합니다.

지정자

-command=ExecuteBuild`는 -platform= 지정자와 호환됩니다. 또한 -project=` 지정자를 사용하여 인식된 프로젝트 이름을 선택하고 선택 알림을 건너뛸 수도 있습니다. 예를 들어 다음 입력은 Win64 플랫폼용 'ShooterGame'을 빌드하려고 시도합니다.

`RunUAT.bat Turnkey -command=ExecuteBuild -platform=Win64 -Project=Shootergame`

빌드 설치

턴키를 사용하여 빌드를 설치하는 기능은 현재 언리얼 엔진 5의 얼리 액세스 빌드에서 개발 중이며 최종 출시 버전에서는 안정성이 개선될 것입니다.

InstallBuild 명령을 실행하면 디바이스에 설치할 준비가 된 기존에 생성된 빌드 목록과 컴퓨터에 연결된 유효한 디바이스 목록을 함께 표시합니다. 두 개를 모두 선택하면 턴키에서 선택된 디바이스에 빌드를 설치합니다.

지정자

-command=InstallBuild`는 -platform= 지정자와 호환됩니다. -device=` 지정자도 사용할 수 있습니다. 디바이스 포맷은 [플랫폼 유형]@[디바이스 이름]으로, 여기에서 플랫폼 유형은 턴키에서 인식되는 플랫폼이고 디바이스 이름은 컴퓨터에 표시되는 디바이스 ID입니다. 예를 들어 -device=Android@ABCXYZ123과 같이 사용할 수 있습니다. 디바이스 목록과 ID를 확인하려면 ListPlatforms를 사용하면 됩니다.

도움말

Help 명령은 턴키 구성 및 사용 방법에 대한 정보를 제공하는 도움말 메뉴를 실행합니다. 여기에는 `TurnkeyManifest.xml`에서 FileSource 항목의 포맷을 지정하는 방법과 일부 플랫폼의 특정 버전 지정 포맷에 대한 정보가 포함됩니다.

플랫폼 정보 나열

ListPlatforms 명령을 실행하면 선택된 플랫폼용으로 구성된 SDK와 디바이스 관련 정보를 나열합니다. 여기에는 현재 언리얼 엔진 버전과 호환되는 SDK 버전 및 네트워크에 표시되는 디바이스와 관련된 정보가 포함됩니다.

플랫폼 정보 출력 예시

지정자

-command=ListPlatforms`는 -platform=` 지정자와 호환됩니다.

SDK 나열

ListSdks 명령은 FileSource 저장소에서 사용할 수 있는 SDK 목록을 출력합니다. 턴키에서는 SDK를 나열할 플랫폼을 선택하라는 알림을 표시합니다.

지정자

-command=ListSdks`는 -platform=` 지정자와 호환됩니다.

세팅 관리

ManageSettings 명령은 환경설정할 수 있는 일련의 변수를 표시합니다. 이는 조직의 사본 제공자 세팅 및 특정 플랫폼에 대한 크리덴셜과도 관련이 있습니다. 이러한 변수는 보통 MobileProvision.ini`나 TurnkeyStudioSettings.xml` 파일 같이 서로 다른 여러 파일에 있지만, 이 명령을 사용하면 해당 변수들을 한 곳에서 오버라이드할 수 있습니다.

지정자

-command=ManageSettings`는 -ListOnly 지정자와 호환됩니다. 환경설정 가능한 모든 변수의 목록과 각 변수의 수행 작업에 대한 설명이 표시됩니다. 턴키 메뉴의 List Settings 명령은 -command=ManageSettings -ListOnly`를 실행합니다.

디바이스 제어

Control 명령은 디바이스를 원격 제어할 수 있는 메뉴를 실행합니다. 플랫폼을 선택하면 컴퓨터에 표시되는 플랫폼과 일치하는 디바이스가 모두 표시됩니다.

디바이스 제어 메뉴

그런 다음 디바이스를 켜고 끄거나, 재부팅하거나, 연결 또는 연결 해제할 수 있습니다. 이 기능은 언리얼 에디터의 디바이스 매니저에서 제공하는 기능과 동일합니다.

턴키 테스트

Test 명령은 분석 테스트를 실행하여 환경이 올바르게 구성되어 있는지 확인합니다. 이 테스트는 선택된 사본 제공자와 연결을 시도하고 필요한 디렉터리를 확인합니다. 프로세스 중 어느 한 부분이라도 실패하면 오류가 보고됩니다.

턴키 테스트 출력 예시