uap:Extension (Windows 10)

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

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

<Пакет>

    <Приложения>

         <Приложение>

              <Расширения>

                   <uap:Extension>

Синтаксис

<uap:Extension
  Category = 'A string that can have one of the following values: "windows.fileTypeAssociation", "windows.protocol", "windows.autoPlayContent", "windows.autoPlayDevice", "windows.shareTarget", "windows.search", "windows.fileOpenPicker", "windows.fileSavePicker", "windows.cachedFileUpdater", "windows.cameraSettings", "windows.accountPictureProvider", "windows.printTaskSettings", "windows.lockScreenCall", "windows.appointmentsProvider", "windows.alarm", "windows.webAccountProvider", "windows.dialProtocol", "windows.appService", "windows.mediaPlayback", "windows.print3DWorkflow", "windows.lockScreen", "windows.aboveLockScreen", "windows.personalAssistantLaunch", or "windows.voipCall".'
  Executable = 'A string with an optional value between 1 and 256 characters in length, that must end with ".exe", and cannot contain the following characters: <, >, :, ", |, ?, or *. Specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If the EntryPoint property is not specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'A string with an optional value between 1 and 256 characters in length. Represents the task handling the extension (normally the fully namespace-qualified name of a Windows Runtime type). If EntryPoint is not specified, the EntryPoint defined for the app is used instead.'
  RuntimeType = 'A string with an optional value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'A string with an optional value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  ResourceGroup = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:TrustLevel = 'An optional string value. If specified, it must be either "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior  = 'An optional string value. If specified, it must be one of the following values:  "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with an optional value between 1 and 255 characters in length. Must begin with an letter.'
  uap10:Parameters = 'A string with an optional value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Id = 'An optional string with a value 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 with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the 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:FileTypeAssociation?
  uap:Protocol?
  uap:AutoPlayContent?
  uap:AutoPlayDevice?
  uap:ShareTarget?
  uap:FileOpenPicker?
  uap:FileSavePicker?
  uap:AppointmentsProvider?
  uap:WebAccountProvider?
  uap:DialProtocol?
  uap:AppService?
  uap:MediaPlayback?
  uap:VoipCall?

</uap:Extension>

Ключ

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

Элементы и атрибуты

Атрибуты

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

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

Комментарии

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

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

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

Для следующих расширений Extension@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, чтобы обеспечить уникальное взаимодействие с диалоговым окном трехмерной печати. В противном случае Windows предоставляет возможности трехмерной печати по умолчанию. Допускается только один экземпляр этого объявления на каждое приложение.
• PersonalAssistantLaunch: позволяет приложению интегрироваться с Кортаной. Допускается только один экземпляр этого объявления на каждое приложение.

Требования