Поделиться через

uap5:Extension

  • Статья

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

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

> пакета<

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

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

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

                    <uap5:Extension>

Синтаксис

<uap5:Extension
  Category = 'A string that can have one of the following values: "windows.userActivity", "windows.mediaSource", "windows.videoRendererEffect", "windows.activatableClass.outOfProcessServer", "windows.startupTask", or "windows.appExecutionAlias".'
  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 -->
  uap5:UserActivity
  uap5:MediaSource
  uap5:VideoRendererEffect 
  uap5:ActivatableClass.OutOfProcessServer
  uap5:StartupTask
  uap5:AppExecutionAlias?

</uap5:Extension>

Ключ

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

Атрибуты и элементы

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
категории Тип точки расширяемости пакета. Строка, которая может иметь одно из следующих значений: windows.userActivity, windows.mediaSource, windows.videoRendererEffect, windows.activityClass.outOfProcessServer, windows.startupTaskили windows.appExecutionAlias. Да
EntryPoint Идентификатор активируемого класса. Строка со значением от 1 до 256 символов длиной. Представляет задачу, обрабатывая расширение (обычно полное имя пространства имен типа среды выполнения Windows). Если Запись не указана, вместо этого используется точка входа, определенная для приложения. Нет
исполняемых Исполняемый файл по умолчанию. Строка со значением от 1 до 256 символов длиной, которая должна заканчиваться .exe, и не может содержать следующие символы: <, >, :, ", |, ?или *. Указывает исполняемый файл по умолчанию для расширения. Если это не указано, используется исполняемый файл, определенный для приложения. При указании также используется свойство EntryPoint. Если это свойство EntryPoint не указано, используется запись, определенная для приложения. Нет
RuntimeType Поставщик среды выполнения. Обычно используется при наличии смешанных платформ в приложении. Строка со значением от 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:Подсистема Подсистема, предназначенная расширением. Необязательная строка, которая может иметь одно из следующих значений: консоли или окнах. Нет
uap11:SupportsMultipleInstances Указывает, должны ли экземпляры выполняться в разных процессах. Значение по умолчанию — false. Необязательное логическое значение. Нет
uap11:ResourceGroup Тег, который можно использовать для группирования активаций расширений вместе для целей управления ресурсами (например, ЦП и памяти). Значение, которое можно задать ResourceGroup, является свободным и гибким. См. Application@ResourceGroup. Необязательная буквенно-цифровые строки со значением от 1 до 255 символов длиной. Должно начинаться с буквы. Нет
uap11:CurrentDirectoryPath Указывает начальный каталог при запуске процесса приложения. Этот атрибут поддерживает макросы. Дополнительные сведения см. в разделе Макросы в схеме манифеста пакета. Необязательная строка, которая не может содержать эти символы: <, >, |, ?или *. > Нет
uap11:Parameters Подсистема, предназначенная расширением. Этот атрибут поддерживает макросы. Дополнительные сведения см. в разделе Макросы в схеме манифеста пакета. Необязательная строка со значением от 1 до 32767 символов длиной с символом без пробелов в начале и конце. Нет
desktop7:CompatMode Указывает, регистрируются ли сведения этого расширения в Windows классическими способами (например, распакованные типы приложений регистрируются с помощью COM через реестр) или новыми более расширенными способами. Значение по умолчанию — "современный". Для compatMode="classic" требуется возможность Microsoft.classicAppCompat_8wekyb3d8bbwe. Необязательная строка может иметь одно из следующих значений: классических или современных. Нет
desktop7:Scope Указывает, отображаются ли регистрации только для других приложений, работающих как пользователь, у которого зарегистрирован этот пакет (пользователь), или отображается ли они всем пользователям и службам на компьютере (компьютере). Значение по умолчанию — user. Scope="machine" требует возможности Microsoft.classicAppCompatElevated_8wekyb3d8bbwe. Необязательная строка, которая может иметь одно из следующих значений: компьютера или пользователя. Нет

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

Дочерний элемент Описание
UserActivity Позволяет приложению указать веб-сайт, связанный с этим приложением для публикации кроссплатформенного пользователя UserActivity.
MediaSource Указывает источник мультимедиа и службу приложений, которые она предоставляет.
VideoRendererEffect Включает активацию эффектов отрисовщика видео в приложениях.
АктивацияClass.OutOfProcessServer Объявляет точку расширения пакета типа windows.activatableClass.outOfProcessServer. Это позволяет 3-сторонним классам WinRT, определенным в пакете приложения, вызываться из процесса Win32.
StartupTask Задает задачу запуска приложения.
AppExecutionAlias Указывает псевдоним выполнения приложения, чтобы определить точку входа для активации приложения.

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

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

Требования

Пункт Ценность
пространства имен http://schemas.microsoft.com/appx/manifest/uap/windows10/5
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
минимальная версия ОС Windows 10 версии 1709 (сборка 16299)