Application (Windows 10)

Représente une application qui comprend une partie ou l’ensemble des fonctionnalités fournies dans le package.

Hiérarchie d’éléments

<Package>

    <Applications>

         <Application>

Syntaxe

<Application
  Id = 'An ASCII string between 1 and 64 characters in length. See the Attributes table for more information on character restrictions.'
  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.'
  StartPage = 'Any valid URI or IRI (the non-ASCII version of a URI). See below for more details.' 
  ResourceGroup = 'An alphanumeric string between 1 and 255 characters in length. Must begin with an letter.'
  desktop4:Subsystem = 'A string that can have one of the following values: "console" or "windows".'
  uap10:Subsystem = 'A string that can have one of the following values: "console" or "windows".'
  desktop4:SupportsMultipleInstances = 'An optional boolean value.'
  uap10:SupportsMultipleInstances = 'An optional boolean value.'
  uap10:TrustLevel = 'A string that can have one of the following values: "appContainer" or "mediumIL".'
  uap10:RuntimeBehavior  = 'A string that can have one of the following values: "windowsApp", "packagedClassicApp", or "win32App".'
  uap10:HostId = 'An alphanumeric string between 1 and 255 characters in length. Must begin with a letter.'
  uap10:Parameters   = 'A string between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.' >

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

</Application>

Clé

? facultatif (zéro ou un) & connecteur interleave (peut se produire dans n’importe quel ordre)

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
Id Identificateur unique de l’application dans le package. Elle est parfois appelée « identificateur relatif au package d’application » (ou PRAID, Package-Relative App Identifier). L’ID est unique dans le package, mais pas globalement. Il peut y avoir un autre package sur le système qui utilise le même ID. Le même ID ne peut pas être utilisé plusieurs fois dans le même package. Lorsque vous utilisez un modèle Visual Studio, la valeur par défaut de cet attribut est App. Les développeurs doivent modifier manuellement cela dans le manifeste. L’identificateur de l’application ne doit pas être modifié une fois que l’application a été publiée dans le Microsoft Store ; cela perturbera la position de la vignette sur l’écran de démarrage. Chaîne ASCII comprise entre 1 et 64 caractères de longueur. Cette chaîne contient des champs alphanumériques séparés par des points. Chaque champ doit commencer par un caractère alphabétique ASCII. Vous ne pouvez pas les utiliser comme valeurs de champ : CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8 et LPT9. Oui
EntryPoint ID de classe activable (par exemple, « Office.Winword.Class »). Si vous spécifiez cet attribut, vous devez également spécifier l’attribut Exécutable . Si vous spécifiez cet attribut, vous ne devez pas spécifier l’attribut StartPage . Chaîne comprise entre 1 et 256 caractères, représentant la tâche qui gère l’extension. Il s’agit généralement du nom complet de l’espace de noms d’un type Windows Runtime. Si EntryPoint n’est pas spécifié, l’élément EntryPoint défini pour l’application est utilisé à la place. Non
Exécutable Exécutable de lancement par défaut de l’application. Ce fichier doit être présent dans le package. Si vous spécifiez cet attribut, vous devez spécifier l’attribut EntryPoint . Si vous spécifiez cet attribut, vous ne devez pas spécifier l’attribut StartPage . Chaîne comprise entre 1 et 256 caractères de longueur qui doit se terminer par .exe et ne peut pas contenir ces caractères : <, , |>":, ?, ou .* Il spécifie l’exécutable par défaut de l’extension. Si ce n’est pas spécifié, l’exécutable défini pour l’application est utilisé. Si elle est spécifiée, la propriété EntryPoint est également utilisée. Si cette propriété EntryPoint n’est pas spécifiée, la propriété EntryPoint définie pour l’application est utilisée. Non
StartPage La page web qui gère le point d’extensibilité. Chaîne avec une valeur comprise entre 1 et 256 caractères qui ne peut pas contenir ces caractères : <, >, :|", ?ou .* Non
ResourceGroup Balise facultative utilisée pour regrouper les activations d’extension à des fins de gestion des ressources (par exemple, processeur et mémoire). Consultez la section Remarques dans Application@ResourceGroup. Chaîne alphanumérique comprise entre 1 et 255 caractères. Doit commencer par une lettre. Non
desktop4:Sous-système Indique si l’application est une application UWP standard ou une application console UWP. Chaîne qui peut être l’une des valeurs suivantes : console ou fenêtres. Non
uap10:Sous-système Indique si l’application est une application UWP standard ou une application console UWP. Chaîne pouvant être l’une des valeurs suivantes : conole ou fenêtres. Non
desktop4:SupportsMultipleInstances Indique la prise en charge de plusieurs instances distinctes d’applications UWP. Pour plus d’informations, consultez la section remarques. Valeur booléenne facultative Non
uap10:SupportsMultipleInstances Indique la prise en charge de plusieurs instances distinctes d’applications UWP. Pour plus d’informations, consultez la section remarques. Valeur booléenne facultative. Non
uap10:TrustLevel Spécifie le niveau d’approbation de l’application. Chaîne qui peut être l’une des valeurs suivantes : « appContainer » ou « mediumIL ». Non
uap10:RuntimeBehavior Spécifie le comportement d’exécution de l’application. Chaîne pouvant être l’une des valeurs suivantes : « windowsApp », « empaquetéClassicApp » ou « win32App ». Non
uap10:HostId Cette valeur spécifie l’ID d’application de l’application hôte pour l’application active. Cet attribut est utilisé pour les applications hébergées. Chaîne alphanumérique comprise entre 1 et 255 caractères. Doit commencer par une lettre. Non
uap10:Parameters Contient des paramètres de ligne de commande à transmettre à l’application. Uniquement pris en charge pour les applications de bureau qui ont une identité de package. Chaîne comprise entre 1 et 32767 caractères de longueur avec un caractère non blanc au début et à la fin. Non

