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 и 8.1 Windows Phone. Он показывает, как использовать инструменты либо оболочки для создания и построения приложения, или кросс платформенный Cordova CLI обсуждаются в интерфейс командной строки. (См. Обзор для сравнения этих вариантов развития). В этом разделе также показано, как изменять Cordova приложения в среде Visual Studio. Независимо от того, какой подход вы принимаете вам нужно установить SDK для Visual Studio, как описано ниже.

Информацию о том, как обновления существующих проектов Windows 8 Cordova см обновление Windows 8.

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

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

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

Вам нужна одна из следующих комбинаций OS/SDK, либо с установочного диска или файла образа диска ISO .

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

  • Windows 8.0 или 8.1, 32 или 64-кусочек дома, Proили выпуски Enterprise , вместе с Visual Studio 2012 Express.

Для разработки приложений для всех платформ (Windows 8.0, 8.1, Windows и Windows Phone 8.1):

  • Windows 8.1, 32 или 64-кусочек дома, Proили выпуски Enterprise , вместе с Visual Studio 2013 Express или выше. Ознакомительная версия Windows 8.1 предприятия доступен из Microsoft Developer Network.

Приложения, скомпилированные под Windows 8.1 сделать не запускаться под Windows 8.0. Приложения под Windows 8.0 совместимые с 8.1.

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

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

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

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

  • Доступ к ним локально из проекта кода, созданного CLI. Они доступны в platforms/windows/cordova Каталог после добавления windows платформа, как описано ниже.

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

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

Установите SDK

Установить Ultimate, премиумили выпуски Visual Studio Professional 2013.

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

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

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

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

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

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

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

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

После создания проекта приложения по умолчанию источник доступен в projects\windows\www подкаталога. Последующие команды доступны в cordova подкаталога на том же уровне.

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

    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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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