Android에서 Apache Cordova 앱 실행

아티클
06/10/2015

*이 문서는 시험판 소프트웨어인 Visual Studio Tools for Apache Cordova에 대해 설명합니다. 설명하는 기능은 미리 보기에 있으며 변경될 수 있습니다. Microsoft 다운로드 센터.*에서 미리 보기를 다운로드할 수 있습니다.

Visual Studio Tools for Apache Cordova를 사용하여 빌드한 앱을 Android에서 실행하는 데 사용되는 옵션은 매우 다양합니다. Visual Studio에서는 다음 에뮬레이터와 장치에서 Android 앱을 실행 및 디버그할 수 있습니다.

Apache Ripple 에뮬레이터(별도의 문서에서 설명함)
Android 에뮬레이터
Genymotion 에뮬레이터
Android 장치

고성능 에뮬레이터 구성

Intel 프로세서가 장착된 PC를 사용하는 경우 Android 및 Genymotion 에뮬레이터의 성능을 개선할 수 있습니다. 고성능 에뮬레이터를 구성하려면 다음을 수행합니다.

Hyper-V를 사용하지 않도록 설정합니다. 다음 절차에서 설명하는 대로 제어판이나 명령줄에서 이 작업을 수행할 수 있습니다.

경고

Hyper-V를 사용하지 않도록 설정하면 Windows Phone 에뮬레이터를 사용할 수 없게 됩니다.그러나 Hyper-V를 사용하지 않도록 설정한 상태에서도 Windows Phone 장치를 배포할 수 있습니다.
(Android 에뮬레이터에만 해당) 고성능 인텔 HAXM(하드웨어 가속 실행 관리자) 드라이버가 설치되어 있지 않으면 설치합니다. HAXM 드라이버에 대한 자세한 내용은 여기를 참조하세요.
하드웨어 가속을 사용하도록 Android 에뮬레이터를 구성합니다.

제어판에서 Hyper-V를 사용하지 않도록 설정하려면

제어판에서 프로그램 및 기능을 선택하고 Windows 기능 사용/사용 안 함을 선택합니다.
Hyper-V의 확인란 선택을 취소합니다.
PC를 다시 부팅합니다.

이제 HAXM 드라이버를 설치할 수 있습니다.

명령줄을 사용하여 Hyper-V가 자동으로 사용하거나 사용하지 않도록 설정된 상태로 Windows를 시작하도록 구성할 수도 있습니다.

명령줄을 사용하여 Hyper-V를 사용하지 않도록 설정하려면

관리 자격 증명을 사용하여 관리자 권한 명령 프롬프트를 열고 다음 명령을 입력합니다.
```
bcdedit /set hypervisorlaunchtype off
```
경고

bcdedit 명령을 올바르게 실행하지 않으면 시스템이 부팅되지 않을 수 있으므로 이러한 명령을 사용할 때는 주의해야 합니다.

셸 스크립트에 이 명령을 추가하는 경우에는 다음 명령을 대신 사용합니다.
```
bcdedit /set hypervisorlaunchtype off
shutdown /r
```
PC를 다시 부팅합니다.

Hyper-V를 나중에 다시 사용하도록 설정하려는 경우 다음 명령을 사용하고 PC를 다시 부팅합니다.
```
bcdedit /set hypervisorlaunchtype auto
```

Genymotion 에뮬레이터를 사용하는 경우에는 이 절차를 건너뛸 수 있습니다. 자세한 내용은 Genymotion 에뮬레이터를 참조하세요.

고성능 HAXM 드라이버를 설치하려면(Android 에뮬레이터에만 해당)

Hyper-V를 사용하지 않도록 설정하고 PC를 다시 부팅한 후에 Android SDK Manager를 엽니다. 이를 명령줄에서 수행하려면 SDK의 위치로 이동하고 android를 입력합니다.

