Установка Visual Studio Tools для Apache Cordova

Статья
09/13/2015

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

Воспользуйтесь удобным установщиком для создания межплатформенных приложений с помощью Visual Studio и Apache Cordova. При работе с установщиком не нужно определять требуемые пакеты SDK, инструменты и библиотеки (и выбирать подходящие версии).

Содержание

Требования
Получение инструментов
Установка инструментов
Установка инструментов для iOS
Дополнительные задачи

Требования

Требования к операционной системе:

Windows 7, Windows 8, Windows 8.1, Windows 10 или Windows Server 2012 R2.

Важно!

Если используется система Windows 7, то приложения можно разрабатывать для iOS и Android, но не для Windows или Windows Phone.

Применительно к построению специфических платформ устройств существует несколько дополнительных требований:

Для iOS и эмулятора iOS требуется компьютер Mac, который может запускать Xcode 6 (Xcode 6 рекомендуется). Дополнительные сведения и инструкции по установке см. в разделе Установка средств для iOS.

Совет

Если требуется выполнить сборку iOS в облачной службе, а не на оборудовании Mac, см. инструкции в разделе Сборка и моделирование iOS в облаке.
Эмуляторы Android лучше всего работают на компьютерах, где можно запускать Hyper-V или драйвер Intel HAXM. См. раздел Запуск приложения Apache Cordova в Android.
Для эмуляторов Windows Phone требуется компьютер, который может запускать Hyper-V.
Для создания приложений универсальной платформы для Windows 10 требуется установить Инструменты Windows 10 для Visual Studio. Обратите внимание, что приложения Windows 8.1 или Windows Phone 8.1 также могут быть развернуты в Windows 10.

Получение инструментов

Получите Инструменты Visual Studio Tools для Apache Cordova, которые входят в состав Visual Studio 2015 в качестве дополнительного компонента. Для установки средств выполните инструкции в следующем разделе.

Важно!

Visual Studio 2015 рекомендуется для разработки приложений Apache Cordova.Если ранее была установлена предварительная, CTP-версия или версия-кандидат Visual Studio 2015, необходимо сначала удалить ее в разделе "Программы и компоненты" панели управления, а затем установить Visual Studio 2015.

Установка инструментов

При установке Visual Studio Tools для Apache Cordova установщик Visual Studio выбирает для установки дополнительное программное обеспечение сторонних разработчиков. Большинство из них являются программным обеспечением с открытым исходным кодом, требуемым для конкретных платформ или Apache Cordova. Можно переопределить параметры по умолчанию и отменить выбор программного обеспечения, которое не требуется устанавливать.

Если следующее программное обеспечение еще не установлено, оно будет выбрано по умолчанию.

Android SDK требуется для процесса построения Android и Ripple.
Apache Ant 1.8.0 или более поздней версии необходима для процесса построения Android.
32-разрядная версия Oracle Java JDK 7 требуется для процесса сборки Android.
Joyent Node.js позволяет системе Visual Studio выполнять интеграцию с интерфейсом командной строки (CLI) Apache Cordova и имитатором Apache Ripple.

Примечание

Установщик не устанавливает браузер Google Chrome, который необходим для запуска имитатора Apache Ripple для iOS и Android, и не устанавливает Apple iTunes, который необходим для развертывания приложения на устройстве iOS, подключенном к ПК под управлением Windows.
Git CLI требуется только в том случае, если необходимо вручную добавить адреса Git URI для конкретных подключаемых модулей Cordova.

Важно!

При использовании Cordova 5.0.0+ может потребоваться добавить переменную среды _JAVA_OPTIONS, содержащую как минимум -Xmx512M, чтобы избежать проблем с нехваткой памяти про сборке приложений Android.Дополнительные сведения см. в описании известной проблемы здесь.

Установка средств Visual Studio Tools для Apache Cordova

Запустите установщик, найденный в разделе Получение инструментов.
Следуйте инструкциям по установке Visual Studio 2015 и убедитесь, что установлены следующие дополнительные компоненты.
- HTML/JavaScript (Apache Cordova) в разделе «Кроссплатформенная разработка мобильных приложений»
  
  Примечание
  
  При установке Visual Studio 2013 вместо Visual Studio 2015 (рекомендуется Visual Studio 2015) средства Cordova устанавливаются как отдельное расширение.
