Android 개발 레퍼런스

(NVIDIA 의) CodeWorks for Android 1R6u1 는 Android 개발용 원스톱 센터입니다. CodeWorks for Android 1R6u1 만 설치하면 필요한 모든 것이 설치됩니다.

CodeWorks for Android 1R6u1 인스톨러는 Windows용 언리얼 엔진 4 에 포함되어 있습니다. 위치는 다음과 같습니다:

	[엔진 설치 위치]\Engine\Extras\Android\CodeWorksforAndroid-1R6u1-windows.exe

Copy full snippet

중요한 부분은:

• Android SDK (기본, 플랫폼 툴, 빌드 툴)
• Android 4.4.2 (API 19) - SDK 플랫폼
• Android 5.0.1 (API 21) - SDK 플랫폼
• Android 6.0.0 (API 23) - SDK 플랫폼
• Android N (API 24) - SDK 플랫폼
• Android SDK Support Library
• Android Toolchain
  • Android NDK 12b
  • Java SDK
  • Apache Ant
  • USB 드라이버
  • 선택적 설치
    • Gradle
• 개발자 툴 (선택적 설치)
• Nsight Tegra, Visual Studio Edition
• USB 드라이버

기본 설치 세트를 사용하면, 딱 최소한의 컴포넌트 세트만 설치됩니다. 사용자 구성 설치를 하는 경우, (프로파일러와 같은) 다른 항목을 추가할 수 있습니다. 참고로 설치 도중, 하위 인스톨러 하나 둘 정도에 응답이 없는 것으로 보일 수도 있으나, 결국은 정상 완료됩니다. 설치 소요 시간은 30 분에서 45 분 정도 걸립니다. 코드 작성 계획이 전혀 없는 경우, Customize (사용자 지정)을 선택한 다음, (NDK 와 Nsight 디버거는 생략하고) SDK, Ant, Java 만 설치하면 빠른 설치가 가능합니다. CodeWorks for Android 1R6u1 의 Nsight 부분은 디바이스에서 Android 게임 디버깅에 사용됩니다. C++ 코드 컴파일에 필수는 아닙니다.

(NVIDIA 의) CodeWorks for Android 1R6u1 는 Android 개발용 원스톱 센터입니다. CodeWorks for Android 1R6u1 만 설치하면 필요한 모든 것이 설치됩니다.

CodeWorks for Android 1R6u1 인스톨러는 Mac용 언리얼 엔진 4 에 포함되어 있으며, 다음 위치에서 찾을 수 있습니다:

	[엔진 설치 위치]/Engine/Extras/Android/AndroidWorks-1R6u1-osx.dmg

Copy full snippet

중요한 부분은:

• Android SDK (기본, 플랫폼 툴, 빌드 툴)
• Android 4.4.2 (API 19) - SDK 플랫폼
• Android 5.0.1 (API 21) - SDK 플랫폼
• Android 6.0.0 (API 23) - SDK 플랫폼
• Android N (API 24) - SDK 플랫폼
• Android SDK Support Library
• Android Toolchain
  • Android NDK 12b
  • Java SDK
  • Apache Ant
  • USB 드라이버
  • 선택적 설치
    • Gradle
• 개발자 툴 (선택적 설치)
• Nsight Tegra, Visual Studio Edition
• USB 드라이버

기본 설치 세트를 사용하면, 정말이지 최소한의 컴포넌트 세트만 설치됩니다. 설치를 수정한다면, (프로파일러 등의) 아이템을 추가할 수 있습니다. 참고로 설치 도중 추가로 뜨는 인스톨러가 하나 둘 멈춘 것처럼 보일 수가 있지만, 놔두면 알아서 완료될 것입니다. 인스톨 시간은 컴퓨터에 따라 30 분에서 45 분 정도 소요될 수 있습니다. 코드 작성 계획이 없는 경우, Customize 를 선택한 다음 SDK, Ant, Java 만 선택하여 (NDK 나 Nsight 디버거를 생략하여) 빠르게 설치할 수 있습니다. CodeWorks for Android 1R6u1 의 Nsight 부분은 디바이스에서 Android 게임을 디버깅할 때 쓰이는 것이므로, C++ 코드 컴파일에 필수는 아닙니다.

