Расширение (в приложении/расширениях) (Windows 10)

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

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

<Пакет>

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

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

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

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

Синтаксис

<Extension
  Category = 'One of the following values: "windows.backgroundTasks", "windows.preInstalledConfigTask", "windows.updateTask", or "windows.restrictedLaunch".'
  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.'
/>

  <!-- Child elements -->
  BackgroundTasks?

</Extension>

Ключ

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

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

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
Категория Тип точки расширяемости пакета. Может иметь одно из следующих значений: windows.backgroundTasks, windows.preInstalledConfigTask, windows.updateTask или windows.restrictedLaunch. Да
EntryPoint Идентификатор активируемого класса. Строка со значением от 1 до 256 символов в длину. Представляет задачу, обрабатыващую расширение (обычно это полное имя пространства имен среда выполнения Windows типа). Если entryPoint не указан, вместо этого используется точка EntryPoint, определенная для приложения. Нет
Исполняемый объект Исполняемый файл запуска по умолчанию. Строка со значением от 1 до 256 символов в длину, которая должна заканчиваться .exeна и не может содержать следующие символы: <, >, :, ", |, ?или *. Указывает исполняемый файл по умолчанию для расширения. Если значение не указано, используется исполняемый файл, определенный для приложения. Если указано, также используется свойство EntryPoint. Если это свойство EntryPoint не указано, используется точка входа, определенная для приложения. Нет
Тип среды выполнения Поставщик среды выполнения. Обычно используется при наличии смешанных платформ в приложении. Строка со значением длиной от 1 до 255 символов, которая не может начинаться или заканчиваться . символом или содержит символы: <, >, :, ", |?или *. Нет
StartPage Веб-страница, обрабатывающая точку расширения. Строка со значением от 1 до 256 символов в длину, которая не может содержать следующие символы: <, >, :, ", |?, или *. Нет
ResourceGroup Необязательный тег, используемый для группирования активаций расширений в целях управления ресурсами (например, ЦП и память). См. раздел Примечания в Application@ResourceGroup. Буквенно-цифровая строка длиной от 1 до 255 символов. Должен начинаться с буквы. Нет
uap10:TrustLevel Указывает уровень доверия расширения. Необязательное строковое значение. Если он указан, это может быть одно из следующих значений: appContainer или mediumIL. Нет
uap10:RuntimeBehavior Указывает поведение расширения в среде выполнения.

Дополнительные сведения и требования смuap10:RuntimeBehavior. в разделе об элементе Application (Windows 10).
Необязательное строковое значение. Если этот параметр указан, это может быть одно из следующих значений: packagedClassicApp, win32App или windowsApp. Нет
uap10:HostId Указывает идентификатор среды выполнения узла для расширения. Буквенно-цифровая строка с необязательным значением длиной от 1 до 255 символов. Должен начинаться с буквы. Нет
uap10:Parameters Содержит параметры командной строки для передачи в расширение. Поддерживается только для классических приложений. Строка со значением от 1 до 32767 символов в длину с символом, не являющиеся пробелами, в начале и конце. Нет

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

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

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

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

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

Комментарии

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

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

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

Примечание

Атрибут EntryPoint или StartPage является обязательным, если атрибут Category имеет значение windows.UpdateTask или windows.preInstalledConfigTask для версий Windows 10 до Windows 10 версии 1607. Начиная с Windows 10 версии 1607, вам больше не нужно указывать значение для EntryPoint или StartPage, если категория имеет значение windows.Use, UpdateTask или windows.preInstalledConfigTask только для устройств под управлением Windows 10 версии 1607 или более поздней.

См. также раздел

Основные понятияКонтракты и расширения приложений

Требования

Элемент Значение
Пространство имен http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10