Android SDK 및 NDK 설정

언리얼 엔진은 Android Native Development Kit(NDK) 등 모든 필수적인 Android 개발 컴포넌트에 Android 스튜디오 와 함께 배포된 Android Software Development Kit(SDK) 를 사용합니다. 본 페이지에서는 Android 스튜디오를 구성하고 언리얼 엔진이 컴포넌트를 올바르게 인식하는지 확인하는 방법을 단계별로 안내드리고, NDK 설치 및 이전 엔진 빌드의 관리 문제를 해결하는 팁을 제공합니다.

2023년 2월부터 Android SDK 명령줄 툴로 업데이트되면서 언리얼 엔진 4.27부터 5.1까지 사용하시는 분들은 이 튜토리얼에 사용되는 SetupAndroid 스크립트를 편집해야 합니다. NDK 설정에 문제가 있는 경우 Android용 명령줄 툴 구성하기 섹션에서 자세한 내용을 확인해 주세요.

권장 설정

NDK 컴포넌트 설치나 엔진의 환경 변수 설정 시, 문제가 발생하지 않도록 언리얼 에디터 와 에픽게임즈 런처 를 종료해야 합니다.

기존에 설치한 언리얼 엔진을 지원하려면 DK 경로 수동 타기팅 을 참조하세요. 사용 중인 언리얼 엔진 버전에 맞는 NDK 버전은 Android 개발 요구 사항 페이지를 참고하세요.

1. Android 스튜디오 설치

필수 SDK 및 NDK 컴포넌트를 컴퓨터에 설치하려면 먼저 Android 스튜디오 버전 3.5.3 부터 설치해야 합니다.

현재 사용 중인 언리얼 엔진과 호환되는 Android 스튜디오 및 NDK 버전에 대한 정보는 Android 개발 요구 사항을 참고하세요.

1. 웹 브라우저에서 Android 스튜디오 아카이브로 이동합니다. Android Studio 3.5.3 으로 스크롤을 내리고 드롭다운을 클릭하여 펼칩니다. 여기서 운영 체제에 맞는 설치 프로그램이나 zip 파일을 다운로드합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

2. Android 스튜디오 설치 프로그램 을 실행합니다. Welcome to Android Studio Setup 대화 상자에서 Next 를 클릭하여 진행합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

3. Choose Components 대화 상자에서 Next 를 클릭하여 계속 진행합니다. 기본 컴포넌트는 활성화된 상태로 놔두어도 됩니다.

   전체 크기로 보려면 이미지를 클릭하세요.

4. Configuration Settings 대화 상자에서 설치 위치를 선택하고 Next 를 클릭하여 계속 진행합니다. 기본 위치를 사용하는 것이 좋습니다.

   전체 크기로 보려면 이미지를 클릭하세요.

5. Choose Start Menu Folder 에서 Install 을 클릭하여 설치 프로세스를 시작합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

6. 설치가 완료되면 Next 를 클릭하여 컴포넌트 설정을 시작합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

7. 설정이 완료되면 Start Android Studio 박스가 체크되었는지 확인한 후 Finish 를 클릭하여 설치 프로그램을 종료합니다.

2. 첫 사용 시 Android 스튜디오 설정

Android 스튜디오를 처음으로 새로 설치하는 경우 다음 단계를 따릅니다.

1. Import Android Studio Settings 대화 상자가 표시되면 do not import settings 를 선택하고 OK 를 클릭하여 계속 진행합니다.

   (w:400)

2. Data Sharing 대화 상자가 나타나면 사용 통계를 Google로 전송할지에 대한 여부를 선택합니다. 이는 필요에 따라 선택할 수 있는 옵션이며, 무엇을 선택하든 다음 단계로 계속 진행됩니다.

   전체 크기로 보려면 이미지를 클릭하세요.

3. Android Studio Setup Wizard 가 나타납니다. Next 를 클릭하여 계속 진행합니다. 정확히 버전 4.0을 설치해야 하므로 업데이트 메시지가 표시되면 X 버튼을 클릭하여 메시지를 닫습니다.

   전체 크기로 보려면 이미지를 클릭하세요.

4. Install Type 대화 상자에서 Custom 을 선택하고 Next 를 클릭합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

5. Select default JDK Location 대화 상자에서 설치 위치가 기본값으로 설정되어 있는지 확인하고 Next 를 눌러 계속 진행합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

6. Select UI Theme 대화 상자에서 원하는 테마를 선택하고 Next 를 클릭합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

7. SDK Component Setup 에서 기본 컴포넌트를 활성화 상태로 유지하고 Next 를 클릭합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

8. Emulator Settings 창이 나타나면 사용 가능한 설정을 조정하거나, 기본값으로 유지합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

9. Verify Settings 대화 상자에서 Finish 를 클릭하여 설정을 완료하고 컴포넌트 다운로드를 시작합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

   기본 SDK 경로를 사용하지 않으면 이후 단계에서 필수 파일을 찾지 못해 SetupAndroid.bat 이 실패할 수 있습니다.

10. 컴포넌트를 다운로드한 후에는 Finish 를 다시 클릭하여 설정을 종료합니다.

3. Android용 명령줄 툴 설정

언리얼 엔진의 Android SDK 설정은 Android 버전 8.0 용 명령줄 툴에 의존합니다. 설치를 마무리하기 전에 이 버전이 설치되어 있고, UE의 SetupAndroid 스크립트가 대상으로 지정되어 있는지 확인해야 합니다.

1. Welcome to Android Studio 대화 상자에서 Android Studio를 최신 버전으로 업데이트하라는 메시지가 우측 상단에 표시됩니다. 이 메시지에 마우스를 놓고 업데이트하지 않고 취소합니다. 이렇게 하면 Configure 및 Get Help 드롭다운 상자가 나타납니다.