Windows에서는 Android SDK Manager.exe가 C:\Program Files (x86)\Android\android-sdk에 설치됩니다.
Android SDK Manager의 Extras에서 Intel x86 에뮬레이터 가속기(HAXM 설치 관리자)를 찾습니다. 상태 열에 이 항목이 설치되어 있지 않다고 표시되면 해당 확인란을 선택하고 설치 패키지를 선택합니다.
sdk-path\extras\intel\Hardware_Accelerated_Execution_Manager로 이동한 다음 intelhaxm.exe를 실행하여 드라이버를 설치합니다.

팁

경로에 "intel" 부분이 없으면 드라이버가 설치되지 않은 것입니다.

이제 드라이버를 사용하도록 에뮬레이터를 구성할 수 있습니다. 에뮬레이터를 만들거나 편집할 때는 Intel CPU를 사용해야 하며 호스트 GPU 사용 옵션을 선택해야 합니다. 자세한 내용은 다음 단원을 참조하세요.

Android 에뮬레이터

Visual Studio의 Android 에뮬레이터에서 앱을 실행하기 전에 AVD(Android Virtual Device) Manager를 사용하여 에뮬레이터 구성을 만든 다음 AVD Manager에서 에뮬레이터를 시작합니다. 다음 단계에서는 이러한 작업을 수행하는 방법을 보여 줍니다. 자세한 내용은 AVD Manager 설명서를 참조하세요.

에뮬레이터 인스턴스를 만들려면

AVD Manager를 엽니다. 이를 명령줄에서 수행하려면 SDK의 위치로 이동하고 android avd를 입력합니다.

Windows에서는 AVD Manager.exe가 C:\Program Files (x86)\Android\android-sdk에 설치됩니다.
AVD Manager에서 새로 만들기를 선택합니다.
새 에뮬레이터의 속성을 구성합니다.

필수 속성은 AVD 이름, 장치, 대상, CPU/ABI 및 스킨입니다. 대상은 설치된 Android SDK 버전(API 집합)을 나타냅니다. 이 속성은 API 수준 19로 설정합니다.
이전 단원에서 고성능 HAXM 드라이버를 설치했으며 Intel CPU를 선택한 경우 에뮬레이션 옵션에서 호스트 GPU 사용 확인란을 선택합니다.

중요

고성능 에뮬레이터를 사용하려면 AVD 대화 상자의 CPU/ABI 섹션에서도 Intel 프로세서를 선택해야 합니다.
확인을 선택하여 구성 대화 상자를 닫은 다음 모든 에뮬레이터 설정이 표시되는 대화 상자에서 확인을 다시 선택합니다.
AVD Manager에서 새 에뮬레이터를 선택하고 시작을 선택합니다.

에뮬레이터에서 앱을 실행하려면

Visual Studio에서 앱을 열어 두고 솔루션 플랫폼 목록에서 Android를 선택합니다. 이 옵션이 표시되지 않으면 단추 추가/제거 목록에서 솔루션 플랫폼을 선택합니다.
장치 목록에서 Android 에뮬레이터를 선택합니다.
F5 키를 눌러 앱을 시작하거나 Shift+F5를 눌러 디버깅하지 않고 앱을 시작합니다.

디버거를 연결하려면 Android 4.4가 필요합니다. 그렇지 않으면 앱이 디버깅되지 않고 실행됩니다.
팁
- Android SDK의 새 버전을 설치해야 한다는 오류가 표시되면 Android SDK Manager를 사용하여 해당 버전을 설치합니다.Windows에서는 SDK Manager.exe가 C:\Program Files (x86)\Android\android-sdk에 설치됩니다.
- Visual Studio에서는 현재 실행 중인 Android 에뮬레이터로 앱을 배포합니다.에뮬레이터가 실행되고 있지 않으면 AVD Manager를 사용하여 마지막으로 만든 에뮬레이터를 시작한 다음 앱을 배포합니다.
- Android 버전 4.1.2-4.3에 대해 앱을 디버그하려면 Visual Studio Tools for Apache Cordova를 사용하여 빌드한 앱 디버그 문서에서 jsHybugger 플러그 인에 대한 정보를 참조하세요.

