Руководство по платформе 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, Cordova WebView использует Internet Explorer 10 в качестве движка рендеринга, поэтому, практически, вы можете использовать мощный отладчик IE10 для тестирования любого веб-контента, который не вызывает API Cordova. Блог разработчиков Windows Phone предоставляет полезное руководство по поддержке IE10 наряду с аналогичными браузерами WebKit.

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

Вам потребуются следующие компоненты:

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

• Windows Phone SDK.

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

Для разработки приложений Cordova для устройств Windows Phone вы можете использовать ПК под управлением Windows, но также можете разрабатывать на Mac, либо используя виртуальную машину, либо используя Boot Camp для загрузки Windows в режиме dual-boot. Обратитесь к этим ресурсам, чтобы настроить требуемую среду разработки 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) и Second Level Address Translation (SLAT). Обратитесь к списку поддерживаемых процессоров Intel. Как правило, виртуализация отключена по умолчанию, поэтому вам нужно включить её в настройках BIOS. ПК должен иметь как минимум 6,5 ГБ свободного места на жестком диске и 4 ГБ оперативной памяти.

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

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

• Доступ к ним локально из кода проекта, сгенерированного CLI. Они доступны в каталоге 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. Вы также можете установить более новые пакеты обновлений эмулятора.

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

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

> 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

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

На данном этапе вы можете использовать утилиту CLI 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. Это показывает запуск приложения со своим экраном загрузки, за которым следует его главный интерфейс:

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

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

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

Перед тестированием приложения на устройстве, устройство должно быть зарегистрировано. Обратитесь к документации Microsoft за подробностями о развертывании и тестировании на 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.