2. Configure 드롭다운에서 SDK Manager 를 클릭합니다.

   전체 크기로 보려면 이미지를 클릭하세요.

3. Android SDK 시스템 세팅에서 SDK Tools 탭을 클릭합니다. 이렇게 하면 컴포넌트 옵션 목록이 나타납니다.

   전체 크기로 보려면 이미지를 클릭하세요.

4. Android SDK Command-line Tools 버전 8.0 을 선택하고, Apply 를 눌러 이 컴포넌트를 다운로드하여 설치합니다.

   명령줄 툴 버전 전체가 표시되지 않으면 Show Package Details 를 눌러 모두 표시합니다.

5. OK 를 눌러 창을 닫고 시작 대화 상자를 종료합니다.

6. 언리얼 엔진 설치 디렉터리로 이동합니다(예: C:/Program Files/Epic Games/UE_4.27).

7. Engine/Extras/Android 를 엽니다.

8. 이 디렉터리에서 사용 중인 OS에 적절한 SetupAndroid 스크립트를 찾습니다. Windows의 경우 SetupAndroid.bat, Mac의 경우 SetupAndroid.command, Linux의 경우 SetupAndroid.sh 입니다.

   전체 크기로 보려면 이미지를 클릭하세요.

9. OS의 SetupAndroid 스크립트를 텍스트 에디터에서 열고 SDKMANAGERPATH 변수를 지정하는 라인을 찾습니다. SetupAndroid.bat 에서 이 라인은 다음과 같이 읽힙니다.

   set SDKMANAGER=%STUDIO_SDK_PATH%\cmdline-tools\latest\bin\sdkmanager.bat

   latest 디렉터리를 8.0 으로 바꿉니다. 다음과 같이 됩니다.

   set SDKMANAGER=%STUDIO_SDK_PATH%\cmdline-tools\8.0\bin\sdkmanager.bat

   스크립트를 저장하고 텍스트 에디터를 닫습니다.

4. OS에 Android 스튜디오 설치 마무리

위 단계를 모두 완료한 후에는 계속하기 전에 환경 설정이 완벽하게 끝났는지 확인하여 설치를 마무리해야 합니다. 설치를 마무리하는 작업 단계는 OS별로 다릅니다.

5. Android NDK 설정

필수 Android SDK 컴포넌트를 설치한 후에는 SetupAndroid 스크립트를 사용하여 적절한 Android NDK를 다운로드하여 설치할 수 있습니다.

1. Engine/Extras/Android 디렉터리를 열고 운영 체제에 맞는 적절한 SetupAndroid 스크립트를 실행합니다. Windows의 경우 SetupAndroid.bat, Mac의 경우 SetupAndroid.command, Linux의 경우 SetupAndroid.sh 입니다.

2. TAndroid SDK 라이선스 계약을 수락하라는 메시지가 표시됩니다. Y 를 입력하고 Enter 키를 눌러 수락합니다.

   Click image for full size.

3. 설치가 완료되면 아무 키나 눌러 명령 프롬프트를 닫고 프로세스를 마칩니다.

4. 컴퓨터를 다시 시작하여 모든 변경 사항을 적용합니다.

NDK 설치 디렉터리는 C:/Users/[Username]/AppData/Local/Android/SDK/ndk/ 여야 하고 여기서 'username'은 사용자의 컴퓨터 로그인 이름이어야 합니다. 그러면 이 위치에 필수 NDK 버전이 포함된 폴더가 나타납니다.

SDK 경로 수동 타기팅

위의 설명 섹션을 문제없이 수행했다면 언리얼 엔진은 Android SDK, 설치된 Android NDK 버전, Java Development Kit(JDK)의 SDK 경로를 자동으로 연결합니다. 그러나 Android Studio와 함께 이전 버전의 언리얼 엔진을 사용하는 경우에는 SDK 경로를 수동으로 대상으로 지정하여 호환해야 할 수도 있습니다. CodeWorks를 사용했던 이전 버전과 함께 언리얼 엔진을 설치한 경우에 가장 가능성이 높습니다다.

CodeWorks와 Android Studio를 동시에 설치하지 마세요. 오류가 발생합니다. 4.25 이상 버전과 함께 이전 버전의 언리얼 엔진을 지원해야 하는 경우 이 문서의 Android Studio 설정을 사용한 다음 이 섹션의 지침에 따라 필요한 Android Studio 버전의 경로를 지정하는 것이 좋습니다.

SDK 경로는 Edit > Project Settings 를 열고 Platforms > Android > Android SDK 섹션에서 찾을 수 있습니다.

(w:700)

이러한 필드를 비워 두면 이전 섹션의 설치 프로세스에서 사용했었던 기본 경로 세트를 사용합니다. 이러한 컴포넌트가 여러 개 설치되어 있거나 일반적이지 않은 디렉터리에 설치한 경우 여기서 경로를 수동으로 입력할 수 있습니다. 다른 방법으로는 DefaultEngine.ini 를 열어서 [/Script/AndroidPlatformEditor.AndroidSDKSettings] 섹션에 입력할 수도 있습니다.

	[/Script/AndroidPlatformEditor.AndroidSDKSettings]
	SDKPath = (Path="C:\Filepath")
	NDKPath = (Path="C:\Filepath")
	JDKPath = (Path="C:\Filepath")
Copy full snippet

[/Script/AndroidPlatformEditor.AndroidSDKSettings] SDKPath = (Path="C:\Filepath") NDKPath = (Path="C:\Filepath") JDKPath = (Path="C:\Filepath")

BaseEngine.ini 에 SDKPath, NDKPath, JDKPath 엔트리가 없는 경우에는 Android 홈 디렉터리의 기본 경로를 사용하게 됩니다.