Compartir a través de

Aplicación (Windows 10)

  • Artículo

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

Jerarquía de elementos

del paquete de

    <Applications>

         <Application>

Sintaxis

<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?
  uap11:CurrentDirectoryPath?
  uap11:Parameters?

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

</Application>

Llave

? opcional (cero o uno)
& conector de intercalación (puede producirse en cualquier orden)

Atributos y elementos

Atributos

Atributo Descripción Tipo de dato 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 de . 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
ejecutable Ejecutable de inicio predeterminado para la aplicación. El archivo especificado debe estar presente en el paquete. En sistemas anteriores (consulte la sección de comentarios para obtener más información), si especifica Ejecutable, también debe especificar el atributo EntryPoint. Si especifica ejecutable, debe no 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 Identificador de aplicación de la aplicación host para la aplicación actual. Este atributo se usa para aplicaciones hospedadas. Cadena alfanumérica entre 1 y 255 caracteres de longitud. Debe comenzar con una letra. No
id. de Identificador único de la aplicación dentro del paquete. Este valor se conoce a veces como identificador de aplicación relativa al paquete (PRAID). El identificador es único dentro del paquete, pero no globalmente. Puede haber otro paquete en el sistema que use 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 comenzar con 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, LPT8y 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 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 de 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 puente de escritorio (centennial). En el caso de una aplicación WinUI 3, normalmente va con un 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 y debe ir con un TrustLevel de "mediumIL".

"windowsApp": una aplicación para la Plataforma universal de Windows (UWP). Siempre va con un TrustLevel de "appContainer".

Todas comparten propiedades comunes (algunas declaradas en appxmanifest.xml) y se ejecutan como un proceso con la identidad del paquete y la identidad de la aplicación. Puede pensar en ellos como estar en dos grupos. Un grupo es aplicaciones para UWP ("windowsApp"); el otro es Windows .exes con principal o WinMain ("packagedClassicApp" o "win32App"). Ese segundo grupo también se conoce como aplicaciones de escritorio.		 Cadena con uno de los siguientes valores: "packagedClassicApp", "win32App" o "windowsApp". No
startPage de Página web que controla el punto de extensibilidad. Cadena con un valor de entre 1 y 256 caracteres que no pueden 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 siguientes valores: 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 siguientes valores: consola o ventanas. No
desktop4:SupportsMultipleInstances Indica la compatibilidad de varias instancias independientes de aplicaciones para UWP. Para obtener más información, consulta la sección comentarios. Valor booleano. No
uap10:SupportsMultipleInstances Indica la compatibilidad de varias instancias independientes de aplicaciones para UWP. Para obtener más información, consulta la sección comentarios. Valor booleano. No
uap10:TrustLevel Especifica el nivel de confianza de la aplicación.

"mediumIL": la aplicación se plena confianza; su proceso se ejecuta con un nivel de integridad de medio (consulte control de integridad obligatoria). Necesita la funcionalidad restringida "Nivel de permisos de plena confianza" (consulte Declaraciones de funcionalidad de la aplicación).

"appContainer": la aplicación se ejecuta en un contenedor ligero de aplicaciones (consulte aplicaciones msix appContainer); su proceso se ejecuta con un nivel de integridad de baja. También es posible que una aplicación desempaquetada se ejecute en un AppContainer.		 Cadena con uno de los siguientes valores: "mediumIL" o "appContainer". No
uap16:BaseNamedObjectsIsolation Habilita el aislamiento de BaseNameObject (BNO) para la aplicación. Cadena que puede ser cualquiera de los siguientes valores: paquete o ninguno. No
uap17:BaseNamedObjectsIsolation Habilita el aislamiento de BaseNameObject (BNO) para la aplicación. Cadena que puede ser cualquiera de los siguientes valores: paquete o ninguno. 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" implícitamente tienen AppLifecycleBehavior de "no administrado" a menos que se especifique lo contrario. Uno de los siguientes valores: "systemManaged", "no administrado". 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 de 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, este valor se omite. Este atributo admite macros. Para obtener más información, consulta Macros en el esquema de manifiesto del paquete. Cadena opcional con un valor entre 1 y 32767 caracteres de longitud con un carácter de espacio no en blanco al principio y al final. 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 de (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, colores de texto y fondo, orientación inicial de la pantalla, pantalla de presentación y apariencia del icono de pantalla de bloqueo.

Elementos primarios

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

Observaciones

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. atributos de Application 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 tanto el ejecutable de como los atributos 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 espacio de nombres uap10 (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, se instala solo en sistemas que admiten el espacio de nombres uap10. En ese caso, debe usar los atributos uap10:RuntimeBehavior y uap10:TrustLevel en preferencia a 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 de extensión extensión. Si no se especifican en extensión, se heredan del primario Application. Estos atributos se especifican en combinaciones( por ejemplo, EntryPoint, RuntimeBehaviory TrustLevel tienen significado superpuesto y se especifican (o 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" (el valor predeterminado si se omite)]
  2. Ejecutable, uap10:RuntimeBehavior="win32App", uap10:TrustLevel="mediumIL" (para ver 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>"

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

Pero es redundante especificar tanto uap10:RuntimeBehavior/uap10:TrustLevel y EntryPoint al mismo tiempo. Pero si lo haces, entonces se trata de un error si se contradecen.

Las activaciones de aplicaciones para la Plataforma universal de Windows (UWP) requieren EntryPoint. Por lo tanto, si especifica ejecutable y uap10:RuntimeBehavior="windowsApp" (sin EntryPoint), se produce un error. En este mismo caso, entryPoint especificaría algo distinto de "windows.fullTrustApplication" y "windows.partialTrustApplication"; y los 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 establecer uap10:RuntimeBehavior="win32App" y uap10:TrustLevel="appContainer".

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

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 de , no es necesario declararlo en el nivel de Extensiones de (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 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

Artículo Valor
de espacio de nombres de http://schemas.microsoft.com/appx/manifest/uap/windows10
Atributos de de escritorio4 de http://schemas.microsoft.com/appx/manifest/desktop/windows10/4
atributos de uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10