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

Расширение (в пакете или расширениях) (Windows 10)

  • Статья

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

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

пакета

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

          расширения

Синтаксис

<Extension
  Category = 'A string that can have one of the following values: "windows.activatableClass.inProcessServer", "windows.activatableClass.outOfProcessServer", "windows.activatableClass.proxyStub", "windows.certificates", "windows.publisherCacheFolders", "windows.comInterface", or "windows.loaderSearchPathOverride".'
  uap10:TrustLevel = 'An optional string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior = 'An optional string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters = 'An optional string with a 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 -->
  InProcessServer
  OutOfProcessServer
  ProxyStub
  Certificates
  PublisherCacheFolders
  com:ComInterface
  uap6:LoaderSearchPathOverride

</Extension>

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

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
категории Тип точки расширяемости пакета. Строка, которая может иметь одно из следующих значений: windows.activatableClass.inProcessServer, windows.activatableClass.outOfProcessServer, windows.activatableClass.proxyStubwindows.certificates, windows.publisherCacheFolders, windows.comInterfaceили windows.loaderSearchPathOverride Да
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 через реестр) или новыми более расширенными способами. Значение по умолчанию — "современный". Для compatMode="classic" требуется возможность Microsoft.classicAppCompat_8wekyb3d8bbwe. Необязательная строка может иметь одно из следующих значений: классических или современных. Нет
desktop7:Scope Указывает, отображаются ли регистрации только для других приложений, работающих как пользователь, у которого зарегистрирован этот пакет (пользователь), или отображается ли они всем пользователям и службам на компьютере (компьютере). Значение по умолчанию — user. Scope="machine" требует возможности Microsoft.classicAppCompatElevated_8wekyb3d8bbwe. Необязательная строка, которая может иметь одно из следующих значений: компьютера или пользователя. Нет

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

Дочерний элемент Описание
сертификатов Объявляет точку расширяемости пакета типа windows.certificates. Приложению требуется один или несколько сертификатов из указанных хранилищ сертификатов.
InProcessServer Объявляет точку расширяемости пакета типа windows.activatableClass.inProcessServer. Приложение использует библиотеку динамических ссылок (.dll), которая предоставляет один или несколько активируемых классов.
OutOfProcessServer Объявляет точку расширения пакета типа windows.activatableClass.outOfProcessServer. Приложение использует исполняемый файл (.exe), предоставляющий один или несколько активируемых классов.
ProxyStub Объявляет точку расширяемости пакета типа windows.activatableClass.proxyStub. Прокси-сервер может состоять из одного или нескольких интерфейсов.
PublisherCacheFolders Объявляет точку расширяемости пакета типа windows.publisherCacheFolders. Это указывает одну или несколько папок, общих папок с другими пакетами из того же издателя.
com:ComInterface Объявляет точку расширения пакета типа windows.comInterface.
uap6:LoaderSearchPathOverride Объявляет точку расширения пакета типа windows.loaderSearchPathOverride.

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

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

Следующие элементы имеют то же имя, что и этот, но другое содержимое или атрибуты:

  • расширения (глобальное)

Замечания

Точки расширяемости — это механизм, с помощью которого пакет может добавлять функциональные возможности в соответствии с операционной системой. Точка расширяемости — это расположение, в котором приложение может зарегистрировать код или использовать ресурсы текущего пакета. Чтобы добавить функциональные возможности для конкретного приложения, используйте дочерний элемент приложения Application элемента Apps.

Точка расширения windows.certificates не может быть объявлена несколько раз в манифесте.

См. также

Требования

Пункт Ценность
пространства имен http://schemas.microsoft.com/appx/manifest/foundation/windows10
com http://schemas.microsoft.com/appx/manifest/com/windows10
uap6 http://schemas.microsoft.com/appx/manifest/uap/windows10/10