Android 환경 설정

Android에서 빌드하고 실행하려면 Unity Android Build Support 플랫폼 모듈을 설치해야 합니다. 또한 Android 기기에서 코드를 빌드하고 실행하기 위해 필요한 Android SDK(Software Development Kit, 소프트웨어 개발 키트)와 NDK(Native Development Kit, 네이티브 개발 키트)를 설치해야 합니다. Unity는 기본적으로 OpenJDK에 기반한 Java Development Kit를 설치합니다.

참고: Unity는 Android 4.4 “KitKat” 이상을 지원합니다. 자세한 내용은 AndroidSdkVersions를 참조하십시오.

Android 빌드 지원과 Android SDK 및 NDK 툴 설치

Unity Hub를 사용하여 Android 빌드 지원과 필수 종속성인 Android SDK 및 NDK 툴 과 OpenJDK 를 설치할 수 있습니다.

Unity 에디터를 설치할 때 Android 빌드 지원과 Android SDK & NKD 툴, OpenJDK 툴을 설치하거나 나중에 추가할 수 있습니다.

Android 모듈을 추가하는 방법에 대한 자세한 내용은 다음과 같습니다.

• 설치 시점에 추가하는 경우 Unity 설치를 참조하십시오.
• 기존 설치에 추가하는 경우 에디터에 모듈 추가를 참조하십시오.

디바이스에서 USB 디버깅 활성화

USB 디버깅을 활성화하려면 기기에서 반드시 개발자 옵션을 활성화해야 합니다. 이렇게 하려면 Android의 개발자 옵션 설정 문서를 참조하십시오.

컴퓨터에 기기를 연결하기 위해 USB 케이블을 사용합니다. Windows 컴퓨터에서는 기기에 맞는 USB 드라이버를 설치해야 할 수 있습니다. 자세한 내용은 기기 제조사 웹 사이트를 참조하십시오.

설치 절차는 운영체제가 Windows인지 macOS인지에 따라 다릅니다. Android 기기를 SDK에 연결하는 데 대한 자세한 내용은 Android 개발자 문서에 있는 앱 실행 섹션을 참조하십시오.

Chrome OS 기기를 위한 ADB 디버깅

Chrome OS 기기를 위한 개발 환경을 설정하는 방법은 Chrome OS 개발자 환경에 있는 Google 문서를 참조하십시오.

Chrome OS 기기 연결

기기에 배포하기 전에 기기의 IP 주소를 통해 ADB로 수동 연결해야 합니다.

시작하려면 IP 주소가 필요합니다. Settings 앱을 열어 사이드바에 있는 Network를 선택합니다. 그 다음 활성화된 네트워크 인터페이스를 클릭합니다.

인터페이스에 무선이 활성화되어 있다면 그 다음엔 연결되어 있는 SSID를 선택합니다. 세부 정보에서 IP주소를 볼 수 있습니다. IP 주소를 메모해 둡니다.

유선 연결을 사용한다면 IP 주소는 첫 번째 세부 정보 페이지에서 볼 수 있습니다.

이제 연결할 준비가 되었습니다. 기기의 IP 주소가 192.168.0.100이라고 예를 들어보겠습니다. 셸이나 터미널에서 다음과 같은 커맨드가 실행됩니다.

adb connect 192.168.0.100

성공적으로 연결이 되면 connected to 192.168.0.65:5555와 같은 메시지가 표시됩니다. 그리고 adb devices는 해당 기기가 연결되었는지 확인합니다.

List of devices attached 192.168.0.65:5555 device

이제 USB 연결을 통해 하는 것처럼 ADB 커맨드를 실행하여 기기를 지정할 수 있습니다.

참고: 기기나 호스트 컴퓨터가 절전 모드이거나 네트워크 연결이 끊어진 경우 다시 연결해야 합니다.

Android SDK 및 NDK 툴과 OpenJDK 설치 커스터마이즈

