Руководство по платформе Windows Phone 8

Это руководство показывает, как настроить среду разработки SDK для развертывания приложений Cordova на устройствах Windows Phone. Оно сосредоточено на Windows Phone 8, но предоставляет дополнительные сведения о поддержке Windows Phone 7.

В нём показано, как использовать утилиты оболочки, специфичные для Windows Phone, для создания и сборки приложений, или кроссплатформенный интерфейс командной строки Cordova, описанный в Интерфейсе командной строки. (См. Обзор для сравнения этих рабочих процессов разработки.) Этот раздел также демонстрирует, как открыть приложения Cordova, чтобы можно было изменить их в Visual Studio. Независимо от выбранного подхода, необходимо установить Windows Phone SDK, как описано ниже.

Подробные сведения, специфичные для платформы Windows Phone, см. ниже:

• Плагины Windows Phone 8
• Обновление Windows Phone 8

Для платформы Windows Phone 8 WebView Cordova использует Internet Explorer 10 в качестве движка рендеринга, поэтому в практическом плане можно использовать мощный отладчик IE10 для тестирования любого веб-контента, который не вызывает API Cordova. Блог разработчиков Windows Phone предоставляет полезные рекомендации по поддержке IE10 наряду с аналогичными браузерами WebKit.

Требования и поддержка

Необходимое оборудование:

• 64-разрядная версия Windows 8 Pro, либо установочный диск, либо образ диска ISO. Оценочная версия доступна на Microsoft Developer Network. Версия Pro необходима для запуска эмулятора устройства.

• Windows Phone SDK.

• Для развертывания через командную строку с помощью SDK Windows Phone 8.0 необходимо установить Visual Studio 2012 Update 2.

Для разработки приложений Cordova для устройств Windows Phone можно использовать ПК под управлением Windows, но также можно разрабатывать на Mac, либо используя среду виртуальных машин, либо используя Boot Camp для двойной загрузки раздела Windows. Обратитесь к этим ресурсам для настройки необходимой среды разработки Windows на Mac:

• VMWare Fusion: для настройки виртуальной машины Windows 8 следуйте инструкциям, предоставленным на Microsoft Developer Network, затем см. Настройка VMWare Fusion для получения информации о подготовке виртуальной среды для запуска эмулятора, входящего в состав SDK.

• Parallels Desktop: для настройки виртуальной машины Windows 8 следуйте инструкциям, предоставленным на Microsoft Developer Network, затем см. Настройка Parallels Desktop для получения информации о подготовке виртуальной среды для запуска эмулятора, входящего в состав SDK.

• Boot Camp: для настройки раздела Windows 8 следуйте инструкциям по установке, предоставленным на Microsoft Developer Network.

Если вы разрабатываете на ПК, его процессор должен поддерживать виртуализацию (VT-x на Intel) и перевод адресов второго уровня (SLAT). Обратитесь к списку поддерживаемых процессоров Intel. Обычно виртуализация отключена по умолчанию, поэтому её необходимо включить в настройках BIOS. ПК должен иметь как минимум 6,5 ГБ свободного места на жёстком диске и 4 ГБ оперативной памяти.

Использование утилит оболочки Cordova

Если вы хотите использовать утилиты оболочки Cordova, ориентированные на Windows Phone, в сочетании со SDK, у вас есть два основных варианта:

• Получите доступ к ним локально из кода проекта, сгенерированного интерфейсом командной строки. Они доступны в каталоге platforms/wp8/cordova после добавления платформы wp8, как описано ниже.

• Загрузите их из отдельного распределения по адресу cordova.apache.org. Распределение Cordova содержит отдельные архивы для каждой платформы. Убедитесь, что вы распаковали соответствующий архив, cordova-wp8\wp8 в данном случае, в пустой каталог. Соответствующие утилиты пакетной обработки доступны в верхнем каталоге bin. (Обратитесь к файлу README, если необходимы более подробные инструкции.)

Эти утилиты оболочки позволяют создавать, собирать и запускать приложения Windows Phone. Подробные сведения об дополнительном интерфейсе командной строки, обеспечивающем функции плагинов на всех платформах, см. в разделе Использование Plugman для управления плагинами. См. Плагины приложений для получения рекомендаций по разработке плагинов и Плагины Windows Phone 8 для получения сведений, специфичных для платформы Windows Phone.

