license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.

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

В этом руководстве показано, как настроить среду разработки SDK для создания и развертывания приложений Cordova для Windows 8, Windows 8.1, Windows Phone 8.1 и Платформы универсальных приложений Windows 10. Оно показывает, как использовать либо инструменты командной строки для создания и построения приложения, или кросс платформенный Cordova CLI обсуждаемые в разделе “Интерфейс командной строки”. (См. Введение для сравнения этих вариантов развития). В этом разделе также показано, как изменять Cordova приложения в среде Visual Studio. Независимо от того, какой подход вы будете использовать необходимо установить SDK для Visual Studio, как описано ниже.

Смотрите “Обновление для Windows 8” для информации о том, как обновить существующие проекты Windows 8 Cordova.

Window Phone 8 (wp8) остается в качестве отдельной платформы, подробности в “Руководство для платформы Windows Phone 8”.

Cordova WebView под управлением ОС Windows полагаются на Internet Explorer 10 (Windows 8.0) и Internet Explorer 11 (Windows 8.1 и Windows Phone 8.1) как их движок рендеринга, так что с практической точки зрения мощный отладчик в IE можно использовать для тестирования любого веб-контента, который не вызвает API Cordova. Блог разработчиков Windows Phone предоставляет полезные рекомендации о том, как поддержка IE наряду с сопоставимыми WebKit-браузерами.

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

Для разработки приложений для платформы Windows необходимо:

Windows 8.1, 32 или 64-разрядная машина (Домашняя, Профессиональнаяили Корпортативное издание) с как минимум 4 ГБ ОЗУ.
Windows 8.0, 8.1 или 10, 32 или 64-разрядные выпуски версии Домашней, Профессиональной или Корпоративной, вместе с Visual Studio 2012 Express или Visual Studio 2013. Visual Studio 2015 не позволяет создавать приложений Windows 8.0.

Для разработки приложений для Windows 8.0 и 8.1 (включая Windows Phone 8.1):

Windows 8.1 или 10, 32 или 64-разрядные выпуски версии Домашней, Профессиональной или Корпоративной, вместе с Visual Studio 2013 или выше. Ознакомительная версия Windows 8.1 Enterprise доступна из Microsoft Developer Network.
Для эмуляторов Windows Phone, Профессиональная версия Windows 8.1 (x64) или выше и процессор, который поддерживает клиент Hyper-V и перевода адресов второго уровня (SLAT). Ознакомительная версия Windows 8.1 Enterprise доступна из Microsoft Developer Network.
Visual Studio 2013 для Windows (Экспресс или выше).

Для разработки приложений для Windows 10:

Windows 8.1 или Windows 10 Technical Preview 2, 32 - или 64-бит, вместе с Visual Studio 2015 RC или выше.

Совместимость приложения определяется ОС, на которую направлены приложения. Приложения являются совместимы с новыми версиями, но не обратно совместимы, поэтому приложение нацеленные на Windows 8.1 нельзя запустить на 8.0, но построеные для 8.0 приложения могут выполняться на 8.1.

Следуйте инструкциям на windowsstore.com для отправки приложения в магазин Windows.

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

С помощью инструментов Cordova оболочки

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

Доступ к ним локально из кода проекта, созданного CLI. Они доступны в каталоге platforms/windows/ после добавления платформы windows , как описано ниже.
Скачайте их из отдельного дистрибутива на cordova.apache.org. Дистрибутив Cordova содержит отдельные архивы для каждой платформы. Убедитесь в том что распаковываете соответствующий архив, cordova-windows в этом случае, в пустой каталог. Соответствующие утилиты командной строки доступны в каталоге package/bin. (Обратитесь при необходимости к README файлу за более подробными инструкциями.)

Эти оболочки инструменты позволяют создавать, строить и запускать приложения Windows. За информаций о дополнительных интерфейсах командной строки которые позволяют встраивать возможности плагинов среди разных платформ, смотрите раздел “Использование Plugman для управления расширениями”.

Установите SDK

Установите любой выпуск Visual Studio соответствующие требованиям к версии, перечисленным выше.

Для 10 Windows установщик Visual Studio имеет возможность установить инструменты для создания универсальных приложений Windows. Необходимо убедиться, что этот параметр выбран при установке чтобы установить требуемый пакет SDK.

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

На данный момент для создания нового проекта можно выбрать между кросс-платформенным инструментом CLI, описанным в разделе “Интерфейс командной строки”, или набором инструментов для Windows. Ниже CLI подход создает приложение с именем HelloWorld в каталог нового проекта hello:

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

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

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

