언리얼 엔진(UE)에서는 Android Studio 및 Android SDK 명령줄 툴을 사용하여 Android 프로젝트 개발에 필요한 Android SDK 컴포넌트를 다운로드하고 설치합니다.
설치 요약
Android SDK 설치 절차는 다음과 같습니다.
턴키(Turnkey)를 실행하여 필요한 Android Studio 버전을 자동으로 다운로드하고 설치합니다.
Android Studio 설치를 환경설정하여 Android SDK 명령줄 툴을 다운로드합니다.
Android Studio를 닫고 필요한 Android SDK 컴포넌트를 턴키가 계속 설치하도록 합니다.
컴퓨터를 재부팅합니다.
이러한 절차에 대해서는 아래 섹션에서 더 자세히 설명합니다.
Android SDK 명령줄 툴을 설치하지 않은 경우, 턴키는 Android SDK 및 기타 필요한 컴포넌트를 다운로드하지 못합니다. 그러니 이 단계를 건너뛰지 않도록 하세요!
필수 버전
다음은 언리얼 엔진에서 Android 프로젝트를 개발하는 데 필요한 필수 소프트웨어 컴포넌트입니다.
2024년 8월 31일부터 Google Play Store에서는 앱이 API 레벨 34가 필요한 Android 14를 타기팅해야 합니다. Google Play Store에 새 앱을 퍼블리시하려면 타깃 SDK 34 지원을 위해 UE 5.4.4 이상으로 업데이트해야 합니다. 이전 버전의 UE로 빌드된 앱은 더 이상 성공적으로 제출되지 않습니다.
자세한 내용은 Google Play의 타깃 API 레벨 요구 사항에 대한 Android 문서를 참조하세요.
현재 UE 버전: 5.6
Android Studio 버전: Koala 2024.1.2 2024년 8월 29일
Android SDK:
권장 버전: SDK 34
컴파일 최소 버전: SDK 34
디바이스에서 출시하기 위한 디폴트 타깃 SDK: 34
최소 설치 SDK 레벨: 26
스토어마다 고유한 타깃 SDK 최소 요구사항이 있으며 위에서 언급한 것과 다를 수 있습니다.
NDK 버전: r25b
빌드 툴: 34.0.0
Java 런타임: OpenJDK 21.0.3 2024-04-16
AGDE 디버깅에는 AGDE v23.2.91 이상이 필요합니다.
필수 설정
이 설치 가이드를 사용하려면 언리얼 엔진 5.4 이상 버전이 설치되어 있어야 합니다. Android 턴키 설치 프로세스는 UE 5.3 이하 버전에서는 사용할 수 없습니다. 해당 버전에 대한 설치 지침은 고급 Android Studio 구성 가이드를 참조하세요.
턴키를 실행하여 Android Studio 설치 시작하기
UE에서는 턴키라는 언리얼 자동화 툴(Unreal Automation Tool) 스크립트를 사용하여 팀 전체에 SDK를 배포합니다. 일반적으로 턴키를 사용하려면 팀의 공통 위치에 플랫폼의 SDK 설치 파일이 있어야 합니다. 그러나 Android Studio는 공개적으로 사용할 수 있으므로 턴키가 이를 자동으로 다운로드하고 추가 단계 없이 구성을 시작할 수 있습니다.
턴키에 대한 자세한 내용은 턴키 문서를 참조하세요.
언리얼 에디터에서 턴키 실행하기
언리얼 에디터에서 Android 턴키 설치 프로세스를 실행하는 절차는 다음과 같습니다.
언리얼 에디터(Unreal Editor)를 엽니다.
플랫폼(Platforms) > Android > SDK 설치(Install SDK)를 클릭합니다.
명령줄에서 턴키 실행하기
명령줄에서 Android 턴키 설치 프로세스를 실행하는 절차는 다음과 같습니다.
명령줄을 엽니다.
언리얼 엔진 설치 디렉터리로 이동하여 다음 명령을 실행합니다.
Commandline
C++RunUAT.bat Turnkey -Command=InstallSDK Platform=Android
Android Studio 및 Android 명령줄 툴 구성하기
어떤 메서드를 사용하여 턴키를 실행하든 턴키는 Android Studio를 다운로드하고 자동으로 설치를 시작합니다. 그렇지만 설치를 계속 진행하기 전에 설치 마법사를 통해 직접 Android SDK 명령줄 툴을 다운로드하여 턴키가 UE에 필요한 다른 컴포넌트를 가져올 수 있도록 해야 합니다. 설치를 완료하는 절차는 다음과 같습니다.
컴포넌트 선택 메시지가 표시되면 디폴트 컴포넌트가 활성화된 상태로 둡니다.
설치 디렉터리 선택 메시지가 표시되면 디폴트 디렉터리를 사용합니다.
디폴트 설치 디렉터리를 사용하지 않으면 턴키가 이후 단계에서 필요한 파일을 찾지 못합니다. 디폴트 디렉터리를 그대로 사용하는 것을 강력하게 권장합니다. 별도의 디렉터리를 타기팅하려면 고급 Android Studio 구성 가이드를 참조하세요.
설치가 완료되면 Android Studio를 엽니다.
Welcome to Android Studio(Android 스튜디오 시작) 대화창에서 추가 액션(More Actions)을 클릭하고 SDK 매니저(SDK Manager)를 클릭합니다.
그러면 모양과 동작(Appearance and Behavior) > 시스템 세팅(System Settings) > Android SDK에 Android Studio 세팅 메뉴가 열립니다.
SDK 툴(SDK Tools) 탭을 클릭합니다.
Android SDK 명령줄 툴(최신)(Android SDK Command-Line Tools (latest))을 확인한 다음 적용(Apply)을 클릭합니다. 그러면 UE용 Android Studio를 자동으로 환경설정하는 데 필요한 명령줄 툴이 다운로드됩니다.
확인(OK)을 클릭하여 세팅 창을 닫은 다음 Android Studio 시작(Welcome to Android Studio) 대화창을 닫습니다.
Android Studio를 닫고 언리얼 에디터나 명령줄로 돌아갑니다.
SDK 구성 마무리 및 검증하기
Android Studio를 닫으면 턴키가 다른 Android SDK 컴포넌트 다운로드 및 설치를 재개합니다. 이 프로세스가 완료되면 성공 여부를 알려주는 메시지가 표시됩니다.
Android SDK 설치를 마무리하고 제대로 작동하는지 확인하는 절차는 다음과 같습니다.
언리얼 에디터나 명령줄을 닫습니다.
Android 환경 변수를 완료하려면 해당 머신에서 로그아웃한 다음 다시 로그인합니다.
언리얼 에디터를 열고 플랫폼(Platforms) > Android를 클릭합니다. 허용되는 SDK 버전과 설치된 SDK 버전이 일치해야 하며 Android SDK 설치 버튼이나 복구 버튼이 보이면 안 됩니다.
문제 해결
새로운 시스템에서 설치한 경우 위의 절차대로 진행하면 SDK 구성이 정상으로 작동합니다. 하지만, 오래된 환경 변수 및 설치로 인해 충돌이 발생할 수 있습니다. Android SDK 구성을 가로막는 특정 문제를 진단하고 해결하는 방법에 대한 자세한 내용은 고급 Android Studio 구성 가이드를 참조하세요.