Расширение (в application/Extensions) (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 не указано, используется точка входа, определенная для приложения. Нет
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 символов длиной с символом без пробелов в начале и конце. Нет

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

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

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

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

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

Remarks

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

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

Примечание

Атрибут EntryPoint или StartPage является обязательным, если атрибут Category имеет или windows.UpdateTaskwindows.preInstalledConfigTask для версий Windows 10 до Windows 10 версии 1607. Начиная с Windows 10 версии 1607, больше не нужно указывать значение для EntryPoint или StartPage, если параметр Category имеет 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