Этот проект нацелен на Windows 8.1 как целевую ОС по умолчанию. Вы можете выбрать целевой 8.0 или 10.0 (см. “Настройка целевой версии Windows” ниже) для всех сборок, или вы можете ориантироваться на конкретную версию при каждом построении.

Построение проекта

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

    > cordova build
    > cordova build windows              # do not rebuild other platforms
    > cordova build windows   --debug    # generates debugging information
    > cordova build windows   --release  # signs the apps for release

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

    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

Настройка целевой версии Windows

По умолчанию, команда build производит два пакета: Windows 8.0 и 8.1 Windows Phone. Чтобы обновить пакет Windows до версии 8.1 следующие параметры конфигурации должны быть добавлены в файл конфигурации (config.xml).

    <preference name="windows-target-version" value="8.1" />

После того, как вы добавите этот параметр, команда build начнет создавать пакеты Windows 8.1 и 8.1 Windows Phone.

Параметр --appx

Вы можете решить, что вы хотите построить конкретную версию приложения, ориентированную на конкретную ОС (например, вы могли бы задать что вы хотите ориентироваться на Windows 10, но вы хотите построить для Windows Phone 8.1). Для этого можно использовать параметр --appx :

    > cordova build windows -- --appx=8.1-phone

Система построения будет игнорировать набор предпочтений в файле config.xml для целевой версии Windows и строго построит пакет для Windows Phone 8.1.

Допустимые значения для флага --appx являются 8.1-win, 8.1-phoneи uap (для 10 универсальных приложений Windows). Эти параметры также применяются к команде cordova run .

Соображения по целевой версии Windows

Windows 10 поддерживает новый «Удаленный» режим для приложений Cordova (и приложений HTML в целом). Этот режим позволяет приложениям гораздо больше свободы в использовании DOM манипуляций и общих шаблонов web таких как использование встроенных сценариев, но делает это путем сокращения набора возможностей которых ваше приложение может использовать, когда оно будет опублоковано в Windows Store. Дополнительные сведения о Windows 10 и Удаленном режиме посмотрите в документации Cordova для Windows 10.

При использовании удаленного режима, разработчики могут применять политики безопасности содержания (CSP) в своих приложениях для предотвращения атак путем внедрения скриптов.

Развертывание приложения

Развертывание пакета Windows:

    > cordova run windows -- --win  # explicitly specify Windows as deployment target
    > cordova run windows # `run` uses Windows package by default

Развертывание пакета Windows Phone:

    > cordova run windows -- --phone  # deploy app to Windows Phone 8.1 emulator
    > cordova run windows --device -- --phone  # deploy app to connected device

Можно использовать cordova run windows --list чтобы увидеть все доступные цели и cordova run windows --target=target_name -- -|-phone для запуска приложения на конкретном устройстве или эмуляторе (например, cordova run windows --target="Emulator 8.1 720P 4.7 inch" -- --phone).

Чтобы увидеть дополнительные параметры построения и запуска также можно использовать cordova run --help.

Откройте проект в SDK и развертывание приложения

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

Компонент CordovaApp отображается внутри решения, и его каталог www содержит исходный код, включая домашнюю страницу index.html:

Элементы управления ниже главного меню Visual Studio позволяют вам тестировать или развертывать приложения:

При выбранном пункте Локальный компьютер нажмите зеленую стрелку, чтобы установить приложение на том же компьютере где работает Visual Studio. Как только вы сделаете это, приложение появляется в списках приложений Windows 8:

Каждый раз, когда вы перестроить приложение, версия доступная в интерфейсе обновляется.

После появления в списке приложений, удерживайте нажатой клавишу CTRL это позволяет закрепить приложение на главный экран:

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

Альтернативно выберите параметр развертывания Симулятор для просмотра приложения, как если бы она была установлена на планшетном устройстве:

В отличие от развертывания на настольные системы этот параметр позволяет имитировать ориентацию планшета, его местоположение и изменять его параметры сети.

Примечание: Сверяйтесь с разделом “Введение” для понимания когда использовать инструменты командной строки Cordova а когда инструменты SDK в вашем рабочем процессе. Cordova CLI опирается на кросс платформенной исходный код, который постоянно перезаписывает файлы платформы, используемые SDK. Если вы хотите использовать SDK для изменения проекта, используйте низкоуровневые инструменты командной строки как альтернативу CLI.