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

    Android 스튜디오 설정

  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 스튜디오 설치 완료

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

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

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

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가 포함된 폴더가 보입니다.

repositories.cfg 를 로드할 수 없다는 오류 메시지가 발생할 경우, 해당 파일의 예상 경로 (일반적으로 C:/Users/[Username].android/repositories 입니다)로 이동한 다음, 빈 repositories.cfg 파일을 생성하면 Android 설정이 정상적으로 진행됩니다.

`lldb;3.1`라는 패키지를 로드할 수 없는 오류가 발생할 경우, 텍스트 에디터로 SetupAndroid 스크립트를 열어본 후 다음 코드 줄을 검색하세요.

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

이 코드 줄에서 lldb;3.1 엔트리만 지우고 나머지를 유지하면 설정이 정상적으로 진행될 것입니다. 이 이슈는 4.25.1에서 다루고 있습니다.

SDK 경로 수동 타기팅

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

Android 스튜디오 설정

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

4.21 ~ 4.24

NDK r14b

4.19 ~ 4.20

NDK r12b

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

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

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

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

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

네이버 카페
공식 포럼