Extension (в Application)

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

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

<Package>
   └─ <Applications>
      └─ <Application>
         └─ <Extensions>
            └─ <Extension>

Syntax

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10">
  ...
  <Extension
    Category = 'A required string that can have one of the following values: "windows.backgroundTasks", "windows.preInstalledConfigTask", "windows.updateTask", or "windows.restrictedLaunch".'
    desktop11:AppLifecycleBehavior = 'An optional string that can have one of the following values: "systemManaged", or "unmanaged".'
    Executable = 'An optional string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, ", |, ?, or *.'
    EntryPoint = 'An optional string between 1 and 256 characters in length that cannot start or end with a whitespace character.'
    RuntimeType = 'An optional string between 1 and 255 characters in length that cannot start or end with a period or contain these characters: <, >, :, ", /, \, &#124;, ?, or *.'
    StartPage = 'An optional string between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    ResourceGroup = 'An optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
    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 optional alphanumeric string between 1 and 255 characters in length. Must begin with an alphabetic character.'
    uap10:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    uap11:Id = 'An optional string 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 between 1 and 255 characters in length. Must begin with an alphabetic character.'
    uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *.'
    uap11:Parameters = 'An optional string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
    desktop7:CompatMode = 'An optional string that 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 -->
    BackgroundTasks?

  </Extension>
</Package>

Ключ

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

Атрибуты

Атрибут Description Тип данных Обязательный Значение по умолчанию
Категория Тип расширения. Строка, которая может иметь одно из следующих значений: windows.backgroundTasks, windows.preInstalledConfigTask, windows.updateTask, windows.restrictedLaunch. Yes
desktop11:AppLifecycleBehavior Необязательная строка, которая может иметь одно из следующих значений: systemManaged, неуправляемая. Нет
Исполнимый файл Исполняемый файл по умолчанию. Необязательная строка от 1 до 256 символов длиной, которая должна заканчиваться ".exe" и не может содержать следующие символы: <, , >: , ", ", |, ?или *". Нет
EntryPoint Идентификатор активируемого класса. Необязательная строка от 1 до 256 символов длиной, которая не может начинаться или заканчиваться символом пробела. Нет
RuntimeType Поставщик среды выполнения. Обычно используется при наличии смешанных платформ в приложении. Необязательная строка от 1 до 255 символов длиной, которая не может начинаться или заканчиваться периодом или содержать следующие символы: <, , >: , ", /, |, ?или *. Нет
StartPage Веб-страница, обрабатывающая точку расширяемости. Необязательная строка от 1 до 256 символов длиной, которая не может содержать следующие символы: <, , >:, ", |, ?или *. Нет
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:Подсистема Этот атрибут полезен для процессов, отличных от UWP, которые необходимо запустить с определенной подсистемой. В большинстве случаев это должно оставаться по умолчанию. Необязательная строка, которая может иметь одно из следующих значений: консоль, окна. Нет
uap11:SupportsMultipleInstances Указывает, поддерживает ли расширение несколько экземпляров. Необязательное логическое значение. Нет
uap11:ResourceGroup Тег, который можно использовать для группирования активаций расширений вместе для целей управления ресурсами (например, ЦП и памяти). Необязательная буквенно-цифровые строки длиной от 1 до 255 символов. Должен начинаться с алфавитного символа. Нет
uap11:CurrentDirectoryPath Указывает начальный каталог при запуске процесса. Необязательная строка, которая не может содержать следующие символы: <, >|, ?или *. Нет
uap11:Parameters Содержит параметры командной строки для передачи в расширение. Необязательная строка между 1 и 32767 символами длиной без пробелов в начале и конце. Нет
desktop7:CompatMode Указывает режим совместимости для расширения. Необязательная строка, которая может иметь одно из следующих значений: классическая, современная. Нет
desktop7:Scope Указывает, является ли расширение для каждого пользователя или компьютера. Необязательная строка, которая может иметь одно из следующих значений: компьютер, пользователь. Нет

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

Дочерний элемент Description
BackgroundTasks Определяет точку расширяемости приложения типа windows.backgroundTasks. Фоновые задачи выполняются в выделенном фоновом узле; то есть без пользовательского интерфейса.

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

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

Требования

Элемент Ценность
Namespace http://schemas.microsoft.com/appx/manifest/foundation/windows10
desktop11 http://schemas.microsoft.com/appx/manifest/desktop/windows10/11
desktop7 http://schemas.microsoft.com/appx/manifest/desktop/windows10/7
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
uap11 http://schemas.microsoft.com/appx/manifest/uap/windows10/11
минимальная версия ОС

Замечания

Если атрибуты сведений о активации не указаны Extension, они наследуются от родительского Applicationэлемента. См. раздел примечаний Application для элемента.

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

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

Note

Атрибут EntryPoint или StartPage, если Атрибут< > или для версий Windows 10 до Windows 10 версии 1607. Начиная с Windows 10, версии 1607 больше не нужно указывать значение для EntryPoint или StartPage при Categorywindows.Use, UpdateTask или windows.preInstalledConfigTask для целевых устройств, работающих Windows 10, версия 1607 или более поздняя.

Примеры

См. также

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