uap:Extension

Объявляет точку расширяемости для приложения.

Иерархия элементов

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <uap:Extension>

Синтаксис

<uap:Extension
  Category = 'A required the extension category for a UAP extension.'
  desktop11:AppLifecycleBehavior = 'An optional string that can have one of the following values: "systemManaged", or "unmanaged".'
  Executable = 'An optional string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
  EntryPoint = 'An optional string between 1 and 256 characters in length that cannot start or end with a whitespace character.'
  RuntimeType = 'An optional string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, &#124;, ?, or *.'
  StartPage = 'An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer", or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
  uap10:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Id = 'An optional string between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console", or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *.'
  uap11:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string that can have one of the following values: "classic", or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine", or "user".' >

  <!-- Child elements -->
  uap:FileTypeAssociationChoice?
  uap:ProtocolChoice?
  uap:AppServiceChoice?
  uap:AutoPlayContent?
  uap:AutoPlayDevice?
  uap:ShareTarget?
  uap:FileOpenPicker?
  uap:FileSavePicker?
  uap:AppointmentsProvider?
  uap:WebAccountProvider?
  uap:DialProtocol?
  uap:MediaPlayback?
  uap:VoipCall?

</uap:Extension>

Ключ

? необязательный (ноль или один)

Атрибуты

Дочерние элементы

Родительские элементы

Требования

Замечания

Для большинства типов расширений Extension@ResourceGroup должно соответствовать Application@ResourceGroup (если Application@ResourceGroup опущен, то Extension@ResourceGroup следует также опустить).

Для контракта на основе пользовательского интерфейса: если Extension@ResourceGroup не указано, оно будет неявно сгруппировано с Applicationпомощью ; если Extension@ResourceGroup не соответствует Application@ResourceGroup, манифест завершится ошибкой проверки схемы.

Если Extension@ResourceGroup не заданы для фоновой задачи или контракта, основанного на фоновой задаче, она будет связана с группой по умолчанию для всех фоновых задач. Контракты фоновых задач могут указывать те же значения, что Applicationи @ResourceGroup.

Для следующих ExtensionsExtension@ResourceGroup позволяет сгруппировать фоновую задачу в различные процессы, которые будут управляться ресурсом и жизненным циклом независимо от других групп: windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask и windows.updateTask.

Например, если манифест имел эти три записи.

<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" ResourceGroup="Group1">
  <BackgroundTasks>
    <Task Type="timer"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask2" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="controlChannel"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask3" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="pushNotification"/>
  </BackgroundTasks>
</Extension>

Затем последние две фоновые задачи будут активированы в одном экземпляре backgroundtaskhost.exe , если они были активированы одновременно. Однако отдельный экземпляр backgroundtaskhost.exe будет вставка для первой записи, так как она имеет другую группу ресурсов.

Если для расширения не указана группа ресурсов, все фоновые задачи активируются в одном экземпляре backgroundtaskhost.exe.

Кроме того, если один из этих расширений (windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask или windows.updateTask) указывает то же значение атрибута ResourceGroup родительского Application элемента, что они будут активированы в том же процессе, что и пользовательский интерфейс.

Следующие расширения можно найти на вкладке объявлений пользовательского интерфейса конструктора пакетов. См. описание каждого из этих элементов:

• Поиск. Регистрирует приложение в качестве поставщика поиска. Индексированные содержимое приложения могут отображаться как результаты поиска в глобальном интерфейсе поиска, запущенном с помощью чудо-кнопки поиска. Для каждого приложения допускается только один экземпляр этого объявления.
• CachedFileUpdater: регистрирует приложение в качестве кэшированного модуля обновления файлов, позволяя приложению предоставлять обновления файлов, к которым обращаются другие приложения Microsoft Store. Для каждого приложения допускается только один экземпляр этого объявления.
• Параметры камеры: позволяет приложению предоставлять пользовательские панели управления для устройств веб-камеры. Для каждого приложения допускается только один экземпляр этого объявления.
• AccountPictureProvider: регистрирует приложение в качестве поставщика рисунков учетной записи, позволяя запускать его в режиме рисунка учетной записи и настраивать рисунок пользователя без дополнительных запросов. Для каждого приложения допускается только один экземпляр этого объявления.
• PrintTaskSettings: позволяет приложению заменить базовые параметры печати. Для каждого приложения допускается только один экземпляр этого объявления.
• LockScreen: если телефон заблокирован, существует ограниченное количество взаимодействия, которое может выполнять пользователь. В некоторых случаях пользователь хотел бы иметь возможность ответить на звонок VoIP без разблокировки телефона. Этот контракт делает это возможным. Для каждого приложения допускается только один экземпляр этого объявления.
• Тревога: приложение может объявить себя как приложение системы сигнализации. Когда пользователь проходит через пользовательский интерфейс выбора, чтобы задать системную сигнализацию, можно выбрать только приложения, объявленные как приложения системной сигнализации. Для каждого приложения допускается только один экземпляр этого объявления.
• BackgroundTasks: фоновые задачи позволяют приложениям взаимодействовать друг с другом и позволяют одному приложению вызывать другое. Чтобы использовать контракты для предоставления или запуска этих фоновых задач, приложение должно быть объявлено как служба приложений. В каждом приложении разрешено несколько экземпляров этого объявления.
• Print3DWorkFlow. Производители трехмерных принтеров могут предоставить универсальное приложение Windows для предоставления уникального интерфейса в 3D-диалоговом окне печати. В противном случае Windows предоставляет 3D-печать по умолчанию. Для каждого приложения допускается только один экземпляр этого объявления.
• PersonalAssistantLaunch: позволяет приложению интегрироваться с Кортаны. Для каждого приложения допускается только один экземпляр этого объявления.

Примеры