uap3:AppExtension

Статья
10/30/2023

Объявляет точку расширяемости приложения типа windows.appExtension. Этот элемент указывает, какие категории расширений приложение намерено использовать и (или) размещать.

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

<uap3:AppExtension>

Синтаксис

<uap3:AppExtension
    Name = 'A string with a value between 2 and 255 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only.'
    Id = 'A string with a value between 2 and 39 characters in length that consists of alphanumeric characters, periods (except for the first character), and dashes only.'
    PublicFolder = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.'
    DisplayName = 'A string with a value between 1 and 256 characters in length.'
    Description = 'A string between 1 and 2048 characters in length.' >

  <!-- Child elements -->
  uap3:Properties?

</uap3:AppExtension>

Ключ

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

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

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
Описание	Описание приложения	Строка длиной от 1 до 2048 символов.	Нет
Отображаемое имя	Понятное имя расширения приложения, которое может отображаться для пользователей.	Строка со значением от 1 до 256 символов в длину.	Да
Id	Точка входа, с помощью которой ведущее приложение обращается к экземпляру категории расширения, если имеется несколько точек входа.	Строка со значением от 2 до 39 символов в длину, состоящая из буквенно-цифровых символов, точек (за исключением первого) и только дефисов.	Да
имя;	Тип расширения, которое приложение намерено использовать и (или) узел.	Строка со значением от 2 до 255 символов в длину, состоящая из буквенно-цифровых символов, точек (за исключением первого символа) и только дефисов.	Да
PublicFolder	Папка, объявленная экземпляром в качестве расположения, в котором узел может иметь доступ на чтение к файлам через брокер.	Строка со значением от 1 до 256 символов, которая не может содержать следующие символы: `<`, `>`, `:`, `"`, `\|`, `?`или `*`.	Да

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

Дочерний элемент	Описание
uap3:Properties	Содержит непрозрачный XML-код, представляющий пользовательские сведения о расширении, которые просто хранятся и не считываются операционной системой. Сведения считываются только ведущим приложением.

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

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

Примеры

В следующем примере показано, что приложение размещает или использует расширение браузера с низкой производительностью.

<Package
    xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"  
    IgnorableNamespaces="... uap3">
    <Applications>
        <Application>
            <Extensions>
                <uap3:Extension 
                    Category="windows.appExtension">  
                    <uap3:AppExtension
                        Name="com.microsoft.browser.ext"
                        Id="Extension.Low.Performance"
                        PublicFolder="public\lowperf"
                        DisplayName="Low Performance Extension"/>  
                </uap3:Extension>  
              </Extensions>
        </Application>
    </Applications>
</Package>

Требования

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