올바른 버전과 설정을 사용할 수 있도록 Unity Hub를 통해 Android SDK 및 NDK 툴을 설치해야 합니다. Unity는 Android SDK 툴과 NDK 툴, OpenJDK를 SDK, NDK, /Unity/Hub/Editor/[EditorVersion]/Editor/Data/PlaybackEngines/AndroidPlayer/에 있는 폴더에 각각 설치합니다.

동일한 필수 종속성(최신 시스템 요구 사항 확인)을 가진 여러 Unity 버전을 가지고 있고 Android SDK 및 NDK 툴과 OpenJDK를 중복으로 설치하지 않으려면 Unity 환경 설정 창에서 공유 위치를 지정할 수 있습니다. 이렇게 하려면 Preferences > External tools 로 이동하여 다음과 같이 SDK 와 NDK 필드에 디렉토리 경로를 입력합니다.

경고: Unity는 직접 제공하는 OpenJDK, SDK 또는 NDK 버전 외 다른 버전을 공식 지원하지 않습니다.

Unity가 Android 앱 빌드에 사용하는 OpenJDK, SDK 툴 또는 NDK를 변경하려면 다음 절차를 따르십시오.

1. Unity 프로젝트를 엽니다.

2. Preferences 창(Windows 및 Linux: Edit > Preferences, macOS: Unity > Preferences)을 엽니다.

3. 왼쪽 내비게이션 열에서 External Tools 를 선택합니다.

4. OpenJDK 경로를 다음과 같이 변경합니다.
   1. JDK Installed with Unity (recommended) 설정을 비활성화합니다.
   2. JDK 필드에 JDK 설치 폴더 경로를 입력하거나 Browse 버튼을 사용하여 경로를 찾습니다.
5. Android SDK 툴 경로를 변경합니다.
   1. Android SDK Tools Installed with Unity (recommended) 설정을 비활성화합니다.
   2. SDK 필드에 SDK 설치 폴더 경로를 입력하거나 Browse 버튼을 사용하여 경로를 찾습니다.

   참고: Unity는 Unity 버전 릴리스 시점에 이용 가능한 대부분의 최신 Android SDK 버전을 지원합니다.

6. Android NDK 경로를 다음과 같이 변경합니다.
   1. Android NDK Installed with Unity (recommended) 를 선택 해제합니다.
   2. NDK 필드에 NDK 설치 폴더 경로를 입력하거나 Browse 버튼을 사용하여 경로를 찾습니다.

각 Unity 버전에 다음과 같은 특정 Android NDK 버전이 필요합니다.

Unity 버전	NDK 버전
2018.4 LTS	r16b
2019.4 LTS	r19
2020.3 LTS	r19
2021.1	r21d

요구 사항에 대한 전체 리스트는 시스템 요구 사항 페이지를 참조하십시오.

Android SDK 타겟 API 업데이트

Unity Hub는 Google Play에 필요한 최신 버전의 Android SDK 타겟 API를 설치합니다.

더 최신 버전을 사용해야 하는 경우 Player Settings 창(메뉴: Edit > Project Settings > Player에서 Android 플랫폼 선택)의 Target API Level 필드에서 타겟 API를 변경할 수 있습니다. Target API Level 옵션은 Other Settings > Identification 섹션에서 찾을 수 있습니다.

기본값 이외의 옵션을 선택하면 Android SDK API를 업데이트하라는 메시지가 표시됩니다. 다음 중 하나를 선택할 수 있습니다.

• Android SDK 업데이트
• 설치된 가장 높은 버전의 Android SDK를 계속 사용

이전 타겟 API 버전을 선택하면 Unity Android SDK 업데이터가 업데이트를 수행할 수 없고 오류 메시지가 표시됩니다.

이런 경우 Android SDK Target API를 업데이트하려면 Android Studio나 커맨드 라인 툴에서 Android sdkmanager를 반드시 사용해야 합니다. 선택한 방법과는 관계없이 Edit > Preferences > External Tools 창에서 Unity용 올바른 Android SDK 폴더를 선택해야 합니다.

중요: Windows에서 Unity 에디터를 기본 폴더(/Program Files/)에 설치했다면 높은 권한(관리자 권한으로 실행)으로 sdkmanager를 실행해야 업데이트를 수행할 수 있습니다.