desktop6:Extension (в пакете/расширениях)

Статья
07/20/2023

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

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

<desktop6:Extension>

Синтаксис

<desktop6:Extension
  Category = 'A string that can have one of the following values: "windows.mutablePackageDirectories" or "windows.customInstall".'
  Executable = 'An optional string with a value between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *. It 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 that EntryPoint property isnt specified, the EntryPoint defined for the app is used.'
  EntryPoint = 'An optional string with a value between 1 and 256 characters in length, representing the  task handling the extension. This is 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 = 'An optional string with a value between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, |, ?, or *.'
  StartPage = 'An optional string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
  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.' >

  <!-- Child elements -->
  ( desktop6:MutablePackageDirectories
  | desktop6:CustomInstall )?

</desktop6:Extension>

Ключ

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

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

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
Категория	Категория расширения.	Строка, которая может иметь одно из следующих значений: windows.mutablePackageDirectories или windows.customInstall.	Да
Исполняемый объект	Исполняемый файл запуска по умолчанию.	Необязательная строка со значением длиной от 1 до 256 символов, которая должна заканчиваться `.exe` на и не может содержать следующие символы: `<`, `>`, `:`, `"`, `\|?`, или `*`. Он задает исполняемый файл по умолчанию для расширения. Если значение не указано, используется исполняемый файл, определенный для приложения. Если указано, также используется свойство EntryPoint. Если это свойство EntryPoint не указано, используется точка входа, определенная для приложения.	Нет
EntryPoint	Идентификатор активируемого класса.	Необязательная строка со значением от 1 до 256 символов в длину, представляющая задачу, обрабатывающую расширение. Как правило, соответствует полному имени пространства имен типа среды выполнения Windows. Если entryPoint не указан, вместо этого используется точка EntryPoint, определенная для приложения.	Нет
Тип среды выполнения	Поставщик среды выполнения. Этот атрибут обычно используется при наличии в приложении смешанных платформ.	Необязательная строка со значением длиной от 1 до 255 символов, которая не может начинаться или заканчиваться точкой или содержать следующие символы: `<`, `>`, `:`, `"`, `\|?/\`, или .`*`	Нет
StartPage	Веб-страница, обрабатывающая точку расширения.	Необязательная строка со значением от 1 до 256 символов в длину, которая не может содержать следующие символы: `<`, `>`, `:`, `"`, `\|?`, или `*`.	Нет
uap10:TrustLevel	Указывает уровень доверия расширения.	Необязательная строка, которая может иметь одно из следующих значений: appContainer или mediumIL.	Нет
uap10:RuntimeBehavior	Указывает поведение расширения во время выполнения.	Необязательная строка, которая может иметь одно из следующих значений: windowsApp, packagedClassicApp или win32App.	Нет
uap10:HostId	Указывает идентификатор среды выполнения узла для расширения.	Буквенно-цифровая строка со значением от 1 до 255 символов. Должен начинаться с буквы.	Нет
uap10:Parameters	Содержит параметры командной строки для передачи в расширение. Поддерживается только для классических приложений с удостоверением пакета.	Необязательная строка со значением от 1 до 32767 символов в длину с символом, не являющиеся пробелами, в начале и конце.	Нет

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

Дочерний элемент	Описание
MutablePackageDirectories	Позволяет классическому приложению указать одну или несколько папок, в которых пользователи могут изменять файлы установки приложения (например, для установки модов).
CustomInstall	Позволяет классическому приложению указать один или несколько дополнительных файлов установщика (.exe или .msi), установленных вместе с классическим приложением. Например, это полезно для приложений, которые упаковывают распространяемый компонент стороннего производителя.

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

Описание

MutablePackageDirectories

Позволяет классическому приложению указать одну или несколько папок, в которых пользователи могут изменять файлы установки приложения (например, для установки модов).

CustomInstall

Позволяет классическому приложению указать один или несколько дополнительных файлов установщика (.exe или .msi), установленных вместе с классическим приложением. Например, это полезно для приложений, которые упаковывают распространяемый компонент стороннего производителя.

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

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

Требования

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