제공된 인스톨러에서 CodeWorks for Android 1R6u1 를 설치한 것이 아니라면, 일부 환경 변수가 제대로 설정되었는지 확인해 줘야 합니다.

환경 변수를 설정하려면:

• 컴퓨터 아이콘에 우클릭하거나 키보드의 Windows+Pause Break 키를 누릅니다.
• 왼편의 고급 시스템 설정 을 선택합니다.
• 환경 변수... 를 클릭합니다.
• 각 변수에 대해 (아래 확인):
  • (아래에서) 환경 변수가 목록 중 최소 하나에 (System 또는 User) 이미 설정되어 있는지 찾아봅니다.
  • 찾지 못했으면, System 섹션 옆의 새로 만들기... 를 클릭합니다.
  • 이름과 값을 입력합니다.
  • 확인 을 클릭합니다.
• 확인 을 클릭하여 환경 변수 창을 닫습니다.

저희가 의존하는 변수, 그리고 가리키는 대상은 다음과 같습니다:

ANDROID_HOME

• Android SDK 를 설치한 디렉터리 또는 ADT 를 설치한 경우 sdk 디렉터리로 설정합니다.
• platform-tools 라는 디렉터리를 포함해야 합니다.

JAVA_HOME

• JDK 가 설치된 디렉터리로 설정합니다. jdk1.8.0_121 식의 이름일 것입니다.
• javac.exe 가 들어있는 bin 디렉터리가 들어있어야 합니다.

ANT_HOME

• Ant 압축을 푼 디렉터리로 설정합니다.
• ant.bat 가 들어있는 bin 디렉터리가 들어있어야 합니다.

NDKROOT

• NDK 압축을 푼 디렉터리로 설정합니다. android-ndk-r11c 식의 이름일 것입니다.
• ndk-build.cmd 라는 파일이 들어있어야 합니다.

CodeWorks for Android 1R6u1 를 설치한 것이 아니라면, 일부 환경 변수가 제대로 설정되었는지 확인해 줘야 합니다.

환경 변수 설정을 위해서는 홈 디렉터리의 .bash_profile 파일을 편집해야 합니다. 파일은 Finder 에 숨겨져 있으므로, Terminal 을 사용해서 열어야 편집할 수 있습니다. 유닉스 터미널 명령에 익숙치 않으신 분들을 위해 다음과 같이 방법을 안내해 드립니다.

1. /Applications/Utilities 에서 Terminal app 을 실행시킵니다.
2. touch .bash_profile 라고 입력하여 파일이 존재하지 않는다면 만들어 줍니다.
3. open .bash_profile 라고 입력하여 텍스트 에디터에서 파일을 엽니다.

4. 다음 줄을 복사하여 파일에 붙여넣고 (경로는 설치된 SDK 와 툴로 수정한 다음) 저장합니다:

   • export ANDROID_HOME="/Users/epicgames/Devel/NVPACK/android-sdk-macosx"
   • export NDKROOT="/Users/epicgames/Devel/NVPACK/android-ndk-r12b"
   • export ANT_HOME="/Users/epicgames/Devel/NVPACK/apache-ant-1.8.2"

종속 변수 이름 및 그 변수가 가리키는 대상은 다음과 같습니다:

• ANDROID_HOME
  • Android SDK 를 설치한 디렉터리 또는 ADT 를 설치한 경우 SDK 디렉터리로 설정합니다.
  • platform-tools 라는 디렉터리를 포함해야 합니다.
• ANT_HOME
  • Ant 압축을 푼 디렉터리로 설정합니다.
  • ANT 라는 파일이 들어있는 bin 디렉터리가 들어있어야 합니다.
• NDKROOT
  • NDK 압축을 푼 디렉터리로 설정합니다. android-ndk-r12b 식의 이름일 것입니다.
  • ndk-build 라는 파일이 들어있어야 합니다.

*실행 메뉴에 디바이스가 나열되지 않는 경우 해 볼 수 있는 작업은 다음과 같습니다:

