uap:Extension (Windows 10)

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

Hiérarchie d’éléments

<Paquet>

    <Applications>

         <Application>

              <Extensions>

                   <uap:Extension>

Syntaxe

<uap:Extension
  Category = 'A string that can have one of the following values: "windows.fileTypeAssociation", "windows.protocol", "windows.autoPlayContent", "windows.autoPlayDevice", "windows.shareTarget", "windows.search", "windows.fileOpenPicker", "windows.fileSavePicker", "windows.cachedFileUpdater", "windows.cameraSettings", "windows.accountPictureProvider", "windows.printTaskSettings", "windows.lockScreenCall", "windows.appointmentsProvider", "windows.alarm", "windows.webAccountProvider", "windows.dialProtocol", "windows.appService", "windows.mediaPlayback", "windows.print3DWorkflow", "windows.lockScreen", "windows.aboveLockScreen", "windows.personalAssistantLaunch", or "windows.voipCall".'
  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 -->
  uap:FileTypeAssociation?
  uap:Protocol?
  uap:AutoPlayContent?
  uap:AutoPlayDevice?
  uap:ShareTarget?
  uap:FileOpenPicker?
  uap:FileSavePicker?
  uap:AppointmentsProvider?
  uap:WebAccountProvider?
  uap:DialProtocol?
  uap:AppService?
  uap:MediaPlayback?
  uap:VoipCall?

</uap: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 pouvant avoir l’une des valeurs suivantes : windows.fileTypeAssociation, windows.protocol, windows.autoPlayContent, windows.autoPlayDevice, windows.shareTarget, windows.search, windows.fileOpenPicker, windows.fileSavePicker, windows.cachedFileUpdater, windows.cameraSettings, windows.accountPictureProvider, windows.printTaskSettings, windows.printTaskSettings, windows.lockScreenCall, windows.appointmentsProvider, windows.alarm, windows.webAccountProvider, windows.dialProtocol, windows.appService, windows.mediaPlayback, windows.print3DWorkflow, windows.lockScreen, windows.aboveLockScreen, windows.personalAssistantLaunch ou windows.voipCall. 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 Runtime). 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
uap:AppService Déclare un point d’extensibilité d’application de type windows.appService. Les contrats d’application permettent à une application d’appeler une tâche en arrière-plan appartenant à une autre application ; ou pour une tâche en arrière-plan appelée pour traiter un contrat d’application, un moyen de communiquer avec son appelant.
uap:AppointmentsProvider Déclare un point d’extensibilité d’application de type windows.appointmentsProvider.
uap:AutoPlayContent Déclare un point d’extensibilité d’application de type windows.autoPlayContent. L’application fournit les actions de contenu de lecture automatique spécifiées.
uap:AutoPlayDevice Déclare un point d’extensibilité d’application de type *windows.autoPlayDevice. L’application fournit les actions d’appareil de lecture automatique spécifiées.
uap:DialProtocol Déclare un point d’extensibilité d’application de type windows.dialProtocol*.
uap:FileOpenPicker Déclare un point d’extensibilité d’application de type windows.fileOpenPicker. L’application permet à l’utilisateur de choisir et d’ouvrir les types de fichiers spécifiés.
uap:FileSavePicker Déclare un point d’extensibilité d’application de type windows.fileSavePicker. L’application permet à l’utilisateur de choisir le nom de fichier, l’extension et l’emplacement de stockage pour les types de fichiers spécifiés.
uap:FileTypeAssociation Déclare un point d’extensibilité d’application de type windows.fileTypeAssociation. Une association de type de fichier indique que l’application est inscrite pour gérer les fichiers des types spécifiés.
uap:MediaPlayback Déclare un point d’extensibilité d’application de type mediaPlayback afin que votre application puisse déclarer qu’elle effectue un transcodage vidéo.
uap:Protocol Déclare un point d’extensibilité d’application de type windows.protocol. Une association d’URI indique que l’application est inscrite pour gérer les URI avec le schéma spécifié.
uap:ShareTarget Déclare un point d’extension d’application de type windows.shareTarget. L’application peut partager les types de fichiers spécifiés.
uap:VoipCall Déclare un point d’extensibilité d’application de type windows.voipCall afin que votre application puisse déclarer qu’elle peut effectuer une mise à niveau d’un appel cellulaire vers un appel vidéo VoIP et/ou s’il s’agit d’une application VoIP qui prend en charge la numérotation directe des numéros de téléphone.
uap:WebAccountProvider Déclare un point d’extensibilité d’application de type windows.webAccountProvider.

Éléments parents

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

Remarques

Pour la plupart des types d’extensions, Extension@ResourceGroup doit correspondre à Application@ResourceGroup (si Application@ResourceGroup est omis, Extension@ResourceGroup doit également être omis).

Pour un contrat basé sur l’interface utilisateur : si Extension@ResourceGroup n’est pas spécifié, il sera implicitement regroupé avec l’application ; si Extension@ResourceGroup ne correspond pas Application@ResourceGroup, le manifeste échoue la validation du schéma.

Si Extension@ResourceGroup n’est pas spécifié pour une tâche en arrière-plan ou pour un contrat basé sur une tâche en arrière-plan, il est associé à un groupe par défaut pour toutes les tâches en arrière-plan. Les contrats de tâche en arrière-plan sont autorisés à spécifier les mêmes valeurs que Application@ResourceGroup.

Pour les extensions suivantes, Extension@ResourceGroup permet de regrouper la tâche en arrière-plan exécutée dans différents processus qui seront gérés indépendamment des autres groupes : windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask et windows.updateTask.

Par exemple, si le manifeste avait ces trois entrées.

<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask" ResourceGroup="Group1">
  <BackgroundTasks>
    <Task Type="timer"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask2" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="controlChannel"/>
  </BackgroundTasks>
</Extension>
<Extension Category="windows.backgroundTasks" EntryPoint="Fabrikam.BackgroundTask3" ResourceGroup="Group2">
  <BackgroundTasks>
    <Task Type="pushNotification"/>
  </BackgroundTasks>
</Extension>

Les deux dernières tâches en arrière-plan sont alors activées dans la même instance de backgroundtaskhost.exe si elles ont été activées simultanément. Toutefois, une instance distincte de backgroundtaskhost.exe serait lancée pour la première entrée, car elle a un groupe de ressources différent.

Si aucun ResourceGroup n’est spécifié pour une extension, toutes les tâches en arrière-plan sont activées dans la même instance de backgroundtaskhost.exe.

En outre, si l’une de ces extensions (windows.backgroundTasks, windows.appServices, windows.preinstalledConfigTask ou windows.updateTask) spécifie la même valeur que l’attribut ResourceGroup de l’élément Application parent, ils sont activés dans le même processus que l’interface utilisateur.

Les extensions suivantes se trouvent sous l’onglet déclarations de l’interface utilisateur du concepteur de package . Consultez les descriptions de chacun de ces éléments :

  • Recherche : inscrit l’application en tant que fournisseur de recherche. Le contenu indexé de l’application peut apparaître sous forme de résultats de recherche dans l’expérience de recherche globale lancée via l’icône De recherche. Une seule instance de cette déclaration est autorisée par application.
  • CachedFileUpdater : inscrit l’application en tant que programme de mise à jour de fichiers mis en cache, ce qui permet à l’application de fournir des mises à jour aux fichiers auxquels accèdent d’autres applications du Microsoft Store. Une seule instance de cette déclaration est autorisée par application.
  • Paramètres de l’appareil photo : permet à l’application de fournir des panneaux de contrôle personnalisés pour les appareils photo web. Une seule instance de cette déclaration est autorisée par application.
  • AccountPictureProvider : inscrit l’application en tant que fournisseur d’images de compte, ce qui lui permet d’être lancée en mode image de compte et de définir l’image de l’utilisateur sans invite supplémentaire. Une seule instance de cette déclaration est autorisée par application.
  • PrintTaskSettings : permet à l’application de remplacer l’expérience des paramètres d’impression de base. Une seule instance de cette déclaration est autorisée par application.
  • LockScreen : si un téléphone est verrouillé, il existe une quantité limitée d’interactions que l’utilisateur peut effectuer. Dans certains cas, un utilisateur souhaite pouvoir répondre à un appel VoIP sans déverrouiller le téléphone. Ce contrat rend cela possible. Une seule instance de cette déclaration est autorisée par application.
  • Alarme : une application peut se déclarer comme application d’alarme système. Lorsqu’un utilisateur passe par l’interface utilisateur de sélection pour définir son alarme système, seules les applications déclarées en tant qu’applications d’alarme système peuvent être sélectionnées. Une seule instance de cette déclaration est autorisée par application.
  • BackgroundTasks : les tâches en arrière-plan permettent aux applications de communiquer entre elles et d’appeler une autre application. Pour utiliser des contrats pour fournir ou lancer ces tâches en arrière-plan, une application doit être déclarée en tant que service d’application. Plusieurs instances de cette déclaration sont autorisées dans chaque application.
  • Print3DWorkFlow : les fabricants d’imprimantes 3D peuvent fournir une application Windows universelle pour offrir une expérience unique dans la boîte de dialogue d’impression 3D. Si ce n’est pas le cas, Windows fournit une expérience d’impression 3D par défaut. Une seule instance de cette déclaration est autorisée par application.
  • PersonalAssistantLaunch : permet à une application de s’intégrer à Cortana. Une seule instance de cette déclaration est autorisée par application.

Spécifications

Élément Valeur
récapitule4 http://schemas.microsoft.com/appx/manifest/uap/windows10
uap10 http://schemas.microsoft.com/appx/manifest/uap/windows10/10