- Средства Windows 8.1 и Windows Phone 8.0/8.1
- Эмулятор Microsoft Visual Studio для Android, если ваш компьютер для разработки поддерживает Hyper-V.
  
  …
  
  Примечание
  
  Эти функции можно добавлять в существующую установку системы Visual Studio 2015.На панели управления выберите Программы и компоненты.Выберите Visual Studio 2015 в списке, а затем нажмите Изменить.В окне программы установки Visual Studio выберите команду Изменить.В списке функций выберите дополнительные параметры, как показано на рисунке.
  
  Если вы не хотите принимать зависимости сторонних производителей, выбранные по умолчанию в разделе «Общие средства и пакеты средств разработки программного обеспечения», можно отменить выбор программного обеспечения и вручную установить зависимости, которые понадобятся позднее.
  
  Важно!
  
  Если в вашей системе сторонние компоненты уже установлены, или вы решили установить их вручную, то вам может потребоваться обновить путь к системе.См. раздел установка зависимостей вручную.
Чтобы убедиться в том, что все установлено правильно, перезагрузите компьютер.
Откройте Visual Studio, выберите Инструменты, затем Расширения и обновления, а затем Обновления. Если для инструментов Visual Studio для Apache Cordova доступно обновление Visual Studio, установите его.

Примечание

При первом построении приложения после установки инструментов система Visual Studio загрузит и установит инструменты Cordova.В результате для выполнения первого построения требуется дополнительное время.Проверьте ход выполнения в окне вывода.Если появляется сообщение об ошибке, например Cannot find module [modulename], может потребоваться очистить и перестроить решение.Дополнительные сведения см. в разделе Повторная установка vs-tac.

При переносе проекта из более ранней версии Visual Studio см. эти сведения о миграции.

Установка инструментов для iOS

Для создания и запуска приложений iOS на имитаторе iOS или устройстве iOS с помощью Visual Studio необходимо установить и настроить удаленный агент remotebuild на компьютере Mac, который удовлетворяет указанным ниже требованиям. (В настоящее время приложения iOS нельзя создавать в среде Windows.) В Visual Studio на компьютере необходимо также настроить удаленный агент, как описано в этом разделе.

Примечание

Сведения об использовании размещенных в облаке служб Mac вместо Mac см. в разделе Сборка и моделирование iOS в облаке.Если ОС Windows выполняется на Mac с помощью технологии виртуализации, то iOS можно создавать и запускать локально.Дополнительные сведения см. в разделе Сборка приложения Cordova для iOS с помощью Parallels.

Перед установкой удаленного агента убедитесь, что установлено приложение Visual Studio Tools для Apache Cordova.

Агент можно настроить на обработку запросов на построение и запуск приложение на устройстве iOS или имитаторе iOS. Для размещения удаленных агентов на компьютере Mac должны быть установлены следующие компоненты:

Mac OS X Mavericks
Xcode 6
Средства командной строки Xcode (в приложении Terminal используйте xcode-select --install)
Node.js
Средства командной строки Git, если используется CLI из репозитория Git.

Если версия CLI указывает на расположение Git, для сборки приложения для iOS требуется Git.

Также необходимо следующее.

Активная учетная запись разработчика iOS с Apple.
Профиль подготовки iOS, настроенный в Xcode (скачайте профиль подготовки и запустите скачанный файл *.mobileprovision).

Примечание

Подробные сведения см. в статье Обслуживание удостоверений подписи и сертификатов в библиотеке разработчика iOS.
Удостоверение подписывания, настроенное в Xcode (выберите XCode, Предпочтения).

Примечание

В Visual Studio 2015 представлен обновленный удаленный агент, который называется remotebuild.Предыдущий агент, vs-mda-remote, предназначен для версии-кандидата Visual Studio 2015 и более ранних версий.

Загрузка и установка удаленного агента

В приложении Terminal на компьютере Mac введите:
```
sudo npm install –g npm
sudo npm install -g remotebuild
sudo npm install –g ios-sim@3.1.1
```
Первая команда обновляет npm, вторая команда устанавливает удаленный агент, а третья команда требуется, только если вы используете эмулятор iOS из Visual Studio.
Если у вас более старая версия Node.js и npm, вам может потребовать ввести приведенные ниже команды перед запуском удаленного агента. В противном случае при сборке могут возникнуть ошибки разрешений. В приложении Terminal на компьютере Mac введите:
```
sudo npm cache clear
sudo chown -R `whoami` ~/.npm
```
Они обеспечивают правильность настройки разрешений для содержимого кэша пакета npm в домашнем каталоге (в более новых версиях Node.js и npm это делается автоматически).

При первом запуске удаленного агента (remotebuild) на компьютере Mac активируется режим разработчика. Homebrew также будут установлены, а также ideviceinstaller и ios-webkit-debug прокси, чтобы разрешить автоматический запуск приложений на устройствах и для отладки приложений на устройствах и в симуляторе.

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

