uap3:AppExtension

Artículo
11/11/2023

Declara un punto de extensibilidad de la aplicación de tipo windows.appExtension. Este elemento indica las categorías de extensiones que la aplicación pretende consumir o hospedar.

Jerarquía de elemento

<uap3:Extension>

<uap3:AppExtension>

Syntax

<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>

Clave

? opcional (cero o uno)

Atributos y elementos

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio
Descripción	Descripción de la aplicación	Cadena entre 1 y 2048 caracteres de longitud.	No
DisplayName	Nombre descriptivo de la extensión de la aplicación que se puede mostrar a los usuarios.	Cadena con un valor entre 1 y 256 caracteres de longitud.	Sí
Id	Punto de entrada por el que la aplicación host accede a la instancia de categoría de extensión, si hay varios puntos de entrada.	Cadena con un valor entre 2 y 39 caracteres de longitud que consta de caracteres alfanuméricos, puntos (excepto el primer carácter) y guiones solo.	Sí
Nombre	Tipo de extensión que la aplicación pretende consumir o hospedar.	Cadena con un valor entre 2 y 255 caracteres de longitud que consta de caracteres alfanuméricos, puntos (excepto el primer carácter) y guiones únicamente.	Sí
PublicFolder	Carpeta que la instancia declara como la ubicación donde un host puede tener acceso de lectura a los archivos a través de un agente.	Cadena con un valor entre 1 y 256 caracteres de longitud que no puede contener estos caracteres: `<`, , `>`, `":\|`, `?`, o .`*`	Sí

Elementos secundarios

Elemento secundario	Descripción
uap3:Properties	Contiene XML opaco que representa información personalizada y específica de la extensión que simplemente se almacena y no lee el sistema operativo. La aplicación host solo lee la información.

Elementos primarios

Elemento primario	Descripción
uap3:Extension	Declara un punto de extensibilidad para la aplicación.

Ejemplos

En el ejemplo siguiente se indica que la aplicación hospeda o consume la extensión del explorador de bajo rendimiento.

<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>

Requisitos

Elemento	Value
Espacio de nombres	`http://schemas.microsoft.com/appx/manifest/uap/windows10/3`
Minimum OS Version	Windows 10 versión 1607 (compilación 14393)