Настройка приложения, созданного с помощью Visual Studio Tools для Apache Cordova

Статья
09/13/2015

В Visual Studio 2013 инструменты Cordova выпущены в виде предварительной (CTP) версии. Инструменты Cordova будут выпущены как часть Visual Studio 2015, и рекомендуется использовать Visual Studio 2015 RTM для разработки приложений с помощью инструментов Visual Studio для Apache Cordova. Visual Studio можно скачать из Центра загрузки Майкрософт.

Файл config.xml, включаемый в каждый проект, описывает основную часть конфигурации приложения, например, отображаемое имя приложения и его начальная страница. В обозревателе решений дважды щелкните этот файл, чтобы открыть его в конструкторе конфигурации — интерфейсе Visual Studio для файла. С другой стороны, для непосредственного редактирования файла можно выбрать пункт Просмотреть код в контекстном меню. Дополнительные сведения об этом файле см в файле config.xml в документации по Apache Cordova. Сведения о настройке этого файла в Visual Studio см. в следующих разделах:

Настройка версии интерфейса CLI Cordova
Настройка целевой версии Windows (в этом разделе)
Управление подключаемыми модулями для приложений, созданных с помощью Visual Studio Tools для Apache Cordova
Упаковка приложения, созданного с помощью Visual Studio Tools для Apache Cordova

Предупреждение

При непосредственном редактировании файла config.xml убедитесь, что XML-элементы и атрибуты являются допустимыми.Недопустимое содержимое XML-файла приведет к ошибкам при построении приложения.

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

Специфические для платформы визуальные активы (в этом разделе)
Специфический для платформы контент (в этом разделе)
Определяемые платформой файлы конфигурации (в этом разделе)

Настройка версии интерфейса CLI Cordova

Для изменения версии CLI, используемой в проекте, можно использовать конструктор конфигураций. Чтобы изменить версию, перейдите на вкладку «Платформы» и укажите один из следующих вариантов:

