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

  • Статья

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

При создании пакета приложения, созданного с помощью Visual Studio Tools для Apache Cordova, вам потребуется настроить параметры, необходимые для публикации приложения. Помимо общих параметров, также существуют специальные для платформы операции, которые необходимо выполнять в большинстве случаев.

Содержание этой статьи

  • Настройка параметров сборки

  • Настройка общих параметров пакета приложения

  • Упаковка и подписание приложения Android

  • Упаковка и подписание приложения iOS

  • Упаковка и подписание приложения Windows 8, Windows 8.1 или Windows Phone 8.1

  • Упаковка и подписание приложения Windows Phone 8

Учебник, в котором приводится подробное описание процесса упаковки и публикации, см. в статье Package and publish your Cordova applications (Упаковка и публикация приложений Cordova).

Настройка параметров сборки

При сборке приложения нужно выбрать правильную конфигурацию сборки. Вы можете выбрать конфигурацию сборки для отладки или выпуска.

  • Отладка. Эта конфигурация сборки служит для отладки приложений. Для Android она создает отладочный пакет APK (без подписей выпуска). Для iOS удаленный агент Visual Studio по умолчанию выбирает первое допустимое удостоверение подписи для разработки iOS, установленное на вашем компьютере Mac.

  • Выпуск. Эту конфигурацию сборки следует использовать для выпускаемых пакетов. Для Android необходимо предоставить хранилище ключей, используемое для подписания выпускаемого пакета APK. Для iOS удаленный агент Visual Studio по умолчанию выбирает первое допустимое удостоверение подписи для распространения iOS, установленное на вашем компьютере Mac.

Настройка общих параметров пакета приложения

Такую информацию как идентификатор и номер версии пакета можно указать с помощью конструктора конфигурации, который является интерфейсом Visual Studio для файла config.xml. В обозревателе решений откройте контекстное меню для файла config.xml и выберите Открыть или Конструктор представлений (или дважды щелкните файл).

Важные параметры в конструкторе конфигурации

Для упаковки приложения с целью его последующего распространения необходимо настроить следующие параметры.

  • Отображаемое имя, которое указывает имя приложения, которое появляется в хранилище приложений.

    Примечание

    Отображаемое имя и идентификатор пакета в магазине Windows указываются по-разному.См. раздел Упаковка и подпись приложения Windows 8, Windows 8.1 и Windows Phone 8.1 далее в этой статье.

  • Идентификатор пакета, представляющий собой уникальную строку, которая идентифицирует приложение на каждой платформе (за исключением Windows 8) при публикации приложения в хранилище.

  • Версия, которая указывает номер версии приложения. В некоторых магазинах приложений могут применяться свои системы версий, назначаемые при публикации приложения. Однако для таких платформ как iOS данный номер должен совпадать с версией, указанной в iTunes Connect.

  • Доступ к домену, указывающий набор доменов, в которых приложение может получать доступ к контенту. В ходе разработки рекомендуется использовать значение по умолчанию («*»), которое обеспечивает доступ ко всему контенту. Однако перед выпуском приложения этот параметр следует использовать для указания только некоторых доменов, необходимых для приложения. (В настоящее время в Windows 8 этот параметр не используется.)

Дополнительные сведения о настройках, которые можно задать вручную в файле config.xml, см в разделе Файл config.xml в документации по Apache Cordova.

Упаковка и подписание приложения Android

Каждый раз при создании приложения для Android создается пакет. Для подписания приложения с целью его последующего распространения требуется выполнить несколько дополнительных действий.

Для подписания приложения Android для распространения

  1. Создайте хранилище ключей и предоставьте информацию, необходимую для создания сертификата (закрытого ключа). Дополнительные сведения см. в разделе Подпись приложения в документации по Android.

  2. После создания хранилища ключей откройте папку res\native\android.

  3. Откройте файл ant.properties и введите информацию о хранилище ключей, а также псевдоним.

    Свойство Key.store в файле ant.properties должно указывать относительный или абсолютный путь к файлу сертификата.

  4. Поместите созданное хранилище ключей в ту же папку, где находится файл ant.properties, или в другое место. (Например, по соображениям безопасности вы можете решить не проверять хранилище ключей в системе управления версиями.)

  5. Построение приложения Android.

    При построении приложения Visual Studio будет подписывать пакет с помощью указанных учетных данных.

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

    Visual Studio не проверяет учетные данные, поэтому следует убедиться в их правильности.

Если вы случайно удалили файл ant.properties, создайте новый проект и скопируйте файл из своего нового проекта в предыдущий проект.

Совет

Сведения о создании пакетных активов для Android см. в документации GitHub.

Упаковка и подписание приложения iOS

