1. Вимоги та підтримка
2. Використання інструментів командного рядка Cordova
3. встановіть SDK
4. Створення нового проекту
5. побудова проекту
6. Налаштування цільової версії Windows
7. параметр --appx
8. Міркування щодо цільової версії Windows
9. розгортання додатки
10. Відкрийте проект в SDK і розгортання додатки

У цьому керівництві показано, як налаштувати середовище розробки 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 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.