Share via

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>

Ключ

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

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

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
Категория Тип точки расширяемости пакета. Строка, которая может иметь одно из следующих значений: 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 или windows.voipCall. Да
EntryPoint Идентификатор активируемого класса. Строка со значением от 1 до 256 символов в длину. Представляет задачу, обрабатыващую расширение (обычно это полное имя пространства имен среда выполнения Windows типа). Если entryPoint не указан, вместо этого используется точка EntryPoint, определенная для приложения. Нет
Исполняемый объект Исполняемый файл запуска по умолчанию. Строка со значением от 1 до 256 символов в длину, которая должна заканчиваться .exeна и не может содержать следующие символы: <, >, :, ", |, ?или *. Указывает исполняемый файл по умолчанию для расширения. Если значение не указано, используется исполняемый файл, определенный для приложения. Если указано, также используется свойство EntryPoint. Если это свойство EntryPoint не указано, используется точка входа, определенная для приложения. Нет
Тип среды выполнения Поставщик среды выполнения. Обычно используется при наличии смешанных платформ в приложении. Строка со значением длиной от 1 до 255 символов, которая не может начинаться или заканчиваться . символом или содержит символы: <, >, :, ", |?или *. Нет
StartPage Веб-страница, обрабатывающая точку расширения. Строка со значением от 1 до 256 символов в длину, которая не может содержать следующие символы: <, >, :, ", |?, или *. Нет
ResourceGroup Необязательный тег, используемый для группирования активаций расширений в целях управления ресурсами (например, ЦП и память). См. раздел Примечания в Application@ResourceGroup. Буквенно-цифровая строка длиной от 1 до 255 символов. Должен начинаться с буквы. Нет
uap10:TrustLevel Указывает уровень доверия расширения. Необязательное строковое значение. Если он указан, это может быть одно из следующих значений: appContainer или mediumIL. Нет
uap10:RuntimeBehavior Указывает поведение расширения в среде выполнения. Необязательное строковое значение. Если этот параметр указан, это может быть одно из следующих значений: windowsApp, packagedClassicApp или win32App. Нет
uap10:HostId Указывает идентификатор среды выполнения узла для расширения. Буквенно-цифровая строка с необязательным значением длиной от 1 до 255 символов. Должен начинаться с буквы. Нет
uap10:Parameters Содержит параметры командной строки для передачи в расширение. Поддерживается только для классических приложений. Строка со значением от 1 до 32767 символов в длину с символом, не являющиеся пробелами, в начале и конце. Нет
uap11:Id Идентификатор расширения. Идентификатор должен быть уникальным для всех расширений в пакете. Необязательная строка со значением от 1 до 255 символов в длину с символом без пробелов в начале и конце. Нет
uap11:Subsystem Этот атрибут наследуется от базового синтаксиса расширения и неприменим к расширению com4. Кроме синтаксической проверки, это значение игнорируется. Необязательная строка, которая может иметь одно из следующих значений: консоль или окна. Нет
uap11:SupportsMultipleInstances Указывает, должны ли экземпляры выполняться в разных процессах. Значением по умолчанию является false. Необязательное логическое значение. Нет
uap11:ResourceGroup Тег, который можно использовать для группирования активаций расширений в целях управления ресурсами (например, ЦП и памяти). Значение ResourceGroup можно задать в свободной форме и является гибким. См . Application@ResourceGroup. Необязательная буквенно-цифровая строка со значением от 1 до 255 символов. Должен начинаться с буквы. Нет
uap11:CurrentDirectoryPath Указывает начальный каталог при запуске процесса приложения. Этот атрибут поддерживает макросы. Дополнительные сведения см. в разделе Макросы в схеме манифеста пакета. Необязательная строка, которая не может содержать следующие символы: <, >, |, ?или *. > Нет
uap11:Parameters Этот атрибут наследуется от базового синтаксиса расширения и неприменим к расширению com4. Кроме синтаксической проверки, это значение игнорируется. Этот атрибут поддерживает макросы. Дополнительные сведения см. в разделе Макросы в схеме манифеста пакета. Необязательная строка со значением от 1 до 32767 символов в длину с символом, не являющиеся пробелами, в начале и конце. Нет
desktop7:CompatMode Указывает, регистрируются ли сведения этого расширения в Windows классическими способами (например, неупакованные приложения регистрируют типы в COM через реестр) или новыми способами с более ограниченной областью. Значение по умолчанию — modern. CompatMode="classic" требует возможности Microsoft.classicAppCompat_8wekyb3d8bbwe . Необязательная строка может иметь одно из следующих значений: classic или modern. Нет
desktop7:Scope Указывает, видны ли регистрации только другим приложениям, работающим от имени пользователя, у которого зарегистрирован этот пакет (пользователь), или же они видны всем пользователям и службам на компьютере (компьютере). Значение по умолчанию — user. Scope="machine" требует возможности Microsoft.classicAppCompatElevated_8wekyb3d8bbwe . Необязательная строка, которая может иметь одно из следующих значений: machine или user. Нет

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

