언리얼에 Android SDK 및 NDK 설정

언리얼 4.25 이상에 Android 개발 환경을 설정하는 방법

Windows
MacOS
Linux

언리얼 엔진 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 설치 폴더를 계속해서 사용하게 됩니다.

CodeWorks의 기본 설치 디렉터리는 **C:/NVPACK**입니다. CodeWorks를 제거한 후에는 이 폴더가 삭제되었는지 확인해야 합니다.

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

1. Android 스튜디오 설치

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

  1. 웹 브라우저에서

    [Android 스튜디오 다운로드 자료실(Android Studio download archives)](AndroidStudio_Download.png)
    로 이동합니다. **Android Studio 3.5.3**으로 스크롤을 내리고 드롭다운을 클릭하여 펼칩니다. 여기서 운영 체제에 맞는 설치 프로그램이나 zip 파일을 다운로드합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

![Android Studio Setup](AndroidStudio_Step2-1.png)(w:400)

  1. Data Sharing 대화 상자가 나타나면 사용 통계를 구글(Google)로 전송할지 여부를 선택합니다. 이는 옵션이므로 무엇을 선택하든 다음 단계로 계속 진행됩니다.

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

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

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

  1. Install Type 대화 상자에서 Standard**를 선택하고 Next**를 클릭합니다.

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

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

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

  1. Verify Settings 대화 상자에서 **Finish**를 클릭하여 설정을 완료합니다.

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

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

OS에 Android 스튜디오 설치 완료

Windows 사용자는 컴퓨터를 다시 시작해야 합니다.

Linux 사용자는 터미널 창을 닫았다가 다시 열어야 합니다.

MacOS 사용자는 터미널 창을 닫았다 다시 열거나, 로그아웃 후 다시 로그인해야 합니다.

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

  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를 실행합니다.

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

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

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

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

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

수동으로 SDK 경로 타기팅

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

![Android Studio Setup](AndroidManualNDK.png)(w:700)

이러한 필드를 비워 두면 이전 섹션의 설치 프로세스에서 사용했었던 기본 경로 세트를 사용합니다. 이러한 컴포넌트가 여러 개 설치되어 있거나 일반적이지 않은 디렉터리에 설치한 경우 여기서 수동으로 경로를 입력할 수 있습니다. 아니면 **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 버전을 보여줍니다.

언리얼 엔진 버전

호환되는 NDK 버전

4.25 이상

NDK r21, NDK r20b

4.21~4.24

NDK r14b

4.19~4.20

NDK r12b

언리얼 엔진 4.25에는 NDK r21을 사용하는 것이 좋지만, 일부 저가형 디바이스와 호환성 문제가 있는 경우를 대비해 UE 4.25는 NDK r20b도 지원합니다.

Select Skin
Light
Dark
언리얼 엔진 문서의 미래를 함께 만들어주세요! 더 나은 서비스를 제공할 수 있도록 문서 사용에 대한 피드백을 주세요.
설문조사에 참여해 주세요
건너뛰기

새로운 언리얼 엔진 4 문서 사이트에 오신 것을 환영합니다!

문서 사이트에 대한 의견을 모을 수 있는 피드백 시스템을 포함해서 여러가지 새로운 기능을 준비하고 있습니다. 아래 Documentation Feedback 포럼(영문) 또는 언리얼 엔진 네이버 공식 카페(한글) 중 편하신 곳에 의견이나 문제점을 알려 주세요.

새 시스템이 준비되면 알려 드리겠습니다.

네이버 카페
공식 포럼