Partager via

Extension (dans Application/Extensions) (Windows 10)

  • Article

Déclare un point d’extensibilité pour le package.

Hiérarchie d’éléments

<Paquet>

    <Applications>

         <Application>

              <Extensions>

                   <Extension>

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>

Clé :

? facultatif (zéro ou un)

Attributs et éléments

Attributs

Attribut Description Type de données Obligatoire Valeur par défaut
Catégorie Type de point d’extensibilité du package. Il peut s’agir de l’une des valeurs suivantes : windows.backgroundTasks, windows.preInstalledConfigTask, windows.updateTask ou windows.restrictedLaunch. Yes
EntryPoint ID de classe activable. Chaîne dont la valeur est comprise entre 1 et 256 caractères. Représente la tâche qui gère l’extension (normalement le nom complet qualifié d’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. No
Exécutable Exécutable de lancement par défaut. Chaîne avec une valeur comprise entre 1 et 256 caractères, qui doit se terminer par .exe, et ne peut pas contenir les caractères suivants : <, >, ":, |, ?, ou *. Spécifie l’exécutable par défaut de l’extension. S’il 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, l’élément EntryPoint défini pour l’application est utilisé. No
RuntimeType Fournisseur d’exécution. Généralement utilisé lorsqu’il existe des frameworks mixtes dans une application. Chaîne avec une valeur comprise entre 1 et 255 caractères qui ne peut pas commencer ou se terminer par un . ou contenir des caractères : <, >, :, "|, ?, ou *. No
StartPage La page web qui gère le point d’extensibilité. Chaîne dont la valeur est comprise entre 1 et 256 caractères et qui ne peut pas contenir les caractères suivants : <, >, :, "|, ?, ou *. No
ResourceGroup Balise facultative utilisée pour regrouper les activations d’extensions à 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. No
uap10 :TrustLevel Spécifie le niveau d’approbation de l’extension. Valeur de chaîne facultative. S’il est spécifié, il peut s’agir de l’une des valeurs suivantes : appContainer ou mediumIL. No
uap10 :RuntimeBehavior Spécifie le comportement d’exécution d’une extension.

Pour plus d’informations et la configuration requise, consultez uap10:RuntimeBehavior la rubrique relative à l’élément Application (Windows 10).		 Valeur de chaîne facultative. S’il est spécifié, il peut s’agir de l’une des valeurs suivantes : « empaquetéClassicApp », « win32App » ou « windowsApp ». No
uap10 :HostId Spécifie l’ID du runtime hôte pour l’extension. Chaîne alphanumérique avec une valeur facultative comprise entre 1 et 255 caractères. Doit commencer par une lettre. No
uap10 :Parameters Contient les paramètres de ligne de commande à passer à l’extension. Pris en charge uniquement pour les applications de bureau. Chaîne dont la valeur est comprise entre 1 et 32767 caractères avec un caractère non-espace blanc au début et à la fin. No

Éléments enfants

Élément enfant Description
BackgroundTasks Définit un point d’extensibilité d’application de type windows.backgroundTasks. Les tâches en arrière-plan s’exécutent dans un hôte en arrière-plan dédié ; c’est-à-dire sans interface utilisateur.

Éléments parents

Élément parent Description
Extensions (type : CT_ApplicationExtensions) Définit un ou plusieurs points d’extensibilité pour l’application.

Les éléments suivants portent le même nom que celui-ci, mais ils ont un contenu ou des attributs différents :

Remarques

Si les attributs d’informations d’activation ne sont pas spécifiés sur l’extension, ils sont hérités de l’application parente. Consultez la section remarques pour l’élément Application .

Les points d’extensibilité sont un mécanisme par lequel un package peut ajouter des fonctionnalités d’une manière définie par le système d’exploitation. Un point d’extensibilité est un emplacement où une application peut s’inscrire pour exécuter du code ou utiliser les ressources du package actuel. Pour ajouter des fonctionnalités pour une application particulière, utilisez l’élément Application enfant de l’élément Applications .

Le point d’extensibilité windows.certificates ne peut pas être déclaré plusieurs fois dans un manifeste.

Notes

L’attribut EntryPoint ou StartPage est requis si l’attribut Category est windows.UpdateTask ou windows.preInstalledConfigTask pour les versions de Windows 10 antérieures à Windows 10 version 1607. À compter de Windows 10, version 1607, vous n’avez plus besoin de spécifier une valeur pour EntryPoint ou StartPage lorsque Category est windows.Use, UpdateTask, ou windows.preInstalledConfigTask de cibler uniquement les appareils qui exécutent Windows 10, version 1607 ou ultérieure.

Voir aussi

Concepts Contratset extensions d’application

Configuration requise

Élément Valeur
Espace de noms http://schemas.microsoft.com/appx/manifest/foundation/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10