uap4:Extension

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

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

<Пакет>

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

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

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

                   <uap4:Extension>

Синтаксис

<uap4:Extension
  Category = 'A string that can have one of the following values: "windows.sharedFonts", "windows.userDataTaskDataProvider", "windows.mediaCodec", "windows.contactPanel", "windows.loopbackAccessRules", "windows.devicePortalProvider", "windows.printWorkflowBackgroundTask", or "windows.printWorkflowForegroundTask".'
  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 -->
  uap4:SharedFonts
  uap4:UserDataTaskDataProvider
  uap4:MediaCodec 
  uap4:ContactPanel
  uap4:LoopbackAccessRules
  uap4:DevicePortalProvider?

</uap4:Extension>

Ключ

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

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

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
Категория Тип точки расширяемости пакета. Строка, которая может иметь одно из следующих значений: windows.sharedFonts, windows.userDataTaskDataProvider, windows.mediaCodec, windows.contactPanel, windows.loopbackAccessRules, windows.devicePortalProvider, windows.printWorkflowBackgroundTask или windows.printWorkflowForegroundTask. Да
EntryPoint Идентификатор активируемых классов. Строка со значением от 1 до 256 символов в длину. Представляет задачу, обрабатыващую расширение (обычно это полное имя пространства имен среда выполнения Windows типа). Если EntryPoint не указан, вместо него используется точка EntryPoint, определенная для приложения. Нет
Исполняемый объект Исполняемый файл запуска по умолчанию. Строка со значением от 1 до 256 символов, которая должна заканчиваться .exeна и не может содержать следующие символы: <, >, :, "|, , ?или *. Указывает исполняемый файл по умолчанию для расширения. Если он не указан, используется исполняемый файл, определенный для приложения. Если этот параметр указан, также используется свойство EntryPoint. Если это свойство 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:Подсистема Этот атрибут наследуется от синтаксиса базового расширения и неприменим к расширению 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. Нет

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

Дочерний элемент Описание
SharedFonts Содержит расположения общих шрифтов для использования с приложением.
UserDataTaskDataProvider Позволяет приложению стать DataProvider для задачи.
MediaCodec Определяет расширение, позволяющее приложению устанавливать кодеки мультимедиа из Microsoft Store.
ContactPanel Включает панель контактов в приложении для Windows.
LoopbackAccessRules Содержит правила для фильтра замыкания на себя, который обеспечивает обмен данными между приложением и службой.
DevicePortalProvider Определяет поставщика портала устройств для развертывания.

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

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

Комментарии

windows.printWorkflowBackgroundTask и windows.printWorkflowForegroundTask — это пустые объявления расширений, обеспечивающие поддержку сценариев печати. Начальная точка входа фоновой задачи будет вызываться системой печати для начала обработки данных печати, а задача переднего плана будет активирована при запросе дополнительных сведений от пользователя. Фоновая точка входа должна быть классом, реализующим IBackgroundTask.

Требования

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