Genymotion 에뮬레이터

Genymotion 에뮬레이터는 Android SDK에 포함된 Android 에뮬레이터 대신 널리 사용되는 에뮬레이터입니다. 아래에는 이 에뮬레이터를 시작하기 위한 몇 가지 팁이 나와 있습니다.

원격 연결에서 에뮬레이터를 시작하는 데 문제가 있으면 로컬로 에뮬레이터를 시작하고 필요한 경우 원격으로 다시 연결합니다. 에뮬레이터에서는 렌더링을 위해 OpenGL을 사용해야 하므로 에뮬레이터 시작 시 충돌이 발생할 수 있습니다.
OpenGL을 지원하는 비디오 카드와 비디오 카드 드라이버가 필요합니다. 여기에 대한 메시지가 표시될 수 있습니다. PC에 원격으로 연결하는 경우에도 이 메시지가 표시될 수 있습니다. 이 경우에는 로컬로 연결한 후에 다시 시도합니다.
에뮬레이터를 시작하려고 하면 VirtualBox 네트워크 구성을 확인하라는 메시지가 표시될 수 있습니다. 이 경우 링크를 따라 이동하여 지침에 따라 VirtualBox에서 "호스트 전용 네트워크 어댑터"를 수정하거나 제거합니다. VirtualBox는 에뮬레이터 설치 시에 함께 설치됩니다.
Genymotion을 사용하는 고성능 에뮬레이션의 경우 앞의 구성능 에뮬레이터 구성에서 설명한 것처럼 에뮬레이터를 시작하기 전에 Hyper-V를 사용하지 않도록 설정합니다.

Android 개발자 도구에는 Genymotion이 실제 장치로 표시됩니다. Visual Studio를 사용하여 앱을 실행할 때는 Android 장치로 앱을 배포하도록 Visual Studio에 명령합니다.

Genymotion 에뮬레이터에서 앱을 실행하려면

Genymotion 에뮬레이터를 시작합니다.
Visual Studio에서 앱을 열어 두고 솔루션 플랫폼 목록에서 Android를 선택합니다. 이 옵션이 표시되지 않으면 단추 추가/제거 목록에서 솔루션 플랫폼을 선택합니다.
장치 목록에서 장치를 선택합니다.
F5 키를 눌러 앱을 시작하거나 Shift+F5를 눌러 디버깅하지 않고 앱을 시작합니다.

Android 장치

Visual Studio를 사용하여 연결된 Android 장치에서 앱을 실행하려면 필요한 드라이버를 설치해야 합니다.

장치별 OEM 드라이버 또는
Google Nexus 장치용 Google USB 드라이버

또한 장치가 개발자 모드인지도 확인해야 합니다. 관련 지침은 Android 웹 사이트의 하드웨어 장치 사용 페이지에서 "장치의 개발자 옵션 사용" 및 "개발용으로 장치 설정"을 참조하세요.

앱 릴리스 또는 배포 구성을 배포하려면 먼저 앱에 서명을 해야 합니다. 자세한 내용은 Visual Studio Tools for Apache Cordova를 사용하여 빌드한 앱 패키지을 참조하십시오.

Android 장치에서 앱을 실행하려면

필요한 OEM 또는 Google USB 드라이버를 설치했는지 확인합니다.
Android 장치가 개발자 모드인지 확인합니다(Android 웹 사이트에서 하드웨어 장치 사용 참조).
Visual Studio에서 앱을 열어 두고 솔루션 플랫폼 목록에서 Android를 선택합니다. 이 옵션이 표시되지 않으면 단추 추가/제거 목록에서 솔루션 플랫폼을 선택합니다.
장치 목록에서 장치를 선택합니다.
F5 키를 눌러 앱을 시작하거나 Shift+F5를 눌러 디버깅하지 않고 앱을 시작합니다.
메시지가 나타나면 USB 디버깅 허용을 선택합니다.