Для установки Homebrew требуется доступ sudo (администратор).Если требуется установить агент remotebuild без прав sudo, можно установить Homebrew вручную в расположении usr/local и добавить его папку bin в нужный путь.Дополнительные сведения см. в документации по Homebrew.Чтобы включить режим разработчика вручную, введите в приложении Terminal команду: DevToolsSecurity –enable

Если компьютер обновлен до новой версии Visual Studio, то на нем также необходимо обновить удаленный агент (до текущей версии).

Обновление удаленного агента

Повторите процедуру установки, описанную в предыдущем разделе.

Запуск удаленного агента

В приложении Terminal на компьютере Mac введите:
```
remotebuild
```
Примечание

В Visual Studio 2013 предыдущей командой является vs-mda-remote.

Это приведет к запуску агента с каталогом сборки по умолчанию — ~/.taco_home/remote-builds/taco-remote/builds. Дополнительные параметры конфигурации для агентов описаны в статье Configure the remote agent (Настройка удаленного агента).

При первом запуске агента вам будут предоставлены сведения, необходимые для настройки агента в Visual Studio, включая имя узла, порт и ПИН-код безопасности.

Важно!

Удаленный агент служит для безопасной передачи полезных данных сборки в среду Visual Studio и из нее с помощью сертификатов SSL.
Если вы намерены настроить удаленный агент в Visual Studio, используя имя узла, выполните проверку связи с компьютером Mac, используя это имя узла, чтобы убедиться, что он достижим. В противном случае может потребоваться использовать вместо имени узла IP-адрес.
Если компьютер Mac внешне отображается под одним именем узла, но внутренним образом назначает себе другое имя узла, можно выполнить следующую команду в приложении Terminal:
```
remotebuild resetServerCerts --hostname=my.external.hostname.com
remotebuild generateClientCert --hostname=my.external.hostname.com
```
чтобы повторно создать сертификаты, которые будут работать с данным именем узла. Если вы намерены настроить удаленный агент в Visual Studio, используя имя узла, выполните проверку связи с компьютером Mac, используя это имя узла, чтобы убедиться, что он достижим. В противном случае может потребоваться использовать вместо имени узла IP-адрес.

Перед использованием удаленного агента необходимо указать удаленную конфигурацию в Visual Studio.

Настройка удаленного агента для работы в Visual Studio

Если удаленный агент еще не выполняется на компьютере Mac, запустите его.
На компьютере Mac получите имя узла или IP-адрес компьютера Mac.

IP-адрес можно получить с помощью команды ifconfig.
В строке меню Visual Studio выберите Инструменты, Параметры.
В диалоговом окне Параметры откройте Инструменты для Apache Cordova, а затем Конфигурация удаленного агента.
Для параметра Включить обработку удаленного iOS установите значение True.
Задайте для параметра Безопасный режим значение True.
В полях Узел, Порт и ПИН-код безопасности введите значения, указанные удаленным агентом при его первом запуске. Для узла можно указать имя или IP-адрес компьютера Mac. Порт по умолчанию — 3000.

Примечание

Если не удается проверить связь с компьютером Mac, используя имя узла, возможно, потребуется использовать IP-адрес.

При нажатии кнопки ОК Visual Studio выполнит подключение к удаленному агенту (агент должен быть запущен).

Если требуется отключить безопасный режим и включить обычное подключение на основе HTTP, выберите значение False для параметра Безопасный режим и запустите агент remotebuild, отключив безопасный режим.
```
remotebuild --secure false
```
Если безопасный режим отключен, при настройке агента в Visual Studio можно оставить поле ПИН-код безопасности пустым.

ПИН-код безопасности предназначен для однократного использования. Если требуется связать новый клиент с сервером remotebuild, см. инструкции в разделе Создание нового ПИН-кода безопасности.

Останов агента

В приложении Terminal на Mac нажмите Ctrl+C.

Дополнительные задачи

В некоторых случаях для обновления и настройки инструментов могут потребоваться дополнительные действия.

Если вы решили не устанавливать одну или несколько зависимостей с набором средств Visual Studio Tools для Apache Cordova, возможно, потребуется установить зависимости вручную.
Если требуется проверить путь к сторонней зависимости или установлено несколько версий зависимости, см. инструкции в разделе Переопределение переменных системной среды.
Если Visual Studio используется через прокси, см. инструкции в разделе Настройка инструментов для работы с прокси-сервером.
Инструкции по использованию и настройке агента remotebuild для создания приложений iOS см. в следующих разделах.
При появлении непредвиденных ошибок в ходе создания шаблона пустого приложения см. инструкции в разделе Повторная установка vs-tac.