uap :Extension (Windows 10)
Déclare un point d’extensibilité pour l’application.
Hiérarchie d’éléments
<uap:Extension>
Syntax
<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.'
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 -->
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 qui peut 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.lockScreenCall, windows.appointmentsProvider, windows.alarm, windows.webAccountProvider, windows.dialProtocol, windows.appService, windows.mediaPlayback, windows.print3DWorkflow, windows.lockScreen, windows.aboveLockScreen, windows.personalAssistantLaunch ou windows.voipCall. | 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 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 dont la valeur est comprise entre 1 et 256 caractères, qui doit se terminer par .exeet ne peut pas contenir ces caractères : <, >, :", |, , ?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 dont la longueur est comprise entre 1 et 255 caractères et 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 ces caractères : <, >, ":, |, ?, 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 de confiance de l’extension. | Valeur de chaîne facultative. Si elle est spécifiée, 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. Si elle est spécifiée, il peut s’agir de l’une des valeurs suivantes : windowsApp, packagedClassicApp 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 32 767 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 d’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 des processus différents. 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 lorsque le processus d’application est lancé. | Chaîne facultative qui ne peut pas contenir ces caractères : <, >, |, ?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 |
|---|---|
| uap:AppService | Déclare un point d’extensibilité d’application de type windows.appService. Les contrats d’application sont un moyen pour 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 directement en charge la numérotation 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 l’être).
Pour un contrat basé sur l’interface utilisateur : si Extension@ResourceGroup n’est pas spécifié, il est implicitement regroupé avec l’application ; si Extension@ResourceGroup ne correspond pas à Application@ResourceGroup la validation du schéma échoue.
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 en différents processus qui seront gérés par les ressources et le cycle de vie 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>
Ensuite, les deux dernières tâches en arrière-plan seraient activées dans le même instance de backgroundtaskhost.exe si elles étaient activées simultanément. Toutefois, une instance distincte de backgroundtaskhost.exe serait mise en place 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 le 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 de l’attribut ResourceGroup de l’élément Application parent, elle sera activée 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 moteur de recherche. Le contenu indexé de l’application peut apparaître sous forme de résultats de recherche dans l’expérience recherche globale lancée via l’icône Rechercher. 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 d’autres applications du Microsoft Store accèdent. 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 de caméra 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é, l’utilisateur peut effectuer une interaction limitée. 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 en tant qu’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 comme applications d’alarme système peuvent être sélectionnées. Une seule instance de cette déclaration est autorisée par application.
- Tâches d’arrière-plan : les tâches en arrière-plan permettent aux applications de communiquer entre elles et d’appeler une autre application. Pour pouvoir 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 offre 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.
Configuration requise
| Élément | Valeur |
|---|---|
| récap. 4 | http://schemas.microsoft.com/appx/manifest/uap/windows10 |
| uap10 | http://schemas.microsoft.com/appx/manifest/uap/windows10/10 |
| Minimum OS Version | Windows 10 version 1511 (build 10586) |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour