uap:Extension (Windows 10)
Declara un punto de extensibilidad para la aplicación.
Jerarquía de elemento
<uap:Extension>
Syntax
<uap:Extension
Category = 'A string that can have one of the following values: "windows.fileTypeAssociation", "windows.protocol", "windows.autoPlayContent", "windows.autoPlayDevice", "windows.shareTarget", "windows.search", "windows.fileOpenPicker", "windows.fileSavePicker", "windows.cachedFileUpdater", "windows.cameraSettings", "windows.accountPictureProvider", "windows.printTaskSettings", "windows.lockScreenCall", "windows.appointmentsProvider", "windows.alarm", "windows.webAccountProvider", "windows.dialProtocol", "windows.appService", "windows.mediaPlayback", "windows.print3DWorkflow", "windows.lockScreen", "windows.aboveLockScreen", "windows.personalAssistantLaunch", or "windows.voipCall".'
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.'
uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
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 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 = 'An optional string the can have one of the following values: "classic" or "modern".'
desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".' >
<!-- Child elements -->
uap:FileTypeAssociation?
uap:Protocol?
uap:AutoPlayContent?
uap:AutoPlayDevice?
uap:ShareTarget?
uap:FileOpenPicker?
uap:FileSavePicker?
uap:AppointmentsProvider?
uap:WebAccountProvider?
uap:DialProtocol?
uap:AppService?
uap:MediaPlayback?
uap:VoipCall?
</uap: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. | Cadena que puede tener uno de los siguientes valores: windows.fileTypeAssociation, windows.protocol, windows.autoPlayContent, windows.autoPlayDevice, windows.shareTarget, windows.search, windows.fileOpenPicker, windows.fileSavePicker, windows.cachedFileUpdater, windows.cameraSettings, windows.accountPictureProvider, windows.printTaskSettings, windows.lockScreenCall, windows.appointmentsProvider, windows.alarm, windows.webAccountProvider, windows.dialProtocol, windows.appService, windows.mediaPlayback, windows.print3DWorkflow, windows.lockScreen, windows.aboveLockScreen, windows.personalAssistantLaunch o windows.voipCall. | 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. | Valor de cadena opcional. Si se especifica, puede ser uno de los siguientes valores: windowsApp, packagedClassicApp o win32App. | 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 | |
| uap11:Id | Identificador de la extensión. El identificador debe ser único para todas las extensiones de un paquete. | Cadena opcional con un valor entre 1 y 255 caracteres de longitud con un carácter de espacio no en blanco al principio y al final. | No | |
| uap11:Subsystem | Este atributo se hereda de la sintaxis de extensión base y no es aplicable a la extensión com4. Aparte de la validación sintáctica, este valor se omite. | Cadena opcional que puede tener uno de los siguientes valores: consola o ventanas. | No | |
| uap11:SupportsMultipleInstances | Especifica si las instancias deben ejecutarse en procesos diferentes. El valor predeterminado es false. | Valor booleano opcional. | No | |
| uap11:ResourceGroup | Etiqueta que puede usar para agrupar activaciones de extensión con fines de administración de recursos (por ejemplo, CPU y memoria). El valor que puede establecer ResourceGroup es de forma libre y flexible. Consulte Application@ResourceGroup. | Cadena alfanumérica opcional con un valor entre 1 y 255 caracteres de longitud. Debe comenzar con una letra. | No | |
| uap11:CurrentDirectoryPath | Especifica el directorio inicial cuando se inicia el proceso de aplicación. Este atributo admite macros. Para obtener más información, consulta Macros en el esquema del manifiesto del paquete. | Cadena opcional que no puede contener estos caracteres: <, >, |, ?o *. > |
No | |
| uap11:Parameters | Este atributo se hereda de la sintaxis de la extensión base y no es aplicable a la extensión com4. Aparte de la validación sintáctica, se omite este valor. Este atributo admite macros. Para obtener más información, consulta Macros en el esquema del manifiesto del paquete. | Cadena opcional con un valor entre 1 y 32767 caracteres de longitud con un carácter que no es de espacio en blanco al principio y al final. | No | |
| desktop7:CompatMode | Especifica si la información de esta extensión se registra con Windows de maneras clásicas (por ejemplo, los tipos de registro de aplicaciones sin empaquetar con COM a través del Registro) o de nuevas formas más limitadas. El valor predeterminado es "modern". CompatMode="classic" requiere la funcionalidad Microsoft.classicAppCompat_8wekyb3d8bbwe . | Una cadena opcional puede tener uno de los siguientes valores: clásico o moderno. | No | |
| desktop7:Scope | Especifica si los registros solo son visibles para otras aplicaciones que se ejecutan como un usuario que tiene este paquete registrado (usuario), o si son visibles para todos los usuarios y servicios del equipo (máquina). El valor predeterminado es "user". Scope="machine" requiere la funcionalidad Microsoft.classicAppCompatElevated_8wekyb3d8bbwe . | Cadena opcional que puede tener uno de los siguientes valores: máquina o usuario. | No |
Elementos secundarios
| Elemento secundario | Descripción |
|---|---|
| uap:AppService | Declara un punto de extensibilidad de la aplicación de tipo windows.appService. Los contratos de aplicación son una manera de que una aplicación invoque una tarea en segundo plano que pertenezca a otra aplicación; o para una tarea en segundo plano invocada para dar servicio a un contrato de aplicación, una manera de comunicarse con su llamador. |
| uap:AppointmentsProvider | Declara un punto de extensibilidad de la aplicación de tipo windows.appointmentsProvider. |
| uap:AutoPlayContent | Declara un punto de extensibilidad de la aplicación de tipo windows.autoPlayContent. La aplicación proporciona las acciones de contenido de Reproducción automática especificadas. |
| uap:AutoPlayDevice | Declara un punto de extensibilidad de la aplicación de tipo *windows.autoPlayDevice. La aplicación proporciona las acciones de dispositivo de Reproducción automática especificadas. |
| uap:DialProtocol | Declara un punto de extensibilidad de la aplicación de tipo windows.dialProtocol*. |
| uap:FileOpenPicker | Declara un punto de extensibilidad de la aplicación de tipo windows.fileOpenPicker. La aplicación permite al usuario elegir y abrir los tipos de archivos especificados. |
| uap:FileSavePicker | Declara un punto de extensibilidad de la aplicación de tipo windows.fileSavePicker. La aplicación permite al usuario elegir el nombre de archivo, la extensión y la ubicación de almacenamiento para los tipos de archivos especificados. |
| uap:FileTypeAssociation | Declara un punto de extensibilidad de la aplicación de tipo windows.fileTypeAssociation. Una asociación de tipo de archivo indica que la aplicación está registrada para controlar los archivos de los tipos especificados. |
| uap:MediaPlayback | Declara un punto de extensibilidad de la aplicación de tipo mediaPlayback para que la aplicación pueda declarar que realiza la transcodificación de vídeo. |
| uap:Protocol | Declara un punto de extensibilidad de la aplicación de tipo windows.protocol. Una asociación de URI indica que la aplicación está registrada para controlar los URI con el esquema especificado. |
| uap:ShareTarget | Declara un punto de extensión de aplicación de tipo windows.shareTarget. La aplicación puede compartir los tipos de archivos especificados. |
| uap:VoipCall | Declara un punto de extensibilidad de la aplicación de tipo windows.voipCall para que la aplicación pueda declarar que puede realizar una actualización desde una llamada de telefonía móvil a una llamada de vídeo VoIP o si es una aplicación VoIP que admite la marcación de números de teléfono directamente. |
| uap:WebAccountProvider | Declara un punto de extensibilidad de la aplicación de tipo windows.webAccountProvider. |
Elementos primarios
| Elemento primario | Descripción |
|---|---|
| Extensiones (type:CT_ApplicationExtensions) | Define uno o varios puntos de extensibilidad para la aplicación. |
Comentarios
Para la mayoría de los tipos de extensiones, Extension@ResourceGroup deben coincidir con Application@ResourceGroup (si se omite Application@ResourceGroup, también se debe omitir Extension@ResourceGroup).
Para un contrato basado en la interfaz de usuario: si no se especifica Extension@ResourceGroup, se agrupará implícitamente con la aplicación; si Extension@ResourceGroup no coincide con Application@ResourceGroup, el manifiesto producirá un error en la validación del esquema.
Si no se especifica Extension@ResourceGroup para una tarea en segundo plano o para un contrato basado en una tarea en segundo plano, se asociará a un grupo predeterminado para todas las tareas en segundo plano. Los contratos de tareas en segundo plano pueden especificar los mismos valores que Application@ResourceGroup.
En el caso de las extensiones siguientes, Extension@ResourceGroup permite agrupar la tarea en segundo plano en diferentes procesos que serán administrados por recursos y ciclo de vida independientemente de otros grupos: windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask y windows.updateTask.
Por ejemplo, si el manifiesto tenía estas tres entradas.
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" ResourceGroup="Group1">
<BackgroundTasks>
<Task Type="timer"/>
</BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask2" ResourceGroup="Group2">
<BackgroundTasks>
<Task Type="controlChannel"/>
</BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask3" ResourceGroup="Group2">
<BackgroundTasks>
<Task Type="pushNotification"/>
</BackgroundTasks>
</Extension>
A continuación, las dos últimas tareas en segundo plano se activarían en la misma instancia de backgroundtaskhost.exe si se activaran simultáneamente. Sin embargo, una instancia independiente de backgroundtaskhost.exe se iniciaría para la primera entrada porque tiene un resourceGroup diferente.
Si no se especifica ningún ResourceGroup para una extensión, todas las tareas en segundo plano se activan en la misma instancia de backgroundtaskhost.exe.
Además, si una de estas extensiones (windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask o windows.updateTask) especifica el mismo valor del atributo ResourceGroup del elemento Application primario que se activarán en el mismo proceso que la interfaz de usuario.
Las extensiones siguientes se pueden encontrar en la pestaña declaraciones de la interfaz de usuario del diseñador de paquetes; vea las descripciones de cada uno de estos elementos:
- Búsqueda: registra la aplicación como proveedor de búsqueda. El contenido indexado de la aplicación puede aparecer como resultados de búsqueda en la experiencia de búsqueda global iniciada a través del acceso Búsqueda. Solo se permite una instancia de esta declaración por aplicación.
- CachedFileUpdater: registra la aplicación como actualizador de archivos almacenados en caché, lo que permite a la aplicación proporcionar actualizaciones de archivos a los archivos a los que acceden otras aplicaciones de Microsoft Store. Solo se permite una instancia de esta declaración por aplicación.
- Configuración de la cámara: permite a la aplicación proporcionar paneles de control personalizados para dispositivos de cámara web. Solo se permite una instancia de esta declaración por aplicación.
- AccountPictureProvider: registra la aplicación como proveedor de imágenes de cuenta, lo que le permite iniciarse en un modo de imagen de cuenta y establecer la imagen del usuario sin preguntar más. Solo se permite una instancia de esta declaración por aplicación.
- PrintTaskSettings: permite a la aplicación reemplazar la experiencia básica de configuración de impresión. Solo se permite una instancia de esta declaración por aplicación.
- LockScreen: si un teléfono está bloqueado, hay una cantidad limitada de interacción que el usuario puede realizar. En algunos casos, un usuario desea poder responder a una llamada VoIP sin desbloquear el teléfono. Este contrato hace que sea posible. Solo se permite una instancia de esta declaración por aplicación.
- Alarma: una aplicación puede declararse como aplicación de alarma del sistema. Cuando un usuario pasa por la interfaz de usuario de selección para establecer su alarma del sistema, solo se pueden seleccionar las aplicaciones declaradas como Aplicaciones de alarma del sistema. Solo se permite una instancia de esta declaración por aplicación.
- BackgroundTasks: las tareas en segundo plano permiten a las aplicaciones comunicarse entre sí y permitir que una aplicación llame a otra. Para usar contratos para proporcionar o iniciar estas tareas en segundo plano, es necesario declarar una aplicación como un servicio de aplicaciones. Se permiten varias instancias de esta declaración en cada aplicación.
- Print3DWorkFlow: los fabricantes de impresoras 3D pueden proporcionar una aplicación universal de Windows para proporcionar una experiencia única en el cuadro de diálogo de impresión 3D. Si no lo hacen, Windows proporciona una experiencia de impresión 3D predeterminada. Solo se permite una instancia de esta declaración por aplicación.
- PersonalAssistantLaunch: permite que una aplicación se integre con Cortana. Solo se permite una instancia de esta declaración por aplicación.
Requisitos
| Elemento | Valor |
|---|---|
| rescap4 | http://schemas.microsoft.com/appx/manifest/uap/windows10 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| Minimum OS Version | Windows 10 versión 1511 (compilación 10586) |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de