Запуск приложения Apache Cordova в Android

Статья
09/13/2015

В Visual Studio 2013 инструменты Cordova выпущены в виде предварительной (CTP) версии. Инструменты Cordova будут выпущены как часть Visual Studio 2015, и рекомендуется использовать Visual Studio 2015 RTM для разработки приложений с помощью инструментов Visual Studio для Apache Cordova. Visual Studio можно скачать из Центра загрузки Майкрософт.

Предусмотрено много вариантов запуска приложений, созданных с помощью Visual Studio Tools для Apache Cordova, в системе Android. В Visual Studio приложения Android можно запускать и отлаживать в следующих эмуляторах и устройствах:

Имитатор Apache Ripple (см. описание в отдельной статье)
Эмулятор Visual Studio для Android
Эмулятор Android
Эмулятор Genymotion
Устройство Android, подключенное к компьютеру

При возникновении ошибок построения для Android просмотрите эти советы и способы решения проблем.

Эмулятор Visual Studio для Android (Hyper-V)

Выполните следующие инструкции для запуска приложения в эмуляторе Visual Studio для Android. Требования к системе см. в разделе Требования к системе для эмулятора Visual Studio для Android.

Важно!

Эмулятор Visual Studio для Android доступен только в Visual Studio 2015.

Запуск приложения в эмуляторе

Убедитесь, что Hyper-V включен на вашем ПК. ПК должен соответствовать требованиям к системе для эмулятора Visual Studio для Android.

Важно!

Эмулятор не поддерживается в виртуальной среде.
Откройте приложение в Visual Studio и выберите Android в списке Платформы решения. Если этот список не отображается, выберите Платформы решения в списке Добавить или удалить кнопки для его отображения.
Выберите один из эмуляторов, например эмулятор VS для телефона 5" KitKat (4.4) XHDPI.
Нажмите клавишу F5 для запуска приложения.

Visual Studio запускает эмулятор и приложение.

Настройка высокопроизводительного эмулятора (без Hyper-V)

Если у вас есть ПК с процессором Intel, то уровень производительности эмуляторов Android и Genymotion можно повысить. Настройка высокопроизводительного эмулятора:

Отключите Hyper-V. Для этого можно использовать панель управления или командную строку, как описано в следующих процедурах.

Предупреждение

Отключение Hyper-V не позволит использовать эмулятор Visual Studio для Android и эмулятор Windows Phone.Однако при отключенном Hyper-V можно будет по-прежнему выполнять развертывание на устройстве Windows Phone.
(Только для эмулятора Android) Установите высокопроизводительный драйвер Intel Hardware Accelerated Execution Manager (HAXM), если он еще не установлен. (Дополнительные сведения о драйвере HAXM)
Настройте эмулятор Android для применения аппаратного ускорения.

Отключение Hyper-V на панели управления

На панели управления выберите Программы и компоненты, а затем Включение или отключение компонентов Windows.
Снимите флажок для Hyper-V.
Перезагрузите компьютер.

Теперь можно установить драйвер HAXM.

Кроме того, с помощью командной строки можно настроить Windows таким образом, чтобы данная ОС запускалась автоматически включенным или отключенным Hyper-V.

Отключение Hyper-V с помощью командной строки

Откройте командную строку с повышенными привилегиями (с учетными данными администратора) и введите:
```
bcdedit /set hypervisorlaunchtype off
```
Предупреждение

Команды bcdedit позволяют предотвращать загрузку системы, если она выполняется неправильно. Будьте внимательны при использовании этих команд.

Если вы добавляете эту команду в скрипт оболочки, то используйте следующую команду:
```
bcdedit /set hypervisorlaunchtype off
shutdown /r
```
Перезагрузите компьютер.

Если вы хотите снова включить Hyper-V позже, используйте следующую команду, а затем перезагрузите свой компьютер:
```
bcdedit /set hypervisorlaunchtype auto
```

Если вы используете эмулятор Genymotion, то эту процедуру можно пропустить. Дополнительные сведения см. в разделе Эмулятор Genymotion.

Установка высокопроизводительного драйвера HAXM (только для эмулятора Android)

После отключения Hyper-V и перезагрузки ПК откройте диспетчер Android SDK Manager. Чтобы сделать это из окна командной строки, перейдите в расположение пакета SDK и введите android.

В Windows файл Manager.exe пакета SDK Android установлен по следующему пути: C:\Program Files (x86)\Android\android-sdk.
В диспетчере Android SDK Manager в разделе Вспомогательные элементы найдите ускоритель Intel x86 Emulator Accelerator (установщик HAXM). Если столбец состояния показывает, что эта программа не установлена, установите соответствующий флажок, а затем выберите Установка пакетов.
Для установки драйвера перейдите в sdk-path\extras\intel\Hardware_Accelerated_Execution_Manager и запустите файл intelhaxm.exe.

Совет

Если часть «intel» пути отсутствует, это означает, что драйвер не установлен.

Теперь можно настроить эмулятор для использования драйвера. При создании или редактировании эмулятора необходимо использовать процессор Intel и выбрать параметр Использовать GPU узла. Дополнительные сведения см. в следующем разделе.

Эмулятор Android

Перед запуском своего приложения в эмуляторе Android в Visual Studio с помощью диспетчера Android Virtual Device (AVD) Manager создайте конфигурацию эмулятора, а затем запустите эмулятор из диспетчера AVD. Эти действия показаны ниже. Дополнительные сведения см. в разделе Документация по диспетчеру AVD.

Создание экземпляра эмулятора

Откройте диспетчер AVD. Чтобы сделать это из окна командной строки, перейдите в расположение пакета SDK и введите android avd.

