uap4:Extension

  • Article

Déclare un point d’extensibilité pour l’application.

Hiérarchie d’éléments

<Paquet>

    <Applications>

         <Application>

              <Extensions>

                   <uap4:Extension>

Syntax

<uap4:Extension
  Category = 'A string that can have one of the following values: "windows.sharedFonts", "windows.userDataTaskDataProvider", "windows.mediaCodec", "windows.contactPanel", "windows.loopbackAccessRules", "windows.devicePortalProvider", "windows.printWorkflowBackgroundTask", or "windows.printWorkflowForegroundTask".'
  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.'
  uap11:Id = 'An optional string with a value between 1 and 255 characters in length with a non-whitespace character at its beginning and end.'
  uap11:Subsystem = 'An optional string that can have one of the following values: "console" or "windows".'
  uap11:SupportsMultipleInstances = 'An optional boolean value.'
  uap11:ResourceGroup = 'An optional alphanumeric string with a value between 1 and 255 characters in length. Must begin with a letter.'
  uap11:CurrentDirectoryPath = 'An optional string that cannot contain these characters: <, >, |, ?, or *. >'
  uap11:Parameters = 'An optional string with a value between 1 and 32767 characters in length with a non-whitespace character at its beginning and end.'
  desktop7:CompatMode = 'An optional string the can have one of the following values: "classic" or "modern".'
  desktop7:Scope = 'An optional string that can have one of the following values: "machine" or "user".' >

  <!-- Child elements -->
  uap4:SharedFonts
  uap4:UserDataTaskDataProvider
  uap4:MediaCodec 
  uap4:ContactPanel
  uap4:LoopbackAccessRules
  uap4:DevicePortalProvider?

</uap4: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. Chaîne qui peut avoir l’une des valeurs suivantes : windows.sharedFonts, windows.userDataTaskDataProvider, windows.mediaCodec, windows.contactPanel, windows.loopbackAccessRules, windows.devicePortalProvider, windows.printWorkflowBackgroundTask ou windows.printWorkflowForegroundTask. 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. Valeur de chaîne facultative. S’il est spécifié, il peut s’agir de l’une des valeurs suivantes : windowsApp, empaquetéClassicApp ou win32App. 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
uap11 :Id Identificateur de l’extension. L’ID doit être unique pour toutes les extensions d’un package. Chaîne facultative avec une valeur comprise entre 1 et 255 caractères, avec un caractère non-espace blanc au début et à la fin. No
uap11 :Sous-système Cet attribut est hérité de la syntaxe de l’extension de base et n’est pas applicable à l’extension com4. Outre la validation syntaxique, cette valeur est ignorée. Chaîne facultative qui peut avoir l’une des valeurs suivantes : console ou windows. No
uap11 :SupportsMultipleInstances Spécifie si les instances doivent s’exécuter dans différents processus. La valeur par défaut est false. Valeur booléenne facultative. No
uap11 :ResourceGroup Balise que vous pouvez utiliser pour regrouper les activations d’extensions à des fins de gestion des ressources (par exemple, processeur et mémoire). La valeur que vous pouvez définir ResourceGroup est de forme libre et flexible. Voir Application@ResourceGroup. Chaîne alphanumérique facultative avec une valeur comprise entre 1 et 255 caractères. Doit commencer par une lettre. No
uap11 :CurrentDirectoryPath Spécifie le répertoire initial lors du lancement du processus d’application. Chaîne facultative qui ne peut pas contenir les caractères suivants : <, >, |, ?ou *. > No
uap11 :Parameters Cet attribut est hérité de la syntaxe d’extension de base et n’est pas applicable à l’extension com4. Outre la validation syntaxique, cette valeur est ignorée. Chaîne facultative dont la valeur est comprise entre 1 et 32767 caractères, avec un caractère sans espace blanc au début et à la fin. No
desktop7 :CompatMode Spécifie si les informations de cette extension sont inscrites auprès de Windows de manière classique (par exemple, les applications non empaquetées inscrivent des types auprès de COM via le registre) ou de nouvelles façons plus étendues. La valeur par défaut est « modern ». CompatMode="classic » nécessite la fonctionnalité Microsoft.classicAppCompat_8wekyb3d8bbwe . Chaîne facultative pouvant avoir l’une des valeurs suivantes : classique ou moderne. No
desktop7 :Scope Spécifie si les inscriptions ne sont visibles que par les autres applications exécutées en tant qu’utilisateur ayant inscrit ce package (utilisateur), ou si elles sont visibles par tous les utilisateurs et services sur la machine (machine). La valeur par défaut est « user ». Scope="machine » nécessite la fonctionnalité Microsoft.classicAppCompatElevated_8wekyb3d8bbwe . Chaîne facultative qui peut avoir l’une des valeurs suivantes : machine ou utilisateur. No

Éléments enfants

Élément enfant Description
SharedFonts Contient les emplacements des polices partagées à utiliser avec l’application.
UserDataTaskDataProvider Permet à une application de devenir DataProvider pour une tâche.
MediaCodec Définit une extension qui permet à une application d’installer des codecs multimédias à partir du Microsoft Store.
ContactPanel Active le panneau des contacts dans une application Windows.
LoopbackAccessRules Contient des règles pour un filtre de bouclage qui permet la communication entre une application et un service.
DevicePortalProvider Définit un fournisseur Device Portal pour le déploiement.

Éléments parents

Élément parent Description
Extensions Définit un ou plusieurs points d’extensibilité pour le package.

Remarques

windows.printWorkflowBackgroundTask et windows.printWorkflowForegroundTask sont des déclarations d’extension vides qui prennent en charge les scénarios d’impression. Le point d’entrée de la tâche en arrière-plan est initialement appelé par le système d’impression pour commencer à gérer les données d’impression, et la tâche de premier plan est activée lors de la demande d’informations de l’utilisateur. Le point d’entrée d’arrière-plan doit être une classe implémentant IBackgroundTask.

Configuration requise

Élément Valeur
Espace de noms http://schemas.microsoft.com/appx/manifest/uap/windows10/4
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10
Minimum OS Version Windows 10 version 1703 (build 15063)