Extension (dans Application/Extensions) (Windows 10)

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

Hiérarchie d’éléments

<Package>

    <Applications>

         <Application>

              <Extensions>

                   <Extension>

Syntaxe

<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. Oui
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é de l’espace de noms d’un type Windows 运行时). Si EntryPoint n’est pas spécifié, EntryPoint défini pour l’application est utilisé à la place. Non
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 ces caractères : <, , , :>, ", |, ?ou *. Spécifie l’exécutable par défaut pour 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, EntryPoint définie pour l’application est utilisée. Non
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 *. 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 Notes dans Application@ResourceGroup. Chaîne alphanumérique comprise entre 1 et 255 caractères. Doit commencer par une lettre. Non
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. Non
uap10:RuntimeBehavior Spécifie le comportement d’exécution d’une extension. Valeur de chaîne facultative. S’il est spécifié, il peut s’agir de l’une des valeurs suivantes : windowsApp, packageClassicApp ou win32App. Non
uap10:HostId Spécifie l’ID d’application de l’application 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. Non
uap10:Parameters Contient des paramètres de ligne de commande à passer à l’extension. Uniquement pris en charge pour les applications de bureau qui ont une identité de package. Chaîne dont la valeur est comprise entre 1 et 32767 caractères, avec un caractère sans espace blanc à son début et à sa fin. Non

É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é ; autrement dit, 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

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 des ressources du package actuel. Pour ajouter des fonctionnalités pour une application particulière, utilisez l’élément enfant Application 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 avant Windows 10, version 1607. À compter de Windows 10, version 1607, vous n’avez plus besoin de spécifier de valeur pour EntryPoint ou StartPage lorsque la catégorie estwindows.Use, UpdateTask ou windows.preInstalledConfigTask pour cibler uniquement les appareils qui exécutent Windows 10, version 1607 ou ultérieure.

Voir aussi

ConceptsDes contrats et extensions d’application

Spécifications

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