Установка SDK

Установите последнюю версию Windows Phone SDK из раздела Загрузки на dev.windowsphone.com. Вы также можете установить более новые пакеты обновлений эмулятора.

Создание нового проекта

На данном этапе для создания нового проекта можно выбрать кроссплатформенный инструмент командной строки, описанный в Интерфейсе командной строки, или набор утилит оболочки, специфичных для Windows Phone. Из каталога исходного кода вот подход с использованием интерфейса командной строки:

> cordova create hello com.example.hello HelloWorld
> cd hello
> cordova platform add wp8

Вот соответствующий подход, использующий утилиты оболочки нижнего уровня:

C:\path\to\cordova-wp8\bin\create.bat C:\path\to\new\hello com.example.hello HelloWorld

Сборка проекта

Если вы используете CLI в процессе разработки, в верхнем каталоге каталога проекта www находятся исходные файлы. Выполните любое из этих команд в каталоге проекта, чтобы перестроить приложение:

> cordova build
> cordova build wp8   # do not rebuild other platforms

Если вы используете утилиты оболочки, специфичные для Windows Phone, в процессе разработки, существует другой подход. После создания проекта исходный код приложения по умолчанию доступен в подкаталоге projects\wp8\www. Следующие команды доступны в подкаталоге cordova на том же уровне.

Команда build очищает файлы проекта и перестраивает приложение. Первый пример генерирует отладочную информацию, а второй подписывает приложения для выпуска:

C:\path\to\project\cordova\build.bat --debug        
C:\path\to\project\cordova\build.bat --release

Команда clean помогает очистить каталоги в подготовке к следующей build:

C:\path\to\project\cordova\clean.bat

Развертывание на эмуляторе

На этом этапе можно использовать утилиту командной строки cordova для развертывания приложения на эмуляторе из командной строки:

> cordova emulate wp8

В противном случае используйте альтернативный интерфейс оболочки:

C:\path\to\project\cordova\run

По умолчанию скрипт run вызывает флаг эмулятора и принимает дополнительные флаги сборки, для которых --debug предоставляет значения по умолчанию:

C:\path\to\project\cordova\run --emulator --debug
C:\path\to\project\cordova\run --emulator --release
C:\path\to\project\cordova\run --emulator --nobuild

Эмулятор запускает образ устройства с установленным приложением. Из главного экрана перейдите к панели приложений, чтобы запустить приложение HelloWorld. Это демонстрирует запуск приложения с его экраном загрузки, за которым следует его главный интерфейс:

Основные элементы управления эмулятора в правом верхнем углу экрана устройства позволяют переключаться между ориентациями портрет и ландшафт. Кнопка >> открывает дополнительные элементы управления, которые позволяют тестировать более сложные ориентации и жесты:

Эти расширенные элементы управления также позволяют изменять местоположение устройства или имитировать последовательность движений:

Развертывание на устройстве

Перед тестированием приложения на устройстве необходимо зарегистрировать устройство. Обратитесь к документации Майкрософт для получения сведений о развертывании и тестировании на Windows Phone 8. Также убедитесь, что телефон подключён к компьютеру и экран разблокирован.

Затем выполните следующую команду CLI для запуска приложения на устройстве:

> cordova run wp8

Это соответствует следующей команде оболочки нижнего уровня:

C:\path\to\project\cordova\run --device

В качестве альтернативы, если вы работаете в Visual Studio, выберите Устройство Windows Phone в выпадающем меню вверху, затем нажмите зеленую кнопку Запуск рядом или введите F5.

Изменение проекта в SDK

После сборки приложения Cordova, как описано выше, вы можете открыть его с помощью SDK. Различные build команды генерируют файл решения Visual Studio (.sln). Откройте файл, чтобы изменить проект в Visual Studio. Веб-исходный код доступен в каталоге www проекта. Наряду с другими инструментами, SDK предоставляет средство управления под меню, которое позволяет запустить приложение в эмуляторе Windows Phone:

Обратитесь к Обзору за рекомендациями по использованию инструментов командной строки Cordova или SDK в вашем рабочем процессе. Cordova CLI использует кроссплатформенный исходный код, который обычно перезаписывает платформоспецифичные файлы, используемые SDK. Если вы хотите работать внутри SDK, используйте утилиты оболочки нижнего уровня в качестве альтернативы CLI.