версию CLI Cordova (например, 4.3.0);
репозиторий Git (например, https://github.com/apache/cordova-cli.git).

Кроме того, версию CLI Cordova можно изменить, отредактировав файл taco.json в корневом каталоге проекта.

Предупреждение

Изменение версии CLI Cordova может повлиять на код приложения.Платформы будут удалены, а затем повторно добавлены для использования закрепленной версии CLI.

Настройка версии CLI

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

Целевую версию Windows можно изменить в конструкторе конфигураций на вкладке Windows (Целевая версия Windows).

Cordova_Config_Windows

Варианты, доступные на вкладке «Целевая версия Windows», зависят от установленного пакета SDK. При установке SDK для Windows 8.0 или Windows 10 соответствующая версия будет отображаться как один из вариантов, доступных для выбора.

При изменении целевой версии Windows в файле config.xml изменяется следующая строка:

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

Специфические для платформы визуальные активы

Для указания визуальных активов, например, значков и экранов-заставок на основе разрешения устройства, а также платформы, можно использовать папку res в проекте. Если эта папка в проекте не видна, то ее можно восстановить вручную в обозревателе решений.

res\icons\платформа содержит значки приложений для каждой платформы.
res\screens\платформа содержит экраны-заставки для каждой платформы.

Предупреждение

Для задания расположений этих файлов в Visual Studio 2015 теперь используются элементы config.xml <icon> и <splashscreen>.При использовании файла config.xml из более ранней версии эти элементы необходимо добавить в файл config.xml.Для этого просто создайте новый проект на основе пустого шаблона, выберите в контекстном меню файла config.xml в каждом проекте пункт Перейти к коду и скопируйте необходимые элементы из пустого проекта в рабочий проект.

Имя файла для каждого ресурса содержит определенную информацию об активе. Например, файл screen-ldpi-portrait.png в папке res\icons\screens\android представляет экран-заставку для экрана с низким разрешением (ldpi или 426 x 320) для устройства Android в книжной ориентации.

В таблице ниже приведен полный список экранов-заставок и значков, которые требуются для поддержки определенных устройств и уровней разрешения экрана. Дополнительные сведения об этих активах см. в разделе Значки и экраны-заставки в документации по Apache Cordova.

Значки и экраны-заставки для Android	Решение
res/icons/android/icon-36-ldpi.png	36x36
res/icons/android/icon-48-mdpi.png	48x48
res/icons/android/icon-72-hdpi.png	72x72
res/icons/android/icon-96-xhdpi.png	96x96
res/screens/android/screen-xhdpi-landscape.png	720x960
res/screens/android/screen-xhdpi-portrait.png	960x720
res/screens/android/screen-hdpi-landscape.png	480x640
res/screens/android/screen-hdpi-portrait.png	640x480
res/screens/android/screen-mdpi-landscape.png	320x470
res/screens/android/screen-mdpi-portrait.png	470x320
res/screens/android/screen-ldpi-landscape.png	320x426
res/screens/android/screen-ldpi-portrait.png	426x320
Значки и экраны-заставки для iOS	Решение
res/icons/ios/icon-57-2x.png	114x114 (дисплей Retina)
res/icons/ios/icon-57.png	57x57
res/icons/ios/icon-72-2x.png	144x144 (дисплей Retina)
res/icons/ios/icon-72.png	72x72
res/icons/ios/icon-40.png	40x40
res/icons/ios/icon-40-2x.png	80x80 (дисплей Retina)
res/icons/ios/icon-50.png	50x50
res/icons/ios/icon-50-2x.png	100x100 (дисплей Retina)
res/icons/ios/icon-60@3x.png	180x180 (дисплей Retina)
res/icons/ios/icon-76.png	76x76
res/icons/ios/icon-76-2x.png	152x152 (дисплей Retina)
res/icons/ios/icon-small.png	29x29
res/icons/ios/icon-small-2x.png	58x58 (дисплей Retina)
res/screens/ios/screen-ipad-landscape.png	1024x768
res/screens/ios/screen-ipad-landscape-2x.png	2048x1536
res/screens/ios/screen-ipad-portrait.png	768x1024
res/screens/ios/screen-ipad-portrait-2x.png	1536x2048
res/screens/ios/screen-iphone-landscape-736h.png	2208x1242
res/screens/ios/screen-iphone-portrait-2x.png	640x960
res/screens/ios/screen-iphone-portrait.png	320x480
res/screens/ios/screen-iphone-portrait-667h.png	750x1334
res/screens/ios/screen-iphone-portrait-736h.png	1242x2208
res/screens/ios/screen-iphone-568h-2x.png	640x1136
Значки и экраны-заставки для Windows Phone 8	Решение
res/icons/wp8/ApplicationIcon.png	62x62
res/icons/wp8/Background.png	173x173
res/screens/wp8/SplashScreenImage.png	480x800
Значки и экраны-заставки для Windows Phone 8.1	Решение
res/icons/windows/Square150x150Logo.scale-240.png	360x360
res/icons/windows/Square44x44Logo.scale-240.png	106x106
res/icons/windows/Square71x71Logo.scale-240.png	170x170
res/icons/windows/StoreLogo.scale-240.png	120x120
res/icons/windows/Wide310x150Logo.scale-240.png	744x360
res/screens/windows/SplashScreen.scale-240.png	1152x1920
Значки и экраны-заставки для Windows	Решение
res/icons/windows/logo.png	150x150
res/icons/windows/smalllogo.png	30x30
res/icons/windows/storelogo.png	50x50
res/screens/windows/splashscreen.png	620x300

Система Android поддерживает масштабируемое изображение под названием NinePatch, которое можно использовать в качестве экрана-заставки.

Использование изображения NinePatch в качестве экрана-заставки в Android

Замените в файле config.xml строку

<preference name="SplashScreen" value="screen" />

<preference name="SplashScreen" value="splash" />

Поместите изображение NinePatch в следующую папку: res\native\android\res\drawable-nodpi\splash.9.png.

При выполнении сборки изображение будет скопировано в нужную выходную папку.

Специфический для платформы контент

Специфические для платформы файлы HTML, CSS и JavaScript можно положить в папку merges проекта. Файлы, добавляемые в эту папку, либо добавляют контент для специфического для платформы построения приложения, либо переопределяют неспецифический для платформы контент, которое использует то же самое имя файла. Дополнительные сведения об использовании папки merges см. в разделе «Использование слияний для настройки каждой платформы» в документации по Apache Cordova.

Если в обозревателе решений папка merges для проекта не видна, откройте контекстное меню для проекта в обозревателе решений, нажмите Добавить и выберите Добавить определенный код платформы для добавления папки.

Определяемые платформой файлы конфигурации

Папку res/native в проекте можно использовать для вставки контента в собственный проект, созданный Cordova при построении приложения. Эта возможность полезна при необходимости настройки приложения для поддержки компонентов, не предоставляемых Cordova. (Подключаемые модули, добавляемые в проект, также автоматически изменяют настраиваемую версию этих файлов конфигурации.)

Предупреждение

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

В таблице ниже содержатся конкретные сведения для каждой платформы.

Платформа	Примечания
Android	Поместите настраиваемый файл AndroidManifest.xml в папку res/native/android для настройки таких параметров, как настраиваемые цели. Используйте созданную версию файла в папке platforms/android после создания конфигурации отладки проекта для Android.
iOS	Поместите пользовательский файл build-debug.xcconfig или build-release.xcconfig в папку res/native/ios/cordova, чтобы переопределить удостоверения подписи и другие параметры сборки для этих конфигураций. Поместите пользовательский файл Info.plist в папку отображаемых имен res/native/ios/config.xml, чтобы переопределить параметры, например заставки или значки. Необходимо изменить имя файла Info.plist следующим образом: config.xml <отображаемое имя>-Info.plist, чтобы обновить ключи платформы iOS. Примеры этих и других файлов можно найти в репозитории GitHub по адресу cordova-ios или (при использовании удаленного агента) в папке ~/remote-builds/build number/cordovaApp на компьютере Mac.
Windows	Поместите настраиваемый файл package.windows80.appxmanifest (Windows 8.0), package.windows.appxmanifest (Windows 8.1) или package.phone.appxmanifestfile (Windows Phone 8.1) в папку res/native/windows, чтобы переопределить различные параметры конфигурации. Используйте созданную версию файла в папке platforms/windows после создания конфигурации отладки проекта для Windows или Windows Phone (универсальная).
Windows Phone 8	Поместите настраиваемый файл WMAppManifest.xml в папку res/native/wp8/Properties. Используйте созданную версию файла в папке platforms/wp8/Properties после сборки конфигурации отладки проекта для Windows Phone 8.