고급 Android SDK 구성

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

권장 구성

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

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

Android Studio 설치

필수 SDK 및 NDK 컴포넌트를 컴퓨터에 구성하려면 먼저 Android Studio를 설치해야 합니다.

1. 웹 브라우저에서 Android Studio 아카이브로 이동합니다. Android Studio Flamingo | 2022.2.1 패치 2 2023년 5월 24일(Android Studio Flamingo | 2022.2.1 Patch 2 May 24, 2023)로 스크롤을 내립니다. 드롭다운을 클릭하여 펼친 다음, 운영 체제에 맞는 설치 프로그램이나 zip 파일을 다운로드합니다.

   

2. Android Studio 인스톨러를 실행합니다. Android Studio Setup 대화창에서 Next를 클릭하여 계속 진행합니다.

3. Choose Components 대화창에서 디폴트 컴포넌트를 활성화된 상태로 둡니다. Next를 클릭하여 계속 진행합니다.

4. Install Locations 대화창에서 설치 위치가 디폴트 값으로 설정되어 있는지 확인합니다. Next를 클릭하여 계속 진행합니다.

   커스텀 설치 위치를 선택한 경우, SetupAndroid 스크립트는 먼저 편집하지 않는 한 파일을 찾을 수 없습니다. 디폴트 설치 위치를 유지하는 것이 좋습니다.

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

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

7. 구성이 완료되면 Start Android Studio 박스가 체크되었는지 확인한 후 Finish를 클릭하여 인스톨러를 종료합니다.

첫 사용 시 Android Studio 구성

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

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

2. Welcome to Android Studio 대화창에서 More Actions 드롭다운을 클릭하고 SDK Manager를 클릭합니다.

   

3. Android SDK 시스템 세팅에서 Android SDK Location 옆에 있는 Edit 버튼을 클릭합니다.

   

4. SDK Components Setup 대화창에는 필요한 컴포넌트가 이미 선택되어 있습니다. Next를 클릭하여 설치합니다.

   

5. Verify Settings 창에서 Next를 다시 클릭하여 설치를 계속합니다.

6. 설치가 완료되면 Finish를 클릭합니다.

7. Settings 메뉴에서 SDK Tools 탭을 클릭합니다. 이렇게 하면 컴포넌트 옵션 목록이 나타납니다.

8. 사용 가능한 모든 SDK 컴포넌트를 표시하려면 Show Package Details 박스에 체크합니다.

9. Android SDK Command-line Tools (latest) 박스에 체크합니다. 이 컴포넌트를 다운로드 및 설치하려면 Apply를 클릭합니다.

   

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

OS에 Android Studio 설치 마무리

위의 모든 단계를 완료한 후, 진행하기 전에 환경이 완전히 구성되도록 설치를 마무리해야 합니다. 설치를 마무리하는 단계는 운영체제마다 다릅니다.

환경 변수 리셋 또는 검증

이 섹션의 단계는 기본적으로 UE 5.2 이하에서 UE 5.3 이상으로 전환하는 사용자를 위한 것이며 환경 변수를 리셋해야 할 수도 있습니다. UE 및 Android Studio를 새로 설치하는 경우 다음 섹션으로 계속 진행하십시오.

이는 디버깅을 위해 AGDE를 사용한 사용자에게 특히 중요합니다. UE와 AGDE는 이제 모두 jbr 디렉터리를 대상으로 하고 별도의 환경 변수가 필요하지 않기 때문입니다.

1. 컴퓨터의 System Properties를 엽니다.

2. Environment Variables 버튼을 클릭합니다.

3. AGDE_JAVA_HOME이라는 환경 변수가 있으면 삭제합니다. 언리얼 엔진과 AGDE가 이제 동일한 Java 버전을 사용하므로 이 변수는 더 이상 필요하지 않습니다.

4. 다음 환경 변수를 리셋하거나 검증합니다.

   환경 변수	Expected Value
   JAVA_HOME	C:\Program Files\Android\Android Studio\jbr
   ANDROID_HOME	C:\Users(Username)\AppData\Local\Android\Sdk
   NDK_ROOT	C:\Users(Username)\AppData\Local\Android\Sdk\ndk(NDK Version Number)
   NDKROOT	C:\Users(Username)\AppData\Local\Android\Sdk\ndk(NDK Version Number)

   (Username)을 사용자 이름으로 바꾸고 (NDK Version Number)를 설치에 필요한 버전 번호의 디렉터리 이름으로 바꿉니다.

   쉽게 수정하려면 환경 변수를 삭제하세요. 이후 단계에서 SetupAndroid 스크립트로 대체됩니다.

언리얼 엔진의 이전 버전을 지원해야 하는 경우, 현재 및 향후 버전의 언리얼 엔진과의 호환성을 유지하기 위해 위의 단계를 따르는 것이 좋습니다. 언리얼 엔진 이전 버전의 경로를 유지하려면 프로젝트 세팅(Project Settings)을 편집하고 해당 버전의 Android SDK, NDK 및 JDK에 대한 SDK 경로를 수동으로 타기팅하는 것이 좋습니다. 자세한 내용은 아래의 ‘SDK 경로 수동 타기팅’을 참조하세요.

SetupAndroid 스크립트 실행

필요한 Android SDK 컴포넌트가 설치되면 SetupAndroid 스크립트를 사용하여 적절한 버전의 Android NDK를 다운로드 및 설치할 수 있습니다.

1. Engine/Extras/Android 디렉터리를 열고 운영체제에 적합한 SetupAndroid 스크립트를 실행합니다.

   • SetupAndroid.bat – Windows

   • SetupAndroid.command – Mac

   • SetupAndroid.sh – Linux.

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

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 경로를 수동으로 대상으로 지정하여 호환해야 할 수도 있습니다. UE 5.0, 5.1 또는 5.2에서 UE 5.3 이상으로 마이그레이션하는 경우 이 작업을 수행해야 할 가능성이 높습니다.

SDK 경로는 편집(Edit) > 프로젝트 세팅(Project Settings)을 열고 플랫폼(Platforms) > Android > Android SDK 섹션에서 찾을 수 있습니다.

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

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

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