Extensión (en Application/Extensions) (Windows 10)
Declara un punto de extensibilidad para el paquete.
Jerarquía de elemento
<Extensión>
Syntax
<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>
Clave
? opcional (cero o uno)
Atributos y elementos
Atributos
| Atributo | Descripción | Tipo de datos | Obligatorio | Valor predeterminado |
|---|---|---|---|---|
| Categoría | Tipo de punto de extensibilidad del paquete. | Puede ser uno de los siguientes valores: windows.backgroundTasks, windows.preInstalledConfigTask, windows.updateTask o windows.restrictedLaunch. | Sí | |
| EntryPoint | Identificador de clase activable. | Cadena con un valor entre 1 y 256 caracteres de longitud. Representa la tarea que controla la extensión (normalmente el nombre completo del espacio de nombres de un tipo de Windows Runtime). Si no se especifica EntryPoint, en su lugar se usa entryPoint definido para la aplicación. | No | |
| Executable | Ejecutable de inicio predeterminado. | Cadena con un valor de entre 1 y 256 caracteres de longitud, que debe terminar con .exey no puede contener estos caracteres: <, >, :", |, , ?o *. Especifica el archivo ejecutable predeterminado para la extensión. Si no se especifica, se usa el archivo ejecutable definido para la aplicación. Si se especifica, también se usa la propiedad EntryPoint. Si no se especifica esa propiedad EntryPoint, se usa entryPoint definido para la aplicación. |
No | |
| RuntimeType | Proveedor en tiempo de ejecución. Normalmente se usa cuando hay marcos mezclados en una aplicación. | Cadena con un valor de entre 1 y 255 caracteres de longitud que no puede iniciar o terminar con un . o contener caracteres: <, >:|", ?o .* |
No | |
| StartPage | La página web que administra el punto de extensibilidad. | Cadena con un valor entre 1 y 256 caracteres de longitud que no puede contener estos caracteres: <, , >, ":|, ?, o .* |
No | |
| ResourceGroup | Etiqueta opcional que se usa para agrupar activaciones de extensión para fines de administración de recursos (por ejemplo, CPU y memoria). Consulte la sección Comentarios en Application@ResourceGroup. | Cadena alfanumérica entre 1 y 255 caracteres de longitud. Debe comenzar con una letra. | No | |
| uap10:TrustLevel | Especifica el nivel de confianza de la extensión. | Valor de cadena opcional. Si se especifica, puede ser uno de los siguientes valores: appContainer o mediumIL. | No | |
| uap10:RuntimeBehavior | Especifica el comportamiento en tiempo de ejecución de una extensión. Para obtener más información y requisitos, consulte uap10:RuntimeBehavior en el tema del elemento Application (Windows 10). |
Valor de cadena opcional. Si se especifica, puede ser uno de los siguientes valores: "packagedClassicApp", "win32App" o "windowsApp". | No | |
| uap10:HostId | Especifica el identificador del tiempo de ejecución del host para la extensión. | Cadena alfanumérica con un valor opcional entre 1 y 255 caracteres de longitud. Debe comenzar con una letra. | No | |
| uap10:Parameters | Contiene parámetros de línea de comandos que se van a pasar a la extensión. Solo se admite para aplicaciones de escritorio. | Cadena con un valor de entre 1 y 32767 caracteres de longitud con un carácter que no es de espacio en blanco al principio y al final. | No |
Elementos secundarios
| Elemento secundario | Descripción |
|---|---|
| BackgroundTasks | Define un punto de extensibilidad de la aplicación de tipo windows.backgroundTasks. Las tareas en segundo plano se ejecutan en un host en segundo plano dedicado; es decir, sin una interfaz de usuario. |
Elementos primarios
| Elemento primario | Descripción |
|---|---|
| Extensiones (tipo: CT_ApplicationExtensions) | Define uno o varios puntos de extensibilidad para la aplicación. |
Elementos relacionados
Los elementos siguientes tienen el mismo nombre que este, pero contenido o atributos diferentes:
Comentarios
Si no se especifican atributos de información de activación en Extensión, se heredan de la aplicación primaria. Consulte la sección comentarios del elemento Application .
Los puntos de extensibilidad son un mecanismo por el que un paquete puede agregar funcionalidad de una manera definida por el sistema operativo. Un punto de extensibilidad es una ubicación donde una aplicación puede registrarse para ejecutar código o usar recursos del paquete actual. Para agregar funcionalidad para una aplicación determinada, use el elemento secundario Application del elemento Applications .
El punto de extensibilidad windows.certificates no se puede declarar varias veces en un manifiesto.
Nota
El atributo EntryPoint o StartPage es necesario si el atributo Category es windows.UpdateTask o windows.preInstalledConfigTask para versiones de Windows 10 antes de Windows 10, versión 1607. A partir de Windows 10, versión 1607, ya no es necesario especificar un valor para EntryPoint o StartPage cuando Category es windows.Use, UpdateTask o windows.preInstalledConfigTask solo los dispositivos que ejecutan Windows 10, versión 1607 o posterior.
Consulte también
Conceptos Contratosy extensiones de aplicaciones
Requisitos
| Elemento | Value |
|---|---|
| Espacio de nombres | http://schemas.microsoft.com/appx/manifest/foundation/windows10 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |