Предварительно настроенные приложения для мобильных устройств

Статья
06/19/2023

Добавление предустановленного приложения в образ мобильного устройства

Процесс создания предустановленного приложения аналогичен стандартному приложению. В Центре разработки Windows 10 разработчик отправляет приложение, которое вы хотите предварительно установить в образе Windows 10 Mobile. После отправки приложения можно запросить пакет предустановки, скачать его и добавить в образ, как описано в этом разделе.

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

Запрос пакета предустановки
Создание provxml для предустановленного приложения
Добавление приложения в изображение с помощью файла ответов настройки
Создание образа

Запрос пакета предустановки

Разработчики, которые добавили приложение в Центр разработки, могут запросить пакет предустановки для него. Затем они могут передать пакет предустановки непосредственно изготовителю оборудования, с которым они работают. Если вы являетесь изготовителем оборудования, добавляя это приложение в образ ОС, вы попросите разработчика приложения скачать пакет приложения, а затем предоставить вам скачанный ZIP-файл. Вы не можете получить доступ к учетной записи разработчика напрямую. Получив пакет предварительной установки, можно перейти к остальным действиям. Дополнительные сведения о том, как разработчик создает пакеты предварительной установки для изготовителя оборудования, см. в статье Создание пакетов предварительной установки для изготовителей оборудования.

Создание provxml-файла для предустановленного приложения

Для добавления предустановленного приложения в образ ОС Windows 10 Mobile требуется файл конфигурации .provxml, в котором указаны параметры установки и идентификаторы каталога Windows 10 Store. В частности, он должен указывать путь к APPX-файлу, путь к файлу лицензии и идентификаторы каталога Магазина. Эти сведения используются, когда приложение подключается к службе Store для проверка обновлений. Чтобы свести к минимуму вероятность ошибки, портал разработчика предоставляет соответствующий XML-код для вашего приложения. Ниже приведен пример того, как может выглядеть файл .provxml.

<?xml version="1.0" encoding="UTF-8" ?>
<wap-provisioningdoc>
   <characteristic type="AppInstall">
      <characteristic type="AppXPackage">
         <parm name="ProductID" value="{09f2d20a-7076-4970-80ac-1bc24c171d2e}"/>
         <parm name="AppXPath" value="c:\Programs\CommonFiles\Xaps\SampleApp.appx"/>
         <parm name="LicensePath" value="c:\Programs\CommonFiles\Xaps\SampleAppLicense.xml"/>
         <parm name="InstanceID" value="{03e9a435-3000-11db-89ca-0019b92FFFFF}"/>
         <parm name="OfferID" value="{03e9a435-3000-11db-89ca-0019b92FFFFF}"/>
         <parm name="PayloadID" value="{03e9a435-3000-11db-89ca-0019b92FFFFF}"/>
         <parm name="UninstallDisabled" value="false"/>
         <parm name="FullyPreInstall" value="false"/>
         <parm name="ForceUpdate" value="false"/>
      </characteristic>
   </characteristic>
</wap-provisioningdoc>

Примечание

Файлы provxml для предустановленных приложений должны соответствовать предписанию соглашения об именовании. Необходимо использовать MPAP_name_index.provxml, где имя и индекс могут быть любыми строками. Как правило, name — это имя пакета обновления, содержащего предустановленное приложение, а index — это строка, которая отличает файлы provxml с одинаковым именем. Часто индекс представлен в виде числа, например 01.

Флаги provxml

Это флаги, которые можно использовать в provxml.

Flag	Описание
UninstallDisabled	Этот флаг определяет, может ли пользователь удалить предустановленное приложение. Если задано значение FALSE (по умолчанию), пользователь может удалить предустановленное приложение. Если задано значение TRUE, пользователь не может удалить приложение. Этот флаг можно задать только через provxml и не может быть переопределен с помощью обновления Store. Только обновление устройства с обновленным файлом provxml может изменить это значение. В идеале для поддержания взаимодействия с пользователем этот флаг должен иметь значение TRUE только для приложений, которые критически важны для работы телефона.
ForceUpdate	Этот флаг позволяет приложению в образе обновления ОС попытаться перезаписать существующую версию приложения, уже установленную на телефоне, перед обновлением до Windows 10 Mobile. Значение по умолчанию для этого флага — FALSE. Имейте в виду, что из-за принудительного обновления приложения установка этого флага в значение TRUE может привести к понижению функциональности, если уже установленное приложение было разработано для более ранней версии ОС. Как правило, этот флаг следует использовать только в том случае, если Windows 10 Mobile версия приложения должна находиться на телефоне сразу после обновления, даже если это означает понижение версии уже установленного приложения.
Полная предварительная установка	Этот флаг определяет, привязано ли приложение к MDIL во время первой загрузки или обновления или будет ли оно отложено до завершения этих операций. Задержка привязки MDIL, которая является поведением по умолчанию для приложений, которые не закреплены на начальном экране, позволяет пользователю как можно быстрее вернуться на свой телефон. Если привязка будет отложена до завершения первой загрузки или обновления, значок приложения будет отображаться серым с состоянием "установка" и не может выполняться до завершения отложенной привязки. Время, необходимое для выполнения всех отложенных привязок, зависит от количества отложенных предварительно загруженных приложений и действий пользователя. Поведение флага выглядит следующим образом: true: привязка MDIL возникает до завершения первой загрузки или обновления. false. Если приложение предварительно закреплено на начальном экране, привязка MDIL выполняется до завершения первой загрузки или обновления. Если приложение не закреплено на начальном экране, привязка MDIL откладывается до завершения первой загрузки или обновления. Как правило, это значение следует оставить по умолчанию (FALSE), если приложение не должно быть доступно для запуска сразу после первой загрузки или обновления ОС. Ниже приведены некоторые примеры ситуаций, когда этот флаг должен иметь значение TRUE. Приложения расширения OEM Приложения, установленные телефонным абонентом Агенты службы OEM Приложения с критическими параметрами системы

Flag

Описание

UninstallDisabled

Этот флаг определяет, может ли пользователь удалить предустановленное приложение. Если задано значение FALSE (по умолчанию), пользователь может удалить предустановленное приложение. Если задано значение TRUE, пользователь не может удалить приложение. Этот флаг можно задать только через provxml и не может быть переопределен с помощью обновления Store. Только обновление устройства с обновленным файлом provxml может изменить это значение. В идеале для поддержания взаимодействия с пользователем этот флаг должен иметь значение TRUE только для приложений, которые критически важны для работы телефона.

ForceUpdate

Этот флаг позволяет приложению в образе обновления ОС попытаться перезаписать существующую версию приложения, уже установленную на телефоне, перед обновлением до Windows 10 Mobile. Значение по умолчанию для этого флага — FALSE. Имейте в виду, что из-за принудительного обновления приложения установка этого флага в значение TRUE может привести к понижению функциональности, если уже установленное приложение было разработано для более ранней версии ОС. Как правило, этот флаг следует использовать только в том случае, если Windows 10 Mobile версия приложения должна находиться на телефоне сразу после обновления, даже если это означает понижение версии уже установленного приложения.

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

Этот флаг определяет, привязано ли приложение к MDIL во время первой загрузки или обновления или будет ли оно отложено до завершения этих операций. Задержка привязки MDIL, которая является поведением по умолчанию для приложений, которые не закреплены на начальном экране, позволяет пользователю как можно быстрее вернуться на свой телефон. Если привязка будет отложена до завершения первой загрузки или обновления, значок приложения будет отображаться серым с состоянием "установка" и не может выполняться до завершения отложенной привязки. Время, необходимое для выполнения всех отложенных привязок, зависит от количества отложенных предварительно загруженных приложений и действий пользователя. Поведение флага выглядит следующим образом:

true: привязка MDIL возникает до завершения первой загрузки или обновления.
false. Если приложение предварительно закреплено на начальном экране, привязка MDIL выполняется до завершения первой загрузки или обновления. Если приложение не закреплено на начальном экране, привязка MDIL откладывается до завершения первой загрузки или обновления.

Как правило, это значение следует оставить по умолчанию (FALSE), если приложение не должно быть доступно для запуска сразу после первой загрузки или обновления ОС. Ниже приведены некоторые примеры ситуаций, когда этот флаг должен иметь значение TRUE.

Приложения расширения OEM
Агенты службы OEM

Добавление приложения в изображение

Предустановленные приложения добавляются в образ ОС с помощью файла ответов customizations.xml. Чтобы создать файл ответов customizations.xml, сначала установите Designer конфигурации Windows, а затем создайте пакет подготовки. Затем можно открыть папку проекта, чтобы найти файл customizations.xml.

Чтобы включить предустановленные приложения в образ, необходимо добавить Application элемент в файл customizations.xml с соответствующими определяющими атрибутами. В следующем примере кода показано, как приложение будет добавлено в файл ответов настройки для предварительной установки.

    <Applications>
      <Application License="$(CAFE_OUTPUT_DIR)\content\App_MobileTV_7e7cc86e_e1c0_476a_ac88_db3c9ffffabb\MobileTV_License.xml" ProvXML="$(CAFE_OUTPUT_DIR)\content\App_MobileTV_7e7cc86e_e1c0_476a_ac88_db3c9ffffabb\MPAP_MobileTV_01.provxml" Source="$(CAFE_OUTPUT_DIR)\content\App_MobileTV_7e7cc86e_e1c0_476a_ac88_db3c9ffffabb\MobileTV.xap"/>
      <Application License="$(CAFE_OUTPUT_DIR)\content\App_AudioSettings_373cb76e_7f6c_45aa_8633_b00e85c73261\audio_License.xml" ProvXML="$(CAFE_OUTPUT_DIR)\content\App_AudioSettings_373cb76e_7f6c_45aa_8633_b00e85c73261\MPAP_audio_01.provxml" Source="$(CAFE_OUTPUT_DIR)\content\App_AudioSettings_373cb76e_7f6c_45aa_8633_b00e85c73261\audio.appx"/>
      <Application License="$(CAFE_OUTPUT_DIR)\content\App_MicrosoftHealthApp_0168b504_ca18_46b8_b60a_0f6fdc271c81\MicrosoftHealthApp_License.xml" ProvXML="$(CAFE_OUTPUT_DIR)\content\App_MicrosoftHealthApp_0168b504_ca18_46b8_b60a_0f6fdc271c81\MPAP_MicrosoftHealthApp_01.provxml" Source="$(CAFE_OUTPUT_DIR)\content\App_MicrosoftHealthApp_0168b504_ca18_46b8_b60a_0f6fdc271c81\MicrosoftHealthApp.appxbundle"/>
    </Applications>

Примечание

Файл provxml должен быть помещен в каталог $(runtime.commonfiles)\Provisioning\OEM. Файл лицензии и пакет приложения (XAP или APPX) должны быть помещены в каталог $(runtime.commonfiles)\xaps.

После настройки файла ответов customizations.xml выполните сборку образа с помощью интерфейса командной строки конфигурации Windows Designer. Инструкции см. в разделе Конфигурация Windows Designer интерфейс командной строки.

Создание образа

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

Поделиться через