desktop:Extension

  • Статья

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

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

<Пакет>

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

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

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

                   <\Desktop:Extension>

Синтаксис

<desktop:Extension
  Category = 'A string value that can be one of the following values: "windows.fullTrustProcess", "windows.startupTask", "windows.toastNotificationActivation", or "windows.searchProtocolHandler".'
  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 *.'
  ResourceGroup =  'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  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 with a value between 1 and 255 characters in length. Must begin with an alphabetic character.'
  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.'
  previewappcompat:CompatMode = 'An optional string that can have one of the following values: "classic" or "modern".'
  previewappcompat:Scope = 'An optional string that can be one of the following values: "user" or "machine".'
  uap11:Id = 'An optional string with a value between 1 and 256 characters in length.'
  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 with a value between 1 and 256 characters in length 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 = 'A string that can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'A string that can have one of the following values: "machine" or "user".' >

  <!-- Child elements -->
  desktop:FullTrustProcess?
  desktop:StartupTask?
  desktop:ToastNotificationActivation?
  desktop:SearchProtocolHandler?

</desktop:Extension>

Ключ

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

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

Атрибуты

Атрибут Описание Тип данных Обязательно Значение по умолчанию
Категория Категория расширения. Строковое значение, которое может быть одним из следующих значений: windows.fullTrustProcess, windows.startupTask, windows.toastNotificationActivation или windows.searchProtocolHandler. Да
Исполняемый объект Исполняемый файл запуска по умолчанию. Необязательная строка со значением длиной от 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 символов в длину с символом, не являющиеся пробелами, в начале и конце. Нет
uap11:Id Идентификатор расширения. Идентификатор должен быть уникальным для всех расширений в пакете. Необязательная строка со значением от 1 до 255 символов в длину с символом без пробелов в начале и конце. Нет
uap11:Subsystem Этот атрибут наследуется от базового синтаксиса расширения и неприменим к расширению com4. Кроме синтаксической проверки, это значение игнорируется. Необязательная строка, которая может иметь одно из следующих значений: консоль или окна. Нет
uap11:SupportsMultipleInstances Указывает, должны ли экземпляры выполняться в разных процессах. Значением по умолчанию является false. Необязательное логическое значение. Нет
uap11:ResourceGroup Тег, который можно использовать для группирования активаций расширений в целях управления ресурсами (например, ЦП и памяти). Значение ResourceGroup можно задать в свободной форме и является гибким. См . Application@ResourceGroup. Необязательная буквенно-цифровая строка со значением от 1 до 255 символов. Должен начинаться с буквы. Нет
uap11:CurrentDirectoryPath Указывает начальный каталог при запуске процесса приложения. Необязательная строка, которая не может содержать следующие символы: <, >, |, ?или *. > Нет
uap11:Parameters Этот атрибут наследуется от базового синтаксиса расширения и неприменим к расширению com4. Кроме синтаксической проверки, это значение игнорируется. Необязательная строка со значением от 1 до 32767 символов в длину с символом, не являющиеся пробелами, в начале и конце. Нет
desktop7:CompatMode Указывает, регистрируются ли сведения этого расширения в Windows классическими способами (например, неупакованные приложения регистрируют типы в COM через реестр) или новыми способами с более ограниченной областью. Значение по умолчанию — modern. CompatMode="classic" требует возможности Microsoft.classicAppCompat_8wekyb3d8bbwe . Необязательная строка может иметь одно из следующих значений: classic или modern. Нет
desktop7:Scope Указывает, видны ли регистрации только другим приложениям, работающим от имени пользователя, у которого зарегистрирован этот пакет (пользователь), или они видны всем пользователям и службам на компьютере (компьютере). Значение по умолчанию — user. Scope="machine" требует возможности Microsoft.classicAppCompatElevated_8wekyb3d8bbwe . Необязательная строка, которая может иметь одно из следующих значений: machine или user. Нет

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

Дочерний элемент Описание
FullTrustProcess Представляет классический процесс, который выполняется в режиме полного доверия.
StartupTask Представляет классический процесс, выполняемый во время запуска приложения.
ToastNotificationActivation Позволяет получать всплывающие уведомления в приложении.
SearchProtocolHandler Представляет классический процесс, обрабатывающий протокол поиска для приложения.

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

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

Remarks

Требования

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