• 몇 초 기다린 다음 다시 살펴봅니다. 연결된 디바이스의 백그라운드 탐색 작업에 시간이 약간 걸릴 수 있기 때문입니다.
• USB 디버깅 연결이 모두 작동중인지 점검합니다.
• 명령줄을 엽니다 (Windows+R 키를 누른 다음 cmd.exe 를 실행시킵니다).
  • 이 명령을 입력합니다: adb devices
  • 디바이스가 나열되지 않으면, USB 드라이버가 제대로 설치되지 않은 것입니다. 드라이버 설치 방법은 Android 디바이스 모델에 따라 다릅니다. 디바이스 모델명에 "USB driver" 를 붙여 검색한 다음 드라이버를 설치하세요.
  • 추가적으로, 디바이스에 개발자 모드가 켜졌는지, USB 디버깅 기능이 켜졌는지 확인하십시오. 자세한 정보는 Android Developer Using Hardware Devices guide 문서를 (특히 2, 3 번 항목을) 참고하세요.
  • 이후, adb devices 명령이 정상 작동하는지 확인합니다. 이 부분이 되지 않으면, 엔진에서는 Android 디바이스 관련해서 어떠한 작업도 할 수 없습니다.

디바이스가 실행 메뉴에 나타나긴 하는데 디바이스에 디플로이할 때 멈추는 경우, 거의 디바이스가 PC 와의 통신 권한이 없기 때문입니다. 진행상황 막대의 Show Log (로그 표시) 줄을 클릭하면, 마지막 줄에서 adb uninstall 를 호출중임을 볼 수 있을 것입니다.

• 위와 마찬가지로, cmd.exe 에서 adb devices 명령을 실행합니다.
• 디바이스가 나오긴 하는데 권한이 없는 것으로 나오는 경우, 디바이스에게 PC 와의 통신을 허가해야 함을 나타냅니다.
• 디바이스 케이블을 뽑은 다음 다시 연결해야 나타날 수도 있습니다.
• Always allow (항상 허용) 체크박스가 체크되었는지도 확인할 것을 추천합니다.

실행 메뉴의 목록에 디바이스가 보이지 않는 경우, 해 볼 수 있는 작업은 다음과 같습니다:

• 몇 초 기다린 다음 다시 살펴봅니다. 연결된 디바이스의 등록을 위한 백그라운드 탐색 작업에 시간이 약간 걸릴 수 있기 때문입니다.
• USB 디버깅 연결이 모두 작동중인지 점검합니다.
• Terminal 앱을 연 뒤 다음 작업을 해 줍니다.
  • 터미널에 adb devices 명령을 입력합니다.
  • 디바이스가 나열되지 않으면, USB 드라이버가 제대로 설치되지 않은 것입니다. 드라이버 설치 방법은 Android 디바이스 모델에 따라 다릅니다. 디바이스 모델명에 usb driver 를 붙여 검색한 다음 필요한 드라이버를 설치하세요.
  • 추가적으로, 디바이스에 개발자 모드가 켜졌는지, USB 디버깅 기능이 켜졌는지 확인하십시오. 자세한 정보는 Android Developer Using Hardware Devices guide 문서를 (특히 2, 3 번 항목을) 참고하세요.
  • 이후, adb devices 명령이 정상 작동하는지 확인합니다. 이 부분이 되지 않으면, 엔진에서는 Android 디바이스 관련해서 어떠한 작업도 할 수 없습니다.

디바이스가 실행 메뉴 에 나타나긴 하는데 디바이스에 디플로이할 때 멈추는 경우, 거의 디바이스가 Mac과의 통신 권한이 없기 때문입니다. 진행상황 막대의 Show Log (로그 표시) 줄을 클릭하면, 마지막 줄에서 adb uninstall 를 호출중임을 볼 수 있을테니, 다음 작업을 해 줍니다:

• 위와 마찬가지로, Terminal 앱을 열어 adb devices 명령을 실행합니다.
• 디바이스가 나오긴 하는데 권한이 없는 것으로 나오는 경우, 디바이스에게 Mac과의 통신을 허가해야 함을 나타냅니다.
• Mac이 이 디바이스와 항상 통신하도록 하려면 Always allow (항상 허용) 박스를 체크할 것을 추천합니다.