Éléments enfants

Élément enfant Description
Extensions (type : CT_ApplicationExtensions) Définit un ou plusieurs points d’extensibilité pour l’application.
uap:ApplicationContentUriRules Spécifie les pages du contexte web qui ont accès aux appareils de géolocalisation du système (si l’application dispose de l’autorisation d’accéder à cette fonctionnalité) et à l’accès au Presse-papiers.
uap:VisualElements Décrit les aspects visuels de l’application : sa vignette par défaut, les images de logo, le texte et les couleurs d’arrière-plan, l’orientation initiale de l’écran, l’écran de démarrage et l’apparence de la vignette d’écran de verrouillage.
uap7:Properties Spécifie les propriétés de l’application.

Éléments parents

Élément parent Description
Applications Représente une ou plusieurs applications qui composent le package.

Remarques

L’élément Application contient des attributs communs aux points d’extensibilité qui se rapportent à l’application. Ces informations sont utilisées par d’autres points d’extensibilité pour obtenir des informations sur l’application. En outre, les attributs d’application sont utilisés dans le démarrage et la gestion d’une instance de l’application.

StartPage s’applique uniquement à une application JavaScript. Si StartPage n’est pas spécifié, les attributs Exécutable et EntryPoint doivent être spécifiés, et cela s’applique uniquement à une application C#, C++ou VB.

Remarques importantes sur les applications multistancing :

  • Si une application déclare SupportsMultipleInstances dans l’élément Application , toutes les extensions de premier plan seront également multi-instances.
  • Si l’application déclare SupportsMultipleInstances dans l’élément Application , elle n’a pas besoin d’être déclarée au niveau extensions (par exemple, dans un élément BackgroundTasks ou AppService ).
  • L’application ne doit déclarer que les supportsMultipleInstances sur les tâches en arrière-plan, l’audio en arrière-plan ou les services d’application.
  • Les applications console sont toujours multi-instances et doivent déclarer explicitement supportsMultipleInstances.
  • Les applications peuvent utiliser la déclaration ResourceGroup dans le manifeste pour regrouper plusieurs tâches en arrière-plan dans le même hôte. Cela est en conflit avec l’instanciation multistanciation, où chaque activation se trouve dans un hôte distinct. Par conséquent, une application ne peut pas déclarer les deux supportsMultipleInstances et ResourceGroup dans le manifeste.

Pour plus d’informations sur l’utilisation de l’attribut SupportsMultipleInstances pour prendre en charge plusieurs instances distinctes d’applications UWP, consultez Créer une application Windows universelle à plusieurs instances.

Spécifications

Valeur
Espace de noms http://schemas.microsoft.com/appx/manifest/uap/windows10
attributs desktop4 http://schemas.microsoft.com/appx/manifest/desktop/windows10/4
Attributs uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10