1. 필수 Android 셋업

CodeWorks for Android 1R6u1 SDK 설치 방법 안내입니다.

Windows
MacOS
Linux

단계

Android 개발을 시작하기에 앞서 먼저 CodeWorks for Android 1R6u1 을 설치해야 합니다. CodeWorks for Android 1R6u1 는 Android 디바이스에 디플로이하기 위해 필요한 프로그램과 코드가 전부 설치되도록 도와줄 것입니다. 여기서는 개발 PC 에 CodeWorks for Android 1R6u1 를 설치하는 법에 대해 다루겠습니다.

이미 CodeWorks for Android 1R6u1 가 설치되어 있는데 환경 변수는 없어진 경우, 이 단계는 전부 건너뛰고 에디터의 편집 메뉴 -> 프로젝트 세팅 -> Android SDK 프로퍼티에서 설치 위치를 지정해 주기만 해도 됩니다.

CodeWorks for Android 1R6u1 는 에디터와 런처 둘 다 닫힌 상태로 설치할 것을 강력 추천합니다. 그래야 설치에 문제가 없습니다.

  1. CodeWorks for Android 1R6u1 를 설치하려면 Engine > Extras > Android 폴더로 이동합니다.

    CodeWorks for Android 1R6u1 인스톨러의 정상 완료를 위해서는 Visual Studio 가 설치되어 있어야 합니다. 지원되는 버전은 2013, 2015, 2017 입니다 .

    설치 유형

    위치

    바이너리

    [EngineInstallLocation]\Unreal Engine[EngineVersion]\Engine\Extras\Android

    GitHub

    [EngineSyncLocation\UE4\Engine\Extras\Android

    UE4 를 Github 에서 다운로드한 경우, CodeWorks for Android 1R6u1 인스톨러 실행 전 다음과 같은 작업을 해 줘야 합니다. GitHub 에서 UE4 소스 코드를 다운로드했으면 Windows 기반 PC 든 Mac이든 양쪽에 적용된다는 점 참고 바랍니다. 런처에서 다운로드한 바이너리 빌드를 사용중이라면 이 부분은 건너뛰고 바로 CodeWorks for Android 1R6u1 설치로 들어가시면 됩니다.

    1. GitHub 에서 UE4 다운로드를 마치고 압축을 풀었으면, Setup.bat 파일을 실행하여 필수 파일과 CodeWorks for Android 1R6u1 인스톨러를 다운로드합니다.

    2. Setup.bat 실행이 완료되면 CodeWorks for Android 1R6u1 인스톨러를 실행하고 아래 안내를 따릅니다.

  2. CodeWorksforAndroid-1R6u1-windows.exe 파일을 더블클릭하여 설치 프로세스를 시작합니다.

    AndroidWorks_11.png

  3. 첫 창에서 다음 버튼을 눌러 설치 프로세스를 시작합니다.

    AndroidWorks_00.png

  4. 다음 버튼을 눌러 계속합니다.

    AndroidWorks_01.png

  5. CodeWorks for Android 1R6u1 를 다운로드하고 설치할 위치를 설정한 뒤 다음 버튼을 누릅니다.

    AndroidWorks_02.png

    이 위치는 기본 위치로 놔둬도 전혀 상관 없습니다.

  6. CodeWorks for Android 1R6u1 설치중인지 확인한 뒤 다음 버튼을 누릅니다.

    AndroidWorks_03.png

  7. 체크박스를 클릭하고, 라이선스 조항에 동의하면 모두 수락 을 누른 뒤 수락 버튼을 누릅니다.

    AndroidWorks_04.png

  8. 필수 CodeWorks for Android 1R6u1 툴의 다운로드 및 설치 진행상황이 표시되는 창이 새로 뜹니다.

    이 부분의 완료를 위해서는 인터넷 연결이 필요합니다. 그 인터넷 연결 속도에 따라 몇 분에서 몇 시간까지 걸릴 수 있습니다.

    AndroidWorks_06.png

  9. 이제 다음 버튼을 눌러 CodeWorks for Android 1R6u1 설치를 완료합니다.

    AndroidWorks_09.png

  10. 그리고 완료 버튼을 눌러 설치를 완료합니다.

    AndroidWorks_10.png

  11. 마지막으로 버튼을 눌러 PC 를 재시작합니다.

    AndroidWorks_12.png

    GitHub 에서 UE4 를 다운로드한 경우, CodeWorks for Android 1R6u1 가 설치를 완료하면 환경 변수 설정을 위해 PC 또는 Mac을 재시작하고 Setup.bat 파일을 한 번 더 실행하여 필수 Android 파일을 다운로드합니다.

이미 CodeWorks for Android 1R6u1 가 설치되어 있는데 환경 변수는 없어진 경우, 이 단계는 전부 건너뛰고 에디터의 편집 메뉴 -> 프로젝트 세팅 -> Android SDK 프로퍼티에서 설치 위치를 지정해 주기만 해도 됩니다.

CodeWorks for Android 1R6u1 는 에디터와 런처 둘 다 닫힌 상태로 설치할 것을 강력 추천합니다. 그래야 설치에 문제가 없습니다.

Mac에 CodeWorks for Android 1R6u1 설치 전 Java 8 이 설치되어 있는지 확인해야 합니다. 아래 링크를 사용해서 Java 8 을 다운로드 및 설치하도록 하세요.

  • Java 8 은 여기서 다운로드할 수 있습니다.

  1. CodeWorks for Android 1R6u1 를 설치하려면 Engine > Extras > Android 폴더로 이동합니다.

    설치 유형

    위치

    Binary

    [EngineInstallLocation]\Unreal Engine[EngineVersion]\Engine\Extras\AndroidWorks\Mac

    GitHub

    [EngineSyncLocation\UE4\Engine\Extras\AndroidWorks\Mac

    UE4 를 Github 에서 다운로드한 경우, CodeWorks for Android 1R6u1 인스톨러 실행 전 다음과 같은 작업을 해 줘야 합니다. GitHub 에서 UE4 소스 코드를 다운로드했으면 Windows 기반 PC 든 Mac이든 양쪽에 적용된다는 점 참고 바랍니다. 런처에서 다운로드한 바이너리 빌드를 사용중이라면 이 부분은 건너뛰고 바로 CodeWorks for Android 1R6u1 설치로 들어가시면 됩니다.

    1. GitHub 에서 UE4 다운로드를 마치고 압축을 풀었으면, Setup.command 파일을 실행하여 필수 파일과 CodeWorks for Android 1R6 인스톨러를 다운로드합니다.

    2. Setup.command 실행이 완료되면 CodeWorks for Android 1R6u1 인스톨러를 실행하고 아래 안내를 따릅니다.

  2. CodeWorks for Android 1R6u1-osx.dmg 파일을 더블클릭하여 설치 프로세스를 시작합니다.

    AndroidWorks_Mac_00.png

  3. CodeWorks for Android 1R6u1 인스톨러 아이콘을 더블클릭하여 설치 프로세스를 시작합니다.

    AndroidWorks_Mac_01.png

  4. 다음 을 누릅니다.

    AndroidWorks_Mac_02.png

  5. 다음 을 누릅니다.

    AndroidWorks_Mac_03.png

  6. CodeWorks for Android 1R6u1 를 다운로드하고 설치할 위치를 설정한 뒤 다음 버튼을 누릅니다.

    이 위치는 기본 위치로 놔둬도 전혀 상관 없습니다.

    AndroidWorks_Mac_04.png

  7. CodeWorks for Android 1R6u1 Component Manager 가 표시되면 다음 버튼을 눌러 다운로드 및 설치 프로세스를 시작합니다.

    AndroidWorks_Mac_05.png

  8. 체크박스를 클릭하고, 라이선스 조항에 동의하면 모두 수락 을 누른 뒤 수락 버튼을 누릅니다.

    AndroidWorks_Mac_06.png

  9. CodeWorks for Android 1R6u1 Component Manager 가 필수 툴 다운로드 및 설치를 시작합니다.

    이 부분의 완료를 위해서는 인터넷 연결이 필요합니다. 그 인터넷 연결 속도에 따라 몇 분에서 몇 시간까지 걸릴 수 있습니다.

  10. 필수 툴의 다운로드 및 설치가 전부 끝나면 다음 창이 표시됩니다. 다음 버튼을 눌러 설치 프로세스를 계속합니다.

    AndroidWorks_Mac_08.png

  11. 이제 완료 버튼을 눌러 CodeWorks for Android 1R6u1 설치를 완료합니다.

    AndroidWorks_Mac_09.png

    GitHub 에서 UE4 를 다운로드한 경우, CodeWorks for Android 1R6u1 가 설치를 완료하면 환경 변수 설정을 위해 PC 또는 Mac을 재시작하고 Setup.command 파일을 한 번 더 실행하여 필수 Android 파일을 다운로드합니다.

CodeWorks for Android 1R6u1 설치가 완료되면, 다음과 같이 Bash 파일을 편집해 줘야 합니다:

  1. Mac Terminal 을 엽니다.

    JH_01.png

  2. Terminal 에 다음과 같이 입력합니다: nano ~/.bash_profile.

    JH_02.png

  3. 파일 끝으로 내려가 export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_121.jdk/Contents/Home 를 추가합니다.

    JH_03.png

    위 경로는 기본 경로이며, 다른 곳에 설치한 경우 경로가 jdk1.8.0_121.jdk/Contents/Home 를 가르키도록 해줘야 합니다.

  4. CTRL + X 를 눌러 bash 를 빠져나간 뒤 Y 를 눌러 변경사항을 저장하고 Enter 키를 쳐 변경사항을 확인, 마지막으로 Mac 을 재시작합니다.

  5. Mac 이 재시작되면 Terminal 을 연 뒤 Monitor 라 입력하고 엔터를 칩니다. 모두 제대로 구성되었으면 Android Device Monitor 스플래시 화면이 보일 것입니다.

    JH_04.png

언리얼 엔진 4 는 특수한 버전의 Android 소프트웨어 개발 키트(SDK), CodeWorks for Android 를 사용합니다. CodeWorks for Android 덕에 언리얼 엔진 4 로 Android 개발을 하는 데 필요한 SDK 및 네이티브 개발 키트 (NDK) 구성을 쉽게 할 수 있습니다. Android SDK( 또는 CodeWorks for Android) 구형 (1R5 이전) 버전이 설치된 경우, 설치를 해제한 뒤 언리얼 엔진 4 와 함께 배포되는 CodeWorks for Android 인스톨러를 사용하여 CodeWorks for Android 를 설치해 주시기 바랍니다.

Android SDK 와 엔진의 호환성을 위해 언리얼 엔진 4 에 CodeWorks for Android 인스톨러를 번들로 포함시켰습니다. 참고로 언리얼 엔진 4.16 에는 CodeWorks for Android 1R6u1 이 포함되어 있습니다.

CodeWorks for Android 설치

Linux에서 Android 작업을 시작하는 방법을 선보이기 위한 목적 상, 언리얼 엔진 4.14 버전에 CodeWorks for Android 1R6u1 버전을 사용하겠습니다. 먼저 엔진을 닫고 CodeWorks for Android 1R6u1 설치를 시작해야 합니다. 또 자바 개발 키트 8 (JDK 8) 이 설치되어 있는지, JAVA_HOME 환경 변수는 JDK 올바른 버전으로 설정되어 있는지 확인해야 합니다. JAVA_HOME 이 제대로 설정되었는지 확인하기 위해서는, 터미널에 echo $JAVA_HOME 이라 입력합니다. JDK 버전이 맞지 않으면, JDK 8 다운로드 후 Linux 컴퓨터에 설치한 뒤, JAVA_HOME 환경 변수가 새로 설치된 JDK 로 되어있는지 확인합니다.

계속하기 전 참고로, 현재 Linux에서 Android Vulkan 은 지원하지 않습니다.

  1. 우선 Terminal 을 열고 컴파일된 엔진이 들어있는 [UE4Root] 폴더로 이동합니다 (cd 명령을 사용하여, shell 작업 디렉터리를 변경합니다).

    LinuxAndroid_Step0.png

  2. [UE4Root] 폴더 안에서 CodeWorks for Android 1R6u1 바이너리 파일을 (CodeWorksforAndroid-1R6u1-linux-x64.run) 찾습니다. 터미널에 다음과 같이 입력하면 됩니다: cd Engine/Extras/AndroidWorks/Linux.

    LinuxAndroid_Step1.png

  3. 터미널에 ls -l 을 치면, 디렉터리 내용이 긴 리스트로 나옵니다.

    LinuxAndroid_Step2.png

    파일 권한 설정을 보면 CodeWorksforAndroid-1R6u1-linux-x64.run 실행 준비가 되지 않았습니다. CodeWorks for Android 1R6u1 바이너리를 실행하려면, 파일 접근 권한 중 "실행" 권한을 허용해야 합니다.

  4. CodeWorksforAndroid-1R6u1-linux-x64.run 파일 권한 세팅 변경을 위해 일반 실행파일처럼 실행할 수 있도록 해줘야 하니, 터미널에 chmod +x CodeWorksforAndroid-1R6u1-linux-x64.run 이라 입력합니다.

    LinuxAndroid_Step3.png

    chmod 명령 관련 자세한 내용은 터미널에 man chmod 라 입력하면 chmod 설명서가 표시됩니다.

  5. 터미널에 ls -l 을 입력합니다.

    LinuxAndroid_Step4.png

    이미지에 강조된 부분이 파일의 권한 설정이며, CodeWorks for Android 1R6u1 바이너리 파일 실행 준비가 되었음을 알 수 있습니다.

  6. CodeWorks for Android 바이너리를 실행하려면, 터미널에 ./CodeWorksforAndroid-1R6u1-linux-x64.run 이라 입력합니다.

    LinuxAndroid_Step5.png

    다음 단계로 넘어가기 전 컴퓨터에 인터넷이 연결되어 있는지 확인하세요.

  7. CodeWorks for Android 1R6u1 바이너리가 NVIDIA CodeWorks for Android 인스톨러 압축을 해제한 후, Installer Welcome 창이 뜨며, Next 또는 Cancel 중에서 선택할 수 있습니다.

    LinuxAndroid_Step6.png

  8. Installer Welcome 창에서 Next 버튼을 눌러 설치 프로세스를 시작합니다.

    LinuxAndroid_Step7.png

  9. Android Developer's Welcome Window 창에서 Next 버튼을 눌러 설치 프로세스를 계속합니다.

    LinuxAndroid_Step8.png

  10. CodeWorks for Android 1R6u1 설치 및 다운로드 디렉터리를 지정합니다.

    LinuxAndroid_Step9.png

  11. Next > 버튼을 누르면 NVIDIA 에서 CodeWorks for Android 1R6u1 을 다운로드하고, 결국 컴퓨터에 CodeWorks 가 설치됩니다.

    LinuxAndroid_Step10.png

  12. CodeWorks for Android 1R6u1 이 설치되고 있는지 확인한 후 Android Component Manager 창에서 Next 버튼을 클릭합니다.

    LinuxAndroid_Step11.png

  13. Terms and Conditions 창이 뜨면, 시간을 조금 들여 조항을 전부 확인한 뒤 Accept All 박스를 체크합니다.

    LinuxAndroid_Step12.png

  14. Accept 버튼을 클릭하면 설치 프로세스가 시작됩니다.

    LinuxAndroid_Step13.png

  15. 인스톨러가 설치 프로세스를 완료하면, Next > 버튼을 눌러 계속합니다.

    LinuxAndroid_Step14.png

  16. Installation Complete 창이 열리면, Finish 버튼을 클릭하여 설치를 마칩니다.

    LinuxAndroid_Step15.png

  17. 컴퓨터를 리부팅한 후 다음 단계로 넘어갑니다.

    LinuxAndroid_Note16.png

    Ubuntu GUI 를 사용하지 않으려면, 터미널에 sudo reboot 라 입력하여 컴퓨터를 재시작하면 됩니다.

최종 결과

완료되면 Android 디바이스에서 작동되는 UE4 프로젝트 제작에 사용할 수 있는 필수 Android SDK 가 전부 설치되어 있을 것입니다.

Tags