이제 언리얼 엔진 4.25부터 Android 프로젝트를 개발하기 위해서는 Android NDK r21(Native Development Kit Revision 21)이 필요합니다. 이를 위해서는 Codeworks for Android 1R7u1 대신 Android 스튜디오(Android Studio)를 사용하는 새로운 설정 프로세스가 필요합니다. 4.25의 정식 출시에 맞춰 이 프로세스와 관련된 새로운 문서를 게시할 예정이지만, 그 전에 미리 4.25 프리뷰 빌드 사용자에게 새로운 설정 단계를 알려드리고자 합니다.
권장 설정
NDK 컴포넌트 설치나 엔진용 환경 변수 설정에 따른 문제를 예방하려면 언리얼 에디터와 에픽게임즈 런처를 둘 다 닫았는지 확인하는 것이 좋습니다.4.24 이하에서 언리얼 4.25로 판올림하는 경우에는 설정을 계속 진행하기 전에 먼저 CodeWorkds for Android와 기존 NDK 컴포넌트를 모두 제거하는 것이 좋습니다. 그래야 환경 변수가 올바르게 설정될 수 있습니다.
기존에 설치한 언리얼 엔진을 지원하면서 동시에 언리얼 4.25 이상의 설치도 유지하려는 경우 아래의 기존 NDK 또는 언리얼 버전 사용 섹션을 참조하세요.
1. Android 스튜디오 설치
필수 NDK 컴포넌트를 컴퓨터에 설치하려면 Android 스튜디오를 설치해야 합니다.- 웹 브라우저에서 Android 개발자(Android Developers) 페이지로 이동합니다. Android 스튜디오(Android Studio) 탭에서 Android 스튜디오 다운로드(Download Android Studio)를 클릭하고 설치 프로그램을 원하는 위치에 저장합니다.
- Android 스튜디오 설치 프로그램을 실행합니다. Android 스튜디오 설정 시작(Welcome to Android Studio Setup) 대화 상자에서 Next를 클릭하여 계속 진행합니다.
- Choose Components 대화 상자에서 Next를 클릭하여 계속 진행합니다. 기본 컴포넌트는 활성화된 상태로 놔두어도 됩니다.
- Configuration Settings 대화 상자에서 설치할 위치를 선택하고 Next를 클릭하여 계속 진행합니다. 기본 위치를 사용하는 것이 좋습니다.
- Choose Start Menu Folder에서 Install를 클릭하여 설치 프로세스를 시작합니다.
- 설치가 완료되면 Next를 클릭하여 컴포넌트 설정을 시작합니다.
- 설정이 완료되면 Start Android Studio 박스가 체크되었는지 확인한 후 Finish를 클릭하여 설치 프로그램을 종료합니다.
2. 첫 사용 시 Android 스튜디오 설정
Android 스튜디오를 처음 시작하는 경우 다음 단계를 따릅니다.- Import Android Studio Settings 대화 상자가 나타나면 OK를 클릭하여 계속 진행합니다.
- Data Sharing 대화 상자가 나타나면 사용 통계를 Google로 전송할지 여부를 선택합니다. 이는 옵션이므로 무엇을 선택하든 다음 단계로 계속 진행됩니다.
- Android Studio Setup Wizard가 나타납니다. Next를 클릭하여 계속 진행합니다.
- Install Type 대화 상자에서 Standard를 선택하고 Next를 클릭합니다.
- Select UI Theme 대화 상자에서 원하는 테마를 선택하고 Next를 클릭합니다.
- Verify Settings 대화 상자에서 Finish를 클릭하여 설정을 완료합니다.
Windows 사용자는 컴퓨터를 다시 시작해야 모든 설정이 적용됩니다. Linux 사용자는 터미널 창을 닫았다가 다시 열어야 합니다. Mac 사용자는 터미널 창을 닫았다가 다시 열거나 로그아웃 후 다시 로그인해야 합니다. 이 과정을 마쳐야 다음 섹션으로 넘어갈 수 있습니다.
3. NDK r21을 사용하도록 언리얼 설정
Android NDK r21을 사용하도록 언리얼 에디터를 설정하려면:- 언리얼 4 엔진 설치 디렉터리로 이동합니다. 예: C:/Program Files/Epic Games/UE_4.25
- Engine/Extras/Android를 엽니다.
- 해당 디렉터리에서 운영 체제에 맞는 SetupAndroid 스크립트를 실행합니다. Windows는 SetupAndroid.bat, Mac은 SetupAndroid.command, Linux는 SetupAndroid.sh를 실행합니다.
기존 NDK 또는 언리얼 버전 사용
언리얼 엔진 4.24 이하를 설치해야 하거나 프로젝트가 이 설치 프로세스에서 지원되지 않는 이전 버전의 Android NDK를 타기팅하는 경우에는 환경 변수를 수동으로 설정하면 원하는 버전을 타기팅할 수 있습니다. 언리얼 에디터에서 Android SDK 경로는 플랫폼 > Android SDK 아래의 프로젝트 세팅 메뉴에서 찾을 수 있습니다. 아니면 엔진 설치를 위해[/Script/AndroidPlatformEditor.AndroidSDKSettings]
아래에서 BaseEngine.ini를 다음과 같이 수동으로 편집할 수도 있습니다:
NDKPath=(Path="D:/[NDKInstallPath]")
여기서
[NDKInstallPath]
는 원하는 NDK 설치 위치입니다.향후 언리얼 엔진을 최대한 원활하게 설치하려면 Android 스튜디오를 위의 설치 단계에 따라 사용하는 것이 좋습니다. 그 후에는 Android 개발자 사이트의 지원되지 않는 NDK 다운로드(Unsupported NDK Downloads) 페이지에서 NDK r14b를 다운로드해서 4.24 이하의 설치에 수동으로 타기팅할 수 있습니다.
이전 프로젝트 때문에 CodeWorks 설치를 그대로 유지하고 싶은 경우에는 CodeWorks를 제거하지 않고도 위의 Android 스튜디오 설치 과정을 수행할 수 있습니다. 4.25의 SetupAndroid 스크립트는 여전히 NDK r21을 자동으로 다운로드하겠지만 이제 다운로드 위치를 언리얼 4.25 설치 위치에 수동으로 타기팅해야 합니다.