언리얼 엔진 5 문서가 에픽 디벨로퍼 커뮤니티로 이전되었습니다

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

권장 설정

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

언리얼을 4.24 또는 이전 버전에서 4.25로 이주하는 경우에는 CodeWorks for Android와 기존 NDK 컴포넌트를 모두 제거한 후, CodeWorks가 설치되어 있었던 폴더를 삭제하는 것을 권장합니다. 삭제하지 않을 경우, Android 스튜디오는 SDK 업데이트 시 이전의 CodeWorks 설치 폴더를 계속해서 사용하게 됩니다.

기존에 설치한 언리얼 엔진을 지원하면서 동시에 언리얼 4.25 이상의 설치도 유지하려는 경우 아래의 SDK 경로 수동 타기팅 및 Android NDK 호환성 섹션을 참조하세요.

1. Android 스튜디오 설치

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

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 를 클릭하여 계속 진행합니다.

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

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

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

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

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

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

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

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

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

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

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

OS에 Android 스튜디오 설치 완료

3. 언리얼에서 Android NDK r21b를 사용하도록 설정

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

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

3. 해당 디렉터리에서 운영 체제에 맞는 SetupAndroid 스크립트를 실행합니다. Windows는 SetupAndroid.bat, Mac은 SetupAndroid.command, Linux는 SetupAndroid.sh를 실행합니다.

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

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

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

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

이 스크립트를 실행하면 Android 홈 디렉터리에 NDK r21b 를 다운로드하고 설치합니다. NDK 설치 디렉터리는 C:/Users/[Username]/AppData/Local/Android/SDK/ndk/ 여야 하고 여기서 'username'은 사용자의 컴퓨터 로그인 이름이어야 합니다. 그러면 NDK r21b가 포함된 폴더가 보입니다.

`call "%SDKMANAGER%" "platform-tools" "platforms;android-28" "build-tools;29.0.3" "lldb;3.1" "cmake;3.10.2.4988404" "ndk;21.1.6352462"`

SDK 경로 수동 타기팅

위의 설명 섹션을 정확하게 따른 경우 언리얼 엔진은 Android SDK, 설치된 Android NDK 버전, Java Development Kit(JDK)의 SDK 경로를 자동으로 연결합니다. SDK 경로를 수동으로 타기팅해야 하는 경우 Edit > Project Settings 를 열고 Platforms > Android > Android SDK 섹션으로 이동하면 경로를 찾을 수 있습니다.

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

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

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

Android NDK 호환성

다음 테이블에서 꼭 필요하거나 언리얼 엔진의 다른 버전과 호환되는 NDK 버전을 볼 수 있습니다.