В Windows файл Manager.exe AVD установлен по следующему пути: C:\Program Files (x86)\Android\android-sdk.
В диспетчере AVD выберите Создать.
Настройте свойства нового эмулятора.

К обязательным свойствам относятся Имя AVD, Устройство, Цель, ЦП/ABI и Обложка. Цель представляет собой установленную версию Android SDK (набор API). Для этого свойства установите значение Уровень API 19.

Совет

Если требуется эмулировать другие версии устройств Android, можно установить образы, используя диспетчер Android SDK Manager.
Если вы установили высокопроизводительный драйвер HAXM (в предыдущем разделе) и выбрали процессор Intel, то установите флажок Использовать GPU узла в поле Параметры эмуляции.

Важно!

Для использования высокопроизводительного эмулятор также необходимо выбрать процессор Intel в разделе ЦП/ABI диалогового окна AVD.
Нажмите ОК, чтобы закрыть диалоговое окно конфигурации, а затем снова нажмите ОК в диалоговом окне, где отображаются все параметры эмулятора.
Выберите новый эмулятор в диспетчере AVD, а затем нажмите Пуск.

Запуск приложения в эмуляторе

Откройте приложение в Visual Studio и выберите Android в списке Платформы решения. (Если этот параметр не отображается, сначала выберите Платформы решения в списке Добавить или удалить кнопки.)
В списке устройств выберите Эмулятор Android.
Нажмите клавишу F5 для запуска приложения или Shift + F5 для запуска приложения без отладки.

Для присоединения отладчика требуется платформа Android 4.4. В противном случае, приложение будет выполняться без отладки.
Совет
- Если появляется сообщение об ошибке с информацией о том, что необходимо установить новую версию Android SDK, то для ее установки используйте диспетчер Android SDK Manager.Чтобы открыть диспетчер SDK Manager в Windows, в командной строке введите следующую команду: android sdk.
- Visual Studio развертывает приложение в эмуляторе Android, который выполняется в настоящее время.Если эмулятор не выполняется, то Visual Studio запускает последний эмулятор, который был создан с помощью диспетчера AVD, а затем развертывает приложение.
- Если необходимо выполнить отладку приложения для версий Android 4.1.2-4.3, ознакомьтесь с информацией о подключаемом модуле jsHybugger в статье Отладка приложения, созданного с помощью Visual Studio Tools для Apache Cordova.

Эмулятор Genymotion

Эмулятор Genymotion представляет собой популярную альтернативу эмулятору Android, который входит в состав пакета Android SDK. Ниже приведены несколько советов по началу работы с эмулятором.

В случае проблем с запуском эмулятора при удаленном подключении попробуйте запустить его локально и, при необходимости, снова установите удаленное соединение. Эмулятор требует наличие OpenGL для визуализации, а это может привести к конфликтам при запуске эмулятора.
Требуется иметь видеокарту и ее драйверы, которые поддерживают OpenGL. Могут выводиться сообщения, указывающие на это. (При удаленном подключении к ПК также может появляться данное сообщение. Попробуйте еще раз установить удаленное соединение после локального подключения.)
При попытке запуска эмулятора может появляться сообщение о необходимости проверки конфигурации сети VirtualBox. При изменении или удалении из VirtualBox записи «Сетевой адаптер только для узла» следуйте ссылке и инструкциям. (VirtualBox входит в состав установки эмулятора).
Для высокопроизводительной эмуляции с помощью Genymotion отключите Hyper-V перед запуском эмулятора, как описано в разделе Настройка высокопроизводительного эмулятора.

Инструменты разработчика Android воспринимают Genymotion как физическое устройство. При использовании Visual Studio для запуска приложения вы указываете, что Visual Studio должен выполнить развертывание на устройстве Android.

Запуск приложения в эмуляторе Genymotion

Запустите эмулятор Genymotion.
Откройте приложение в Visual Studio и выберите Android в списке Платформы решения. Если эта платформа не отображается, выберите Платформы решения в списке Добавить или удалить кнопки.
В списке устройств выберите Устройство.
Нажмите клавишу F5 для запуска приложения или Shift + F5 для запуска приложения без отладки.

Устройства Android

Прежде, чем можно будет использовать Visual Studio для запуска приложения на подключенном устройстве Android, нужно установить необходимый драйвер:

OEM-драйвер устройства или
Драйвер Google USB для устройств Google Nexus

Также необходимо убедиться, что ваше устройство находится в режиме разработчика. Инструкции содержатся в разделе «Включение параметров разработчика на устройстве» и «Настройка устройства для разработки» на странице Использование устройств на сайте Android.

Для развертывания конфигурации выпуска или распространения приложения его сначала необходимо подписать. Дополнительные сведения см. в разделе Упаковка приложения.

Запуск приложения на устройстве Android

Убедитесь, что установлен необходимый драйвер OEM или Google USB.
Убедитесь, что ваше устройство Android находится в режиме разработчика (см. страницу Использование устройств на сайте Android).
С помощью средства adb.exe убедитесь, что adb (мост отладки Android) видит устройство.
1. Откройте командную строку разработчика VisualStudio в режиме администратора.
2. Введите следующую команду:
```
"%ADT_HOME%\platform-tools\adb.exe" devices
```
  Устройство будет отображено в списке, как показано ниже.
Откройте приложение в Visual Studio и выберите Android в списке Платформы решения. (Если этот параметр не отображается, выберите Платформы решения в списке Добавить или удалить кнопки.)
В списке устройств выберите Устройство.
Нажмите клавишу F5 для запуска приложения или Shift + F5 для запуска приложения без отладки.
В ответ на приглашение выберите Разрешить отладку USB.