Дочерний элемент Описание
uap:AppService Объявляет точку расширяемости приложения типа windows.appService. Контракты приложений — это способ вызова приложением фоновой задачи, принадлежащей другому приложению; или для фоновой задачи, вызываемой для обслуживания контракта приложения, способ взаимодействия с вызывающим.
uap:AppointmentsProvider Объявляет точку расширяемости приложения типа windows.appointmentsProvider.
uap:AutoPlayContent Объявляет точку расширяемости приложения типа windows.autoPlayContent. Приложение предоставляет указанные действия автозапуска содержимого.
uap:AutoPlayDevice Объявляет точку расширяемости приложения типа *windows.autoPlayDevice. Приложение предоставляет указанные действия автозапуска устройства.
uap:DialProtocol Объявляет точку расширяемости приложения типа windows.dialProtocol*.
uap:FileOpenPicker Объявляет точку расширяемости приложения типа windows.fileOpenPicker. Приложение позволяет пользователю выбирать и открывать указанные типы файлов.
uap:FileSavePicker Объявляет точку расширяемости приложения типа windows.fileSavePicker. Приложение позволяет пользователю выбрать имя файла, расширение и место хранения для указанных типов файлов.
uap:FileTypeAssociation Объявляет точку расширяемости приложения типа windows.fileTypeAssociation. Сопоставление типов файлов указывает, что приложение зарегистрировано для обработки файлов указанных типов.
uap:MediaPlayback Объявляет точку расширяемости приложения типа mediaPlayback, чтобы приложение велло объявление о том, что оно выполняет перекодирование видео.
uap:Protocol Объявляет точку расширяемости приложения типа windows.protocol. Связь URI указывает, что приложение зарегистрировано для обработки URI с указанной схемой.
uap:ShareTarget Объявляет точку расширения приложения типа windows.shareTarget. Приложение может совместно использовать указанные типы файлов.
uap:VoipCall Объявляет точку расширяемости приложения типа windows.voipCall , чтобы ваше приложение хозяйственно объявляло, что оно может выполнять обновление с сотовой связи до видеозвонка VoIP и (или) является ли приложение VoIP, которое поддерживает набор телефонных номеров напрямую.
uap:WebAccountProvider Объявляет точку расширяемости приложения типа windows.webAccountProvider.

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

Родительский элемент Описание
Расширения (тип:CT_ApplicationExtensions) Определяет одну или несколько точек расширяемости для приложения.

Комментарии

Для большинства типов расширений 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: позволяет приложению интегрироваться с Кортаной. Допускается только один экземпляр этого объявления на каждое приложение.

Требования

Элемент Значение
rescap4 http://schemas.microsoft.com/appx/manifest/uap/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version Windows 10 версии 1511 (сборка 10586)