Для создания пакета, который может использоваться на устройстве iOS, его необходимо подписать с помощью действительной учетной записи разработчика Apple iOS и Mac с Xcode.

Подписание приложения iOS

  1. Создайте профиль подготовки для приложения с помощью портала разработчиков Apple.

  2. Скачайте и установите профиль подготовки на Mac, который используется в качестве компьютера сборки.

  3. В Xcode откройте панель предпочтений Учетные записи и проверьте, зарегистрирован ли ваш идентификатор Apple. Если он не указан, нажмите кнопку +, чтобы добавить его.

  4. В Visual Studio выберите конфигурацию отладки или выпуска.

    • При построении конфигурации отладки удаленный агент Visual Studio по умолчанию выбирает первое допустимое удостоверение подписи для разработки iOS, установленное на вашем Mac.

    • При построении конфигурации выпуска удаленный агент Visual Studio по умолчанию выбирает первое допустимое удостоверение подписи для распространения iOS, установленное на вашем Mac.

    Важно!

    Убедитесь, что Mac имеет нужный профиль подготовки, соответствующий выбранной конфигурации.Подробные сведения см. в библиотеке для разработчиков iOS Developer Library.Ведение сертификатов и удостоверений для подписи

    Примечание

    Удостоверение подписи является действительным, если идентификатор подготовки профиля совпадает с идентификатором пакета, указанным в конструкторе конфигурации Visual Studio.Например, профиль подготовки com.msft.multidevice.* совпадает с идентификатором пакета для com.msft.multidevice.someName.Во многих случаях можно использовать подстановочный профиль подготовки, совпадающий со всеми идентификаторами пакетов (в таких случаях допустимость не проверяется).

  5. Построение приложения

Совет

Сведения о создании пакетных активов для iOS см. в документации GitHub.

Принудительное указание удостоверения подписи

  1. Создайте папку res\native\ios\cordova в проекте Cordova.

  2. Для переопределения удостоверения подписи или профиля подготовки для конфигурации отладки поместите пользовательский файл build-debug.xcconfig в эту папку либо поместите файл build-release.xcconfig так, чтобы он переопределил конфигурацию выпуска.

    • Базовые файлы можно найти здесь на сайте github.

    • build-release.xcconfig содержит пример синтаксиса для настройки удостоверения подписи.

    • При создании собственного файла xcconfig не забудьте включить следующее в верхней части файла: #include "build.xcconfig"

    • Полный набор параметров сборки, которые можно переопределить, см. в разделе Параметры сборки Xcode.

Упаковка и подписание приложения Windows 8, Windows 8.1 или Windows Phone 8.1

В Visual Studio реализованы встроенные функции, позволяющие выполнять упаковку приложений Windows 8, Windows 8.1 и Windows Phone 8.1 для распространения. Создаются пакеты в формате APPX.

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

Манифест AppxManifest может неверно обновляться при создании связи с Магазином.Это может привести к ошибке при публикации приложения в Магазине.Кроме того, конструктор конфигурации в настоящее время не предоставляет метод для создания пакетов APPX.См. возможные пути решения этих распространенных проблем на странице Known Issues.

Подписание приложения Windows 8, Windows 8.1 или Windows Phone 8.1 для распространения.

  1. В Visual Studio выберите Проект, Магазин, Связать приложение с магазином.

    Связывание приложения с Магазином Windows

  2. После появления системного сообщения войдите в систему с использованием своей учетной записи Майкрософт, выберите имя для приложения, а затем нажмите Резервирование.

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

    В пределах хранилища Windows имена приложений должны быть уникальными.

  3. После того, как приложение зарезервировано, выберите Связать.

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

Совет

Сведения о создании пакетных активов для Windows см. в документации GitHub.

Упаковка и подписание приложения Windows Phone 8

Приложения для Windows Phone 8 упаковываются автоматически и не обязательно должны подписываться на этапе построения. Для отправки созданного файла XAP в хранилище используйте процедуру, описанную в разделе Отправка приложения в центре разработчиков Windows.

Примечание

Если в качестве целевой платформы сборки настроена Windows Phone 8.1, пакет создается в формате APPX.Дополнительные сведения см. в предыдущем разделе.

Если вам требуется изменить язык по умолчанию в пакете Windows Phone 8, найдите файл WMAppManifest.xml в папке bld/Debug/platforms/wp8, измените тег <DefaultLanguage code="en-US" /> и включите файл в проект Visual Studio в следующей папке: /res/native/wp8/Properties. Таким образом можно включить настраиваемый XML-файл в созданный проект.

Загрузка средств Получить средства Visual Studio для Apache Cordova или узнать больше

См. также

Основные понятия

Публикация приложения, созданного с помощью Visual Studio Tools для Apache Cordova

Другие ресурсы

Вопросы и ответы