uap:Extension (Windows 10)

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

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

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <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 не указано, оно будет неявно сгруппировано с 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: позволяет приложению интегрироваться с Кортаны. Для каждого приложения допускается только один экземпляр этого объявления.

Требования