Aplicación (Windows 10)

Representa una aplicación que consta de parte o de toda la funcionalidad que se entrega en el paquete.

Jerarquía de elemento

<Paquete>

    <APLICACIONES>

         <Application>

Syntax

<Application
  EntryPoint? = 'See the Attributes table for more info.'
  Executable?
  uap10:HostId?
  Id
  uap10:Parameters?
  ResourceGroup?
  uap10:RuntimeBehavior?
  StartPage?
  desktop4:Subsystem?
  uap10:Subsystem?
  desktop4:SupportsMultipleInstances?
  uap10:SupportsMultipleInstances?
  uap10:TrustLevel?
  uap16:BaseNamedObjectsIsolation?
  uap17:BaseNamedObjectsIsolation?
  desktop11:AppLifecycleBehavior?

  <!-- Child elements -->
  uap:ApplicationContentUriRules?
  Extensions?
  uap7:Properties
  uap:VisualElements

</Application>

Clave

? opcional (cero o uno)
& intercalar conector (puede producirse en cualquier orden)

Atributos y elementos

Atributos

Atributo	Descripción	Tipo de datos	Obligatorio	Valor predeterminado
EntryPoint	Identificador de clase activable (por ejemplo, "Office.Winword.Class"), o "windows.fullTrustApplication" o "windows.partialTrustApplication". Si especifica EntryPoint, también debe especificar el atributo Ejecutable . Si especifica EntryPoint, no debe especificar el atributo StartPage .	Cadena entre 1 y 256 caracteres de longitud, que representa la tarea que controla la extensión. Normalmente es el nombre completo del espacio de nombres de un tipo de Windows Runtime; pero puede ser uno de los valores especiales "windows.fullTrustApplication" o "windows.partialTrustApplication". Si no se especifica EntryPoint, se usa en su lugar entryPoint definido para la aplicación.	No
Executable	Ejecutable de inicio predeterminado para la aplicación. El archivo especificado debe estar presente en el paquete. En sistemas antiguos (vea la sección comentarios para obtener más información), si especifica Ejecutable, también debe especificar el atributo EntryPoint . Si especifica Ejecutable, no debe especificar el atributo StartPage .	Cadena entre 1 y 256 caracteres de longitud que debe terminar con .exe y no puede contener estos caracteres: <, >, :, ", |, ?o *.	No
uap10:HostId	El identificador de aplicación de la aplicación host para la aplicación actual. Este atributo se usa para las aplicaciones hospedadas.	Cadena alfanumérica entre 1 y 255 caracteres de longitud. Debe comenzar con una letra.	No
Id	Identificador único de la aplicación dentro del paquete. Este valor se conoce a veces como el identificador de aplicación relativa del paquete (PRAID). El identificador es único dentro del paquete, pero no globalmente. Puede haber otro paquete en el sistema que utilice el mismo identificador. No se puede usar el mismo identificador más de una vez en el mismo paquete. Cuando se usa una plantilla de Visual Studio, el valor predeterminado de este atributo es App. Los desarrolladores deben cambiarlo manualmente en el manifiesto. El identificador de la aplicación no debe cambiarse después de que la aplicación se haya publicado en Microsoft Store; si lo hace, se interrumpirá la posición del icono en la pantalla Inicio.	Cadena ASCII entre 1 y 64 caracteres de longitud. Esta cadena contiene campos alfanuméricos separados por puntos. Cada campo debe empezar por un carácter alfabético ASCII. No se pueden usar como valores de campo: CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 y LPT9.	Sí
uap10:Parameters	Contiene parámetros de línea de comandos para pasar a la aplicación. Solo se admite para aplicaciones de escritorio que tienen identidad de paquete (consulte Introducción a la implementación).	Cadena de entre 1 y 32767 caracteres de longitud con un carácter de espacio no en blanco al principio y al final.	No
ResourceGroup	Etiqueta que se usa para agrupar activaciones de extensión con 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:RuntimeBehavior	Especifica el comportamiento en tiempo de ejecución de la aplicación. "packagedClassicApp": una aplicación WinUI 3 o una aplicación de Puente de dispositivo de escritorio (Centennial). Para una aplicación winUI 3, normalmente va con trustLevel de "mediumIL" (pero "appContainer" también es una opción). "win32App": cualquier otro tipo de aplicación Win32, incluida una aplicación empaquetada con ubicación externa. Normalmente va con trustLevel de "mediumIL" (pero "appContainer" también es una opción). "windowsApp": una aplicación Plataforma universal de Windows (UWP). Siempre va con trustLevel de "appContainer". Todas comparten propiedades comunes (algunas declaradas en appxmanifest.xml) y se ejecutan como un proceso con identidad de paquete e identidad de aplicación. Puede considerarlos como en dos grupos. Un grupo es aplicaciones para UWP ("windowsApp"); el otro es Windows .exes con main o WinMain ("packagedClassicApp" o "win32App"). Ese segundo grupo también se conoce como aplicaciones de escritorio.	Cadena con uno de los valores siguientes: "packagedClassicApp", "win32App" o "windowsApp".	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 *. Cualquier URI o IRI válido (la versión no ASCII de un URI).	No
desktop4:Subsystem	Indica si la aplicación es una aplicación para UWP estándar o una aplicación de consola para UWP.	Cadena que puede ser cualquiera de los valores siguientes: consola o ventanas.	No
uap10:Subsystem	Indica si la aplicación es una aplicación para UWP estándar o una aplicación de consola para UWP.	Cadena que puede ser cualquiera de los valores siguientes: consola o ventanas.	No
desktop4:SupportsMultipleInstances	Indica compatibilidad con varias instancias independientes de aplicaciones para UWP. Para obtener más información, consulta la sección comentarios.	Un valor booleano.	No
uap10:SupportsMultipleInstances	Indica compatibilidad con varias instancias independientes de aplicaciones para UWP. Para obtener más información, consulta la sección comentarios.	Un valor booleano.	No
uap10:TrustLevel	Especifica el nivel de confianza de la aplicación. "mediumIL"— la aplicación es de plena confianza; su proceso se ejecuta con un nivel de integridad de medio (consulte Control de integridad obligatoria). Necesita la funcionalidad restringida "Nivel de permiso de plena confianza" (consulte Declaraciones de funcionalidad de la aplicación). "appContainer": la aplicación se ejecuta en un contenedor de aplicaciones ligero (consulte Aplicaciones MSIX AppContainer); su proceso se ejecuta con un nivel de integridad bajo. También es posible que una aplicación desempaquetada se ejecute en un AppContainer.	Cadena con uno de los valores siguientes: "mediumIL" o "appContainer".	No
uap16:BaseNamedObjectsIsolation	Habilita el aislamiento de BaseNameObject (BNO) para la aplicación.	Cadena que puede ser cualquiera de los valores siguientes: package o none.	No
uap17:BaseNamedObjectsIsolation	Habilita el aislamiento de BaseNameObject (BNO) para la aplicación.	Cadena que puede ser cualquiera de los valores siguientes: package o none.	No
desktop11:AppLifecycleBehavior	Permite que una aplicación invalide el comportamiento del ciclo de vida asociado al comportamiento en tiempo de ejecución de la extensión. Las aplicaciones o extensiones con un runtimeBehavior de "windowsApp" tienen implícitamente AppLifecycleBehavior de "systemManaged" a menos que se especifique lo contrario. Las aplicaciones o extensiones con RuntimeBehavior de "packagedClassicApp" o "win32App" tienen implícitamente AppLifecycleBehavior de "no administrado" a menos que se especifique lo contrario.	Uno de los siguientes valores: "systemManaged", "no administrado".	No

Elementos secundarios

Elemento secundario	Descripción
uap:ApplicationContentUriRules	Especifica qué páginas del contexto web tienen acceso a los dispositivos de geolocalización del sistema (si la aplicación tiene permiso para acceder a esta funcionalidad) y el acceso al Portapapeles.
Extensiones (tipo: CT_ApplicationExtensions)	Define uno o varios puntos de extensibilidad para la aplicación.
uap7:Properties	Especifica las propiedades de la aplicación.
uap:VisualElements	Describe los aspectos visuales de la aplicación: su icono predeterminado, imágenes de logotipo, texto y colores de fondo, orientación inicial de la pantalla, pantalla de presentación y apariencia del icono de la pantalla de bloqueo.

Elementos primarios

Elemento primario	Descripción
Aplicaciones	Representa una o varias aplicaciones que componen el paquete.

Comentarios

El elemento Application contiene atributos comunes a los puntos de extensibilidad que pertenecen a la aplicación. Otros puntos de extensibilidad usan esta información para obtener información sobre la aplicación. Los atributos de aplicación también se usan como información de activación en el inicio y la administración de una instancia de la aplicación (es decir, describen cómo iniciar un proceso y con qué comportamiento).

El atributo StartPage solo se aplica a las aplicaciones de JavaScript. Si no se especifica StartPage , se deben especificar los atributos Ejecutable y EntryPoint (y que solo se aplican a las aplicaciones de C#, C++o VB).

uap10 se introdujo en Windows 10, versión 2004 (10.0; Compilación 19041)

El uap10 espacio de nombres (para uap10:RuntimeBehavior y uap10:TrustLevel) se introdujo en Windows 10, versión 2004 (10.0; Compilación 19041). Si el paquete se instala en sistemas anteriores a eso, debe proporcionar una combinación equivalente de atributos (consulte la sección siguiente), de lo contrario, la información de activación estará incompleta y se producirá un error en la instalación.

Pero si el paquete tiene <TargetDeviceFamily MinVersion="10.0.19041.0">, o superior, solo se instala en sistemas que admiten el uap10 espacio de nombres . En ese caso, debe usar los uap10:RuntimeBehavior atributos y uap10:TrustLevel en preferencia para las combinaciones equivalentes anteriores (consulte la sección siguiente).

Combinaciones de atributos de información de activación

Puede especificar atributos de información de activación en el elemento Application ; y, opcionalmente, puede especificarlos en un elemento Extension de ámbito de aplicación. Si no se especifican en extensión, se heredan de la aplicación primaria. Estos atributos se especifican en combinaciones; por ejemplo, EntryPoint, RuntimeBehavior y TrustLevel tienen un significado superpuesto y se especifican (o se heredan) en combinaciones. Estas son algunas combinaciones válidas de atributos de información de activación.

1. Ejecutable, uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel=["mediumIL" o "appContainer" (valor predeterminado si se omite)]
2. Ejecutable, uap10:RuntimeBehavior="win32App", uap10:TrustLevel="mediumIL" (para otros requisitos, vea la Descripción anterior en este tema para uap10:RuntimeBehavior).
3. Ejecutable, EntryPoint="windows.fullTrustApplication" (equivalente a uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="mediumIL")
4. Ejecutable, EntryPoint="windows.partialTrustApplication" (equivalente a uap10:RuntimeBehavior="packagedClassicApp", uap10:TrustLevel="appContainer")
5. Ejecutable, EntryPoint="<cualquier otra cosa>"

Como puede ver, si el sistema de destino no admite el uap10 espacio de nombres, puede especificar el atributo EntryPoint en su lugar. Del mismo modo, el equivalente de uap10:TrustLevel="appContainer"' en sistemas anteriores es EntryPoint="windows.partialTrustApplication".

Es redundante especificar uap10:RuntimeBehavior/uap10:TrustLevel y EntryPoint al mismo tiempo, pero, si lo hace, se trata de un error si se contradecen.

las activaciones de aplicaciones de Plataforma universal de Windows (UWP) requieren EntryPoint. Por lo tanto, si especifica Ejecutable y uap10:RuntimeBehavior="windowsApp" (sin EntryPoint), se producirá un error. En este mismo caso, EntryPoint especificaría algo distinto de "windows.fullTrustApplication" y "windows.partialTrustApplication"; y valores distintos de los dos ya dicen lo mismo que uap10:RuntimeBehavior="windowsApp". Por lo tanto , uap10:RuntimeBehavior sería redundante en este caso y especificaría Ejecutable y EntryPoint.

No se admite la configuración de uap10:RuntimeBehavior="win32App" y uap10:TrustLevel="appContainer".

Establecer uap10:TrustLevel="mediumIL" mientras uap10:RuntimeBehavior="windowsApp" requiere la Microsoft.coreAppActivation_8wekyb3d8bbwe funcionalidad personalizada.

Esto también es true si uap10:TrustLevel="mediumIL" y EntryPoint es cualquier otro valor que no sea "windows.fullTrustApplication" o "windows.partialTrustApplication".

Puede obtener más información sobre esta funcionalidad personalizada aquí en Funcionalidades personalizadas.

Notas importantes sobre las aplicaciones de instancias múltiples

• Si una aplicación declara SupportsMultipleInstances dentro del elemento Application , todas las extensiones en primer plano también serán multiinstancia.
• Si la aplicación declara SupportsMultipleInstances dentro del elemento Application , no es necesario declararla en el nivel Extensiones (por ejemplo, en un elemento BackgroundTasks o AppService ).
• La aplicación solo debe declarar SupportsMultipleInstances en tareas en segundo plano, audio en segundo plano o servicios de aplicaciones.
• Las aplicaciones de consola siempre serán de instancias múltiples y deben declarar explícitamente SupportsMultipleInstances.
• Las aplicaciones pueden usar la declaración ResourceGroup en el manifiesto para agrupar varias tareas en segundo plano en el mismo host. Esto entra en conflicto con la creación de instancias múltiples, donde cada activación entra en un host independiente. Por lo tanto, una aplicación no puede declarar supportsMultipleInstances y ResourceGroup en el manifiesto.

Para obtener más información sobre el uso del atributo SupportsMultipleInstances para admitir varias instancias independientes de aplicaciones para UWP, consulta Crear una aplicación universal de Windows de varias instancias.

Requisitos

Elemento	Value
Espacio de nombres	http://schemas.microsoft.com/appx/manifest/uap/windows10
atributos desktop4	http://schemas.microsoft.com/appx/manifest/desktop/windows10/4
Atributos uap10	http://schemas.microsoft.com/appx/manifest/uap/windows10/10