Choose your operating system:
Windows
macOS
Linux
언리얼 엔진 4 (UE4) 는 Android Software Development Kit (SDK) 특수 버전 CodeWorks for Android 1R6u1 를 사용합니다. CodeWorks for Android 이 버전은 UE4 로 Android 프로젝트를 개발하는 데 필요한 SDK 및 Native Development Kit (NDK) 를 가장 쉽게 설치할 수 있습니다. 현재 1R6u1 버전을 사용하긴 하지만, 앞으로 출시되는 CodeWorks 버전을 사용할 계획입니다. Android SDK 다른 버전( 또는 CodeWorks for Android 구버전)이 설치된 경우, 설치 해제한 뒤 UE4 와 같이 배포되는 CodeWorks for Android 인스톨러를 통해 CodeWorks for Android 를 재설치할 것을 권장합니다. 다음 섹션에서는 개발 PC 에 CodeWorks for Android 1R6u1 을 설치하는 법을 설명합니다.
단계
CodeWorks for Android 1R6u1 버전이 이미 설치되었지만 환경 변수만 손실된 경우, 이 단계를 전부 생략하고 에디터의 편집 > 프로젝트 세팅 > Android SDK 프로퍼티에서 설치 위치를 지정해 주면 됩니다.
문제 방지를 위해 에디터와 런처 둘 다 닫힌 상태에서 CodeWorks for Android 1R6u1 을 설치할 것을 권장합니다.
-
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
언리얼 엔진 4 를 Github 에서 다운로드한 경우, 다음 단계를 수행한 뒤 CodeWorks for Android 1R6u1 인스톨러를 실행해야 합니다. 참고로 이는 GitHub 에서 언리얼 엔진 4 소스 코드를 다운로드한 Windows 와 Mac 기반 PC 둘 다에 적용됩니다. 런처에서 다운로드한 바이너리 빌드를 사용하는 경우, 이 부분은 건너 뛰고 CodeWorks for Android 1R6u1 설치를 바로 시작해도 됩니다.
-
언리얼 엔진 4 를 GitHub 에서 다운로드하고 압축을 푼 뒤, Setup.bat 파일을 실행하여 필수 파일과 함께 CodeWorks for Android 1R6u1 인스톨러를 다운로드합니다.
-
Setup.bat 실행이 끝나면 CodeWorks for Android 1R6u1 인스톨러를 찾아 실행하고, 아래 안내를 따릅니다.
-
-
-
CodeWorksforAndroid-1R6u1-windows.exe 파일을 더블클릭하여 설치 프로세스를 시작합니다.
-
첫 창의 Next 버튼을 클릭하여 설치 프로세스를 시작합니다.
-
Next 버튼을 클릭하여 계속합니다.
-
CodeWorks for Android 1R6u1 를 다운로드하고 설치할 위치를 설정한 뒤 Next 버튼을 클릭합니다.
기본 설정 위치로 놔둬도 완전 괜찮습니다.
-
CodeWorks for Android 1R6u1 버전을 설치 중인지 확인한 뒤 Next 버튼을 클릭합니다.
-
Accept All 박스를 체크하여 라이선스 조항에 동의한 뒤 Accept 버튼을 클릭합니다.
-
새 창에 필수 CodeWorks for Android 1R6u1 툴의 다운로드 및 설치 진행 상태가 표시됩니다.
이 부분을 완료하려면 인터넷 연결이 필요합니다. 인터넷 연결 속도에 따라 몇 분에서 몇 시간까지 걸릴 수도 있습니다.
-
Next 버튼을 클릭하여 CodeWorks for Android 1R6u1 설치를 계속합니다.
-
Finish 버튼을 클릭하여 설치를 종료합니다.
-
마지막으로 Yes 버튼을 눌러 PC 를 재시작합니다.
Github 에서 언리얼 엔진 4 를 다운로드한 경우, 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 다운로드 링크 .
-
CodeWorks for Android 1R6u1 을 설치하려면 Engine > Extras > Android 폴더로 이동합니다.
설치 유형
위치
바이너리
[EngineInstallLocation]\Unreal Engine[EngineVersion]\Engine\Extras\AndroidWorks\Mac
GitHub
[EngineSyncLocation\UE4\Engine\Extras\AndroidWorks\Mac
언리얼 엔진 4 를 Github 에서 다운로드한 경우, 다음 단계를 수행한 뒤 CodeWorks for Android 1R6u1 인스톨러를 실행해야 합니다. 참고로 이는 GitHub 에서 언리얼 엔진 4 소스 코드를 다운로드한 Windows 와 Mac 기반 PC 둘 다에 적용됩니다. 런처에서 다운로드한 바이너리 빌드를 사용하는 경우, 이 부분은 건너 뛰고 CodeWorks for Android 1R6u1 설치를 바로 시작해도 됩니다.
-
언리얼 엔진 4 를 GitHub 에서 다운로드하고 압축을 푼 뒤, Setup.command 파일을 실행하여 필수 파일과 함께 CodeWorks for Android 1R6u1 인스톨러를 다운로드합니다.
-
Setup.command 실행이 끝나면 CodeWorks for Android 1R6u1 인스톨러를 찾아 실행하고, 아래 안내를 따릅니다.
-
-
-
CodeWorks for Android 1R6u1-osx.dmg 를 더블클릭하여 CodeWorks for Android 1R6u1 인스톨러를 로드합니다.
-
CodeWorks for Android 1R6u1 인스톨러 아이콘을 더블클릭하여 설치 프로세스를 시작합니다.
-
Next 를 클릭합니다.
-
Next 를 클릭합니다.
-
CodeWorks for Android 1R6u1 설치 위치를 지정한 뒤 Next 버튼을 클릭합니다.
기본 설정 위치로 놔둬도 완전 괜찮습니다.
-
CodeWorks for Android 1R6u1 Component Manager 가 표시되면 Next 버튼을 클릭하여 다운로드와 설치 프로세스를 시작합니다.
-
Accept All 박스를 체크하여 라이선스 조항에 동의한 뒤 Accept 버튼을 클릭합니다.
-
CodeWorks for Android 1R6u1 Component Manager 가 필수 툴 다운로드와 설치를 시작합니다.
이 부분을 완료하려면 인터넷 연결이 필요합니다. 인터넷 연결 속도에 따라 몇 분에서 몇 시간까지 걸릴 수도 있습니다.
-
모두 설치가 끝나면 다음과 같은 창이 뜹니다. Next 버튼을 클릭하여 계속합니다.
-
Finish 버튼을 클릭하여 CodeWorks for Android 1R6u1 설치를 완료합니다.
Github 에서 언리얼 엔진 4 를 다운로드한 경우, CodeWorks for Android 1R6u1 설치가 끝나면 PC 또는 Mac 을 재시작하여 환경 변수를 설정한 뒤 Setup.command 파일을 한 번 더 실행하면 필수 Android 개발 파일을 다운로드합니다.
CodeWorks for Android 1R6u1 설치가 끝나면 다음과 같이 Bash 파일을 편집해야 합니다.
-
Mac Terminal 을 엽니다.
-
Terminal 에 nano ~/.bash_profile 이라 입력합니다.
-
파일 끝으로 화면을 내려
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_121.jdk/Contents/Home
줄을 추가합니다.위는 기본 경로이므로 다른 곳에 설치한 경우 jdk1.8.0_121.jdk/Contents/Home 에 맞는 경로로 수정하세요.
-
CTRL + X 키를 눌러 bash 를 빠져나간 뒤, Y 키를 눌러 변경사항을 저장하고, ENTER 키를 눌러 확인한 다음 Mac 을 재시작합니다.
-
Mac 재시작 후 Terminal 을 열고 Monitor 라 입력한 뒤 ENTER 키를 칩니다. 모두 올바르게 설정되었다면 Android Device Monitor 스플래시 화면이 보일 것입니다.
Linux 에서 Android 개발 시작 방법을 선보이기 위해, CodeWorks for Android 1R6u1 버전에 언리얼 엔진 4.14 를 사용합니다. CodeWorks for Android 1R6u1 설치 전 엔진을 닫아야 합니다. 또 Java Development Kit 8 (JDK 8) 가 설치되어 있고,
JAVA_HOME
환경 변수가 올바른 Java Development Kit (JDK) 버전으로 설정되어 있어야 합니다.
JAVA_HOME
이 제대로 설정되었는지 확인하려면 terminal 에
echo $JAVA_HOME
이라 입력합니다. JDK 버전이 다르다면
JDK 8 다운로드
후 Linux 컴퓨터에 설치합니다.
JAVA_HOME
환경 변수가 새로 설치된 JDK 로 설정되었는지 확인합니다.
현재 Android Vulkan on Linux 는 지원하지 않습니다.
-
Terminal 을 열고 컴파일된 엔진이 들어있는
[UE4Root]
폴더로 이동합니다 (cd
명령을 사용하여 셸 작업 디렉터리를 변경합니다). -
[UE4Root]
폴더 안에서 CodeWorks for Android 1R6u1 바이너리 파일을 ( CodeWorksforAndroid-1R6u1-linux-x64.run ) 찾습니다. terminal 에 다음과 같이 입력합니다:cd Engine/Extras/AndroidWorks/Linux
. -
이제 terminal 에
ls -l
이라 입력하면, 디렉터리의 내용이 길게 표시됩니다.
파일 권한 설정을 보면 CodeWorksforAndroid-1R6u1-linux-x64.run 은 실행할 수 없습니다. CodeWorks for Android 1R6u1 바이너리를 실행하기 전, 파일을 "실행"할 수 있도록 권한을 변경해야 합니다. -
CodeWorksforAndroid-1R6u1-linux-x64.run
파일 권한 설정을 변경하여 일반 실행파일처럼 실행되도록 하려면, terminal 에chmod +x CodeWorksforAndroid-1R6u1-linux-x64.run
라 입력합니다.chmod
명령 관련 자세한 내용은 terminal 에man chmod
라 입력하면chmod
작동법 매뉴얼을 확인할 수 있습니다. -
이제 terminal 에
ls -l
라 입력합니다.
이미지에 강조된 파일의 권한 설정을 보면 CodeWorks for Android 1R6u1 바이너리 파일을 실행할 준비가 되었습니다. -
CodeWorks for Android 바이너리를 실행하려면, 터미널에
./CodeWorksforAndroid-1R6u1-linux-x64.run
라 입력합니다.다음 단계를 진행하기 전 컴퓨터가 인터넷에 연결되어 있는지 확인하세요.
-
CodeWorks for Android 1R6u1 바이너리가 NVIDIA CodeWorks for Android 인스톨러 압축을 푼 뒤, Installer Welcome 창이 뜹니다. Next 또는 Cancel 을 선택할 수 있습니다.
-
Installer Welcome 창에서 Next 버튼을 눌러 설치 프로세스를 시작합니다.
-
이제 Android Developer's Welcome Window 창에서 Next 버튼을 클릭하여 설치 프로세스를 계속합니다.
-
CodeWorks for Android 1R6u1 를 설치 및 다운로드할 디렉터리를 지정하세요.
-
Next 버튼을 클릭하면 NVIDIA 에서 CodeWorks for Android 1R6u1 를 다운로드하고, 컴퓨터에 CodeWorks 를 설치합니다.
-
이제 CodeWorks for Android 1R6u1 가 설치되는지 확인한 뒤 Android Component Manager 창에서 Next 를 클릭합니다.
-
Terms and Conditions 창이 뜨면 시간을 내서 조항을 살펴본 뒤 Accept All 박스를 체크합니다.
-
Accept 버튼을 클릭하면 설치 프로세스가 시작됩니다.
-
인스톨러가 설치 프로세스를 완료하면, Next > 버튼을 눌러 계속합니다.
-
Installation Complete 창이 열린 이후 Finish 버튼을 클릭하여 설치를 완료합니다.
-
컴퓨터를 리부팅한 뒤 다음 단계를 진행하세요.
Ubuntu 의 GUI 를 사용하지 않으려면, terminal 에
sudo reboot
라 입력하여 컴퓨터를 재시작할 수 있습니다.
최종 결과
완료되면 필수 Android SDK 가 전부 설치되어 Android 디바이스에서 작동되는 언리얼 엔진 4 프로젝트 제작에 사용할 수 있습니다.