Intégrez votre application de bureau à Windows à l’aide des extensions de package.

Article
05/07/2024

Si votre application de bureau est packagée (c’est-à-dire qu’elle comporte l’identité du package au moment de l’exécution), vous pouvez utiliser des extensions pour intégrer votre application à Windows en utilisant des extensions prédéfinies dans le manifeste du package. Consultez également Fonctionnalités nécessitant une identité de package.

Par exemple, utilisez une extension pour créer une exception de pare-feu, faites de votre application l’application par défaut pour un type de fichier, ou pointez des vignettes de démarrage vers votre application. Pour utiliser une extension, il suffit d’ajouter un peu de XML au fichier manifeste du package de votre application. Aucun code n’est nécessaire.

Cette rubrique décrit ces extensions et les tâches que vous pouvez effectuer en les utilisant.

Notes

Les fonctionnalités décrites dans cette rubrique nécessitent que votre application soit packagée (c’est-à-dire qu’elle comporte l’identité du package au moment de l’exécution). Cela inclut les applications packagées (voir Créer un projet pour une application de bureau WinUI 3 packagée) et les applications packagées avec un emplacement externe (voir Accorder une identité de package en créant un package avec un emplacement externe). Consultez également Fonctionnalités nécessitant une identité de package.

Migrer les utilisateurs vers votre application

Aidez les utilisateurs à migrer vers votre application empaquetée.

Rediriger votre application de bureau existante vers votre application empaquetée
Pointer les vignettes existantes de l’écran de démarrage et les boutons de barre des tâches vers votre application empaquetée
Ouvrir des fichiers à l’aide de votre application empaquetée au lieu de votre application de bureau
Associer votre application empaquetée à un ensemble de types de fichiers
Ajouter des options aux menus contextuels de fichiers d'un certain type
Ouvrir certains types de fichiers directement à l’aide d’une URL

Rediriger votre application de bureau existante vers votre application empaquetée

Quand les utilisateurs démarrent votre application de bureau non packagée existante, vous pouvez configurer votre application packagée au format MSIX pour qu’elle soit ouverte à la place.

Notes

Cette fonctionnalité est prise en charge dans Windows Insider Preview versions 21313 et ultérieures.

Pour activer ce comportement :

Ajoutez des entrées de Registre pour rediriger l’exécutable de votre application de bureau non empaquetée vers votre application empaquetée.
Inscrivez votre application empaquetée pour qu’elle soit lancée quand l’exécutable de votre application de bureau non empaquetée est lancée.

Ajouter des entrées de Registre pour rediriger l’exécutable de votre application de bureau non empaquetée

Dans le Registre, créez une sous-clé avec le nom du fichier exécutable de votre application de bureau sous la clé HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options.
Sous cette sous-clé, ajoutez les valeurs suivantes :
- AppExecutionAliasRedirect (DWORD) : si elle est définie sur 1, le système recherche une extension de package AppExecutionAlias avec le même nom que le fichier exécutable. Si l’extension AppExecutionAlias est activée, l’application empaquetée est activée en utilisant cette valeur.
- AppExecutionAliasRedirectPackages (REG_SZ) : le système va rediriger seulement vers les packages listés. Les packages sont listés en fonction du nom de famille de package et sont séparés par un point-virgule. Si la valeur spéciale * est utilisée, le système va rediriger vers un AppExecutionAlias depuis n’importe quel package.

Par exemple :

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\contosoapp.exe 
    AppExecutionAliasRedirect = 1
    AppExecutionAliasRedirectPackages = "Microsoft.WindowsNotepad_8weky8webbe"

Inscrire votre application empaquetée à lancer

Dans le manifeste de votre package, ajoutez une extension AppExecutionAlias qui inscrit le nom de l’exécutable de votre application de bureau non empaquetée. Par exemple :

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap3:Extension Category="windows.appExecutionAlias" EntryPoint="Windows.FullTrustApplication">
          <uap3:AppExecutionAlias>
            <desktop:ExecutionAlias Alias="contosoapp.exe" />
          </uap3:AppExecutionAlias>
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Désactiver la redirection

Les utilisateurs peuvent désactiver la redirection et lancer l’exécutable de votre application non empaquetée via ces options :

Ils peuvent désinstaller la version packagée au format MSIX de votre application.
L’utilisateur peut désactiver l’entrée AppExecutionAlias pour votre application packagée dans la page Alias d’exécution de l’application dans Paramètres.

espaces de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/desktop/windows10

Éléments et attributs de cette extension

<uap3:Extension
    Category="windows.appExecutionAlias"
    EntryPoint="Windows.FullTrustApplication">
    <uap3:AppExecutionAlias>
        <desktop:ExecutionAlias Alias="[AliasName]" />
    </uap3:AppExecutionAlias>
</uap3:Extension>

Nom	Description
Category	Toujours `windows.appExecutionAlias`.
Exécutable	Le chemin d’accès relatif du fichier exécutable à démarrer lorsque l’alias est appelé.
Alias	Le nom court de votre application. Il doit toujours se terminer par l’extension « .exe ».

Pointer les vignettes existantes de l’écran de démarrage et les boutons de barre des tâches vers votre application empaquetée

Vos utilisateurs peuvent avoir épinglé votre application de bureau à la barre des tâches ou au menu Démarrer. Vous pouvez pointer ces raccourcis vers votre nouvelle application empaquetée.

Espace de noms XML

http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

Éléments et attributs de cette extension

<Extension Category="windows.desktopAppMigration">
    <DesktopAppMigration>
        <DesktopApp AumId="[your_app_aumid]" />
        <DesktopApp ShortcutPath="[path]" />
    </DesktopAppMigration>
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.desktopAppMigration`.
AumID	L’ID de modèle utilisateur de l’application de votre application empaquetée.
ShortcutPath	Le chemin d’accès aux fichiers .lnk qui démarrent la version bureau de votre application.

Exemple

<Package
  xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="rescap3">
  <Applications>
    <Application>
      <Extensions>
        <rescap3:Extension Category="windows.desktopAppMigration">
          <rescap3:DesktopAppMigration>
            <rescap3:DesktopApp AumId="[your_app_aumid]" />
            <rescap3:DesktopApp ShortcutPath="%USERPROFILE%\Desktop\[my_app].lnk" />
            <rescap3:DesktopApp ShortcutPath="%APPDATA%\Microsoft\Windows\Start Menu\Programs\[my_app].lnk" />
            <rescap3:DesktopApp ShortcutPath="%PROGRAMDATA%\Microsoft\Windows\Start Menu\Programs\[my_app_folder]\[my_app].lnk"/>
         </rescap3:DesktopAppMigration>
        </rescap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Visionneuse d’images WPF avec transition/migration/désinstallation

Ouvrir des fichiers à l’aide de votre application empaquetée au lieu de votre application de bureau

Vous pouvez vous assurer que les utilisateurs ouvrent votre nouvelle application empaquetée par défaut pour certains types de fichiers, au lieu d’ouvrir la version bureau de votre application.

Pour ce faire, vous devez spécifier l’identificateur programmatique (ProgID) de chaque application à partir de laquelle vous souhaitez hériter des associations de fichiers.

Espaces de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

Éléments et attributs de cette extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
         <MigrationProgIds>
            <MigrationProgId>"[ProgID]"</MigrationProgId>
        </MigrationProgIds>
    </FileTypeAssociation>
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.fileTypeAssociation`.
Nom	Nom de l’association de types de fichiers. Vous pouvez utiliser ce nom pour organiser et regrouper des types de fichiers. Le nom doit contenir uniquement des minuscules, sans espace.
MigrationProgId	L’identificateur programmatique (ProgID) qui décrit l’application, le composant et la version de l’application de bureau à partir de laquelle vous souhaitez hériter des associations de fichiers.

Exemple

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:rescap3="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="uap3, rescap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <rescap3:MigrationProgIds>
              <rescap3:MigrationProgId>Foo.Bar.1</rescap3:MigrationProgId>
              <rescap3:MigrationProgId>Foo.Bar.2</rescap3:MigrationProgId>
            </rescap3:MigrationProgIds>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Visionneuse d’images WPF avec transition/migration/désinstallation

Associer votre application empaquetée à un ensemble de types de fichiers

Vous pouvez associer votre application empaquetée à des extensions de types de fichier. Si un utilisateur clique avec le bouton droit sur un fichier dans l’Explorateur de fichiers, puis sélectionne l’option Ouvrir avec, votre application apparaît dans la liste de suggestions. Pour plus d’informations sur l’utilisation de cette extension, consultez Intégrer une application de bureau empaquetée à l’Explorateur de fichiers.

espaces de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Éléments et attributs de cette extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[file extension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.fileTypeAssociation`.
Nom	Nom de l’association de types de fichiers. Vous pouvez utiliser ce nom pour organiser et regrouper des types de fichiers. Le nom doit contenir uniquement des minuscules, sans espace.
FileType	L’extension de fichier prise en charge par votre application.

Exemple

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="mediafiles">
            <uap:SupportedFileTypes>
            <uap:FileType>.avi</uap:FileType>
            </uap:SupportedFileTypes>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Visionneuse d’images WPF avec transition/migration/désinstallation

Ajouter des options aux menus contextuels de fichiers d'un certain type

Cette extension permet d’ajouter des options au menu contextuel qui apparaît quand les utilisateurs cliquent avec le bouton droit sur un fichier dans l’Explorateur de fichiers. Ces options, par exemple l’impression, la modification ou l’aperçu du fichier, donnent aux utilisateurs d’autres moyens d’interagir avec votre fichier. Pour plus d’informations sur l’utilisation de cette extension, consultez Intégrer une application de bureau empaquetée à l’Explorateur de fichiers.

espaces de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/2
http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Éléments et attributs de cette extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedVerbs>
           <Verb Id="[ID]" Extended="[Extended]" Parameters="[parameters]">"[verb label]"</Verb>
        </SupportedVerbs>
    </FileTypeAssociation>
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.fileTypeAssociation`.
Nom	Nom de l’association de types de fichiers. Vous pouvez utiliser ce nom pour organiser et regrouper des types de fichiers. Le nom doit contenir uniquement des minuscules, sans espace.
Verb	Le nom qui apparaît dans le menu contextuel Explorateur de fichiers. Cette chaîne est localisable en utilisant `ms-resource`.
Id	L’ID unique du verbe. Si votre application est une application UWP, cet ID est transmis à votre application en tant qu’argument d’événement d’activation afin qu’elle puisse gérer la sélection de l’utilisateur de façon appropriée. Si votre application est une application empaquetée de confiance totale, elle reçoit des paramètres à la place (voir la puce suivante).
Paramètres	La liste des paramètres et des valeurs d’arguments associés au verbe. Si votre application est une application empaquetée de confiance totale, ces paramètres sont transmis à l’application en tant qu’arguments d’événement lorsque l’application est activée. Vous pouvez personnaliser le comportement de votre application en fonction de différents verbes d’activation. Si une variable peut contenir un chemin d’accès de fichier, placez la valeur du paramètre entre guillemets. Vous éviterez les problèmes qui se produisent dans les cas où le chemin d’accès contient des espaces. Si votre application est une application UWP, vous ne pouvez pas transmettre de paramètres. L’application reçoit l’ID à la place (voir la puce précédente).
Étendu	Indique que le verbe doit seulement apparaître, si l’utilisateur maintient enfoncée la touche Maj avant de cliquer avec le bouton droit sur le fichier pour afficher le menu contextuel. Cet attribut est facultatif et est défini par défaut sur la valeur False (par exemple, le verbe est toujours affiché) s’il n’est pas répertorié. Vous devez spécifier ce comportement individuellement pour chaque verbe (à l’exception de « Ouvrir », qui est toujours défini sur False).

Exemple

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"

  IgnorableNamespaces="uap, uap2, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap2:SupportedVerbs>
              <uap3:Verb Id="Edit" Parameters="/e &quot;%1&quot;">Edit</uap3:Verb>
              <uap3:Verb Id="Print" Extended="true" Parameters="/p &quot;%1&quot;">Print</uap3:Verb>
            </uap2:SupportedVerbs>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Visionneuse d’images WPF avec transition/migration/désinstallation

Ouvrir certains types de fichiers directement à l’aide d’une URL

Vous pouvez vous assurer que les utilisateurs ouvrent votre nouvelle application empaquetée par défaut pour certains types de fichiers, au lieu d’ouvrir la version bureau de votre application.

Espaces de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Éléments et attributs de cette extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]" UseUrl="true" Parameters="%1">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
    </FileTypeAssociation>
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.fileTypeAssociation`.
Nom	Nom de l’association de types de fichiers. Vous pouvez utiliser ce nom pour organiser et regrouper des types de fichiers. Le nom doit contenir uniquement des minuscules, sans espace.
UseUrl	Indique s’il faut ouvrir les fichiers directement à partir d’une cible URL. Si vous ne définissez pas cette valeur, lors de tentatives par votre application d’ouvrir un fichier à l’aide d’une URL, le système téléchargera d’abord le fichier localement.
Paramètres	Paramètres facultatifs.
FileType	Les extensions de fichier appropriées.

Exemple

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap3">
  <Applications>
      <Application>
        <Extensions>
          <uap:Extension Category="windows.fileTypeAssociation">
            <uap3:FileTypeAssociation Name="myfiletypes" UseUrl="true" Parameters="%1">
              <uap:SupportedFileTypes>
                <uap:FileType>.txt</uap:FileType>
                <uap:FileType>.doc</uap:FileType>
              </uap:SupportedFileTypes>
            </uap3:FileTypeAssociation>
          </uap:Extension>
        </Extensions>
      </Application>
    </Applications>
</Package>

Effectuer des tâches de configuration

Créer une exception de pare-feu pour votre application
Placer vos fichiers DLL dans n'importe quel dossier du package

Créer une exception de pare-feu pour votre application

Si votre application requiert une communication via un port, vous pouvez ajouter votre application à la liste des exceptions de pare-feu.

Notes

Pour utiliser la catégorie d’extension « windows.firewallRules » (voir ci-dessous), votre package a besoin de la fonctionnalité restreinte Niveau d’autorisation de confiance totale. Consultez Liste des fonctionnalités restreintes.

espace de noms XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Éléments et attributs de cette extension

<Extension Category="windows.firewallRules">
  <FirewallRules Executable="[executable file name]">
    <Rule
      Direction="[Direction]"
      IPProtocol="[Protocol]"
      LocalPortMin="[LocalPortMin]"
      LocalPortMax="LocalPortMax"
      RemotePortMin="RemotePortMin"
      RemotePortMax="RemotePortMax"
      Profile="[Profile]"/>
  </FirewallRules>
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Catégorie	Toujours `windows.firewallRules`
Exécutable	Le nom du fichier exécutable que vous souhaitez ajouter à la liste des exceptions de pare-feu
Direction	Indique si la règle est une règle entrante ou sortante
IPProtocol	Le protocole de communication
LocalPortMin	Le numéro de port le moins élevé d’une plage de numéros de ports locaux.
LocalPortMax	Le numéro de port le plus élevé d’une plage de numéros de ports locaux.
RemotePortMax	Le numéro de port le moins élevé d’une plage de numéros de ports distants.
RemotePortMax	Le numéro de port le plus élevé d’une plage de numéros de ports distants.
Profil	Le type de réseau

Exemple

<Package
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="desktop2">
  <Extensions>
    <desktop2:Extension Category="windows.firewallRules">
      <desktop2:FirewallRules Executable="Contoso.exe">
          <desktop2:Rule Direction="in" IPProtocol="TCP" Profile="all"/>
          <desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="domain"/>
          <desktop2:Rule Direction="in" IPProtocol="UDP" LocalPortMin="1337" LocalPortMax="1338" Profile="public"/>
          <desktop2:Rule Direction="out" IPProtocol="UDP" LocalPortMin="1339" LocalPortMax="1340" RemotePortMin="15"
                         RemotePortMax="19" Profile="domainAndPrivate"/>
          <desktop2:Rule Direction="out" IPProtocol="GRE" Profile="private"/>
      </desktop2:FirewallRules>
  </desktop2:Extension>
</Extensions>
</Package>

Placer vos fichiers DLL dans n'importe quel dossier du package

Utilisez l’extension uap6:LoaderSearchPathOverride pour déclarer jusqu’à cinq chemins de dossier dans le package d’application, relatifs au chemin racine du package d’application, à utiliser dans le chemin de recherche du chargeur pour les processus de l’application.

L’ordre de recherche de DLL pour les applications Windows comprend des packages dans le graphe de dépendances de package si les packages ont des droits d’exécution. Par défaut, cela comprend les packages principaux, facultatifs et de framework, même s’ils peuvent être remplacés par l’élément uap6:AllowExecution dans le manifeste du package.

Par défaut, un package inclus dans l’ordre de recherche de DLL inclut son chemin effectif. Pour plus d’informations sur les chemins effectifs, consultez la propriété EffectivePath (WinRT) et l’énumération PackagePathType (Win32).

Si un package spécifie uap6:LoaderSearchPathOverride, cette information est utilisée à la place du chemin effectif du package.

Chaque package ne peut contenir qu’une seule extension uap6:LoaderSearchPathOverride. En d'autres termes, vous pouvez ajouter l'une d'elles à votre package principal, puis en ajouter une à chacun de vos packages facultatifs et ensembles relatifs.

espace de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10/6

Éléments et attributs de cette extension

Déclarez cette extension au niveau du package de votre manifeste d'application.

<Extension Category="windows.loaderSearchPathOverride">
  <LoaderSearchPathOverride>
    <LoaderSearchPathEntry FolderPath="[path]"/>
  </LoaderSearchPathOverride>
</Extension>

Nom Description

Category Toujours windows.loaderSearchPathOverride.

FolderPath Chemin du dossier qui contient vos fichiers DLL. Spécifiez un chemin relatif au dossier racine du package. Vous pouvez spécifier un maximum de cinq chemins dans une extension. Si vous souhaitez que le système recherche les fichiers dans le dossier racine du package, utilisez une chaîne vide pour l'un de ces chemins. N’incluez aucun chemin dupliqué, et vérifiez que vos chemins ne commencent ni ne se terminent par aucune barre oblique ou barre oblique inverse.

Le système ne recherchera pas les sous-dossiers. Veillez donc à répertorier explicitement chacun des dossiers contenant des fichiers DLL que le système doit charger.

Nom	Description
Category	Toujours `windows.loaderSearchPathOverride`.
FolderPath	Chemin du dossier qui contient vos fichiers DLL. Spécifiez un chemin relatif au dossier racine du package. Vous pouvez spécifier un maximum de cinq chemins dans une extension. Si vous souhaitez que le système recherche les fichiers dans le dossier racine du package, utilisez une chaîne vide pour l'un de ces chemins. N’incluez aucun chemin dupliqué, et vérifiez que vos chemins ne commencent ni ne se terminent par aucune barre oblique ou barre oblique inverse. Le système ne recherchera pas les sous-dossiers. Veillez donc à répertorier explicitement chacun des dossiers contenant des fichiers DLL que le système doit charger.

Exemple

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/6"
  IgnorableNamespaces="uap6">
  ...
    <Extensions>
      <uap6:Extension Category="windows.loaderSearchPathOverride">
        <uap6:LoaderSearchPathOverride>
          <uap6:LoaderSearchPathEntry FolderPath=""/>
          <uap6:LoaderSearchPathEntry FolderPath="folder1/subfolder1"/>
          <uap6:LoaderSearchPathEntry FolderPath="folder2/subfolder2"/>
        </uap6:LoaderSearchPathOverride>
      </uap6:Extension>
    </Extensions>
...
</Package>

Intégration avec l’Explorateur de fichiers

Aidez les utilisateurs à organiser vos fichiers et à interagir avec eux naturellement.

Définir le comportement de votre application lorsque les utilisateurs sélectionnent et ouvrent plusieurs fichiers en même temps
Afficher le contenu du fichier dans une image miniature dans l’Explorateur de fichiers
Afficher le contenu du fichier dans un volet de visualisation de l’Explorateur de fichiers
Permettre aux utilisateurs de grouper des fichiers à l’aide de la colonne Type dans l’Explorateur de fichiers
Mettre à disposition les propriétés du fichier pour la recherche, les index, les boîtes de dialogue des propriétés et le volet d’informations
Spécifier un gestionnaire de menu contextuel pour un type de fichier
Permettre l'affichage des fichiers de votre service cloud dans l'explorateur de fichiers

Définir le comportement de votre application lorsque les utilisateurs sélectionnent et ouvrent plusieurs fichiers en même temps

Spécifier le comportement de votre application lorsqu’un utilisateur ouvre plusieurs fichiers simultanément.

espaces de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/2
http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Éléments et attributs de cette extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]" MultiSelectModel="[SelectionModel]">
        <SupportedVerbs>
            <Verb Id="Edit" MultiSelectModel="[SelectionModel]">Edit</Verb>
        </SupportedVerbs>
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.fileTypeAssociation`.
Nom	Nom de l’association de types de fichiers. Vous pouvez utiliser ce nom pour organiser et regrouper des types de fichiers. Le nom doit contenir uniquement des minuscules, sans espace.
MultiSelectModel	Voir ci-dessous
FileType	Les extensions de fichier appropriées.

MultiSelectModel

Les applications de bureau empaquetées présentent les trois mêmes options que les applications de bureau standard.

Player : Votre application est activée une seule fois. Tous les fichiers sélectionnés sont transmis à votre application en tant que paramètres d’argument.
Single : votre application est activée une fois pour le premier fichier sélectionné. Les autres fichiers sont ignorés.
Document : une nouvelle instance distincte de votre application est activée pour chaque fichier sélectionné.

Vous pouvez définir des préférences spécifiques pour les différents types de fichiers et d’actions. Par exemple, il se peut que vous souhaitiez ouvrir les documents en mode Document et les images en mode Player.

Exemple

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap, uap2, uap3">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes" MultiSelectModel="Document">
            <uap2:SupportedVerbs>
              <uap3:Verb Id="Edit" MultiSelectModel="Player">Edit</uap3:Verb>
              <uap3:Verb Id="Preview" MultiSelectModel="Document">Preview</uap3:Verb>
            </uap2:SupportedVerbs>
            <uap:SupportedFileTypes>
              <uap:FileType>.txt</uap:FileType>
            </uap:SupportedFileTypes>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Si l’utilisateur ouvre jusqu’à 15 fichiers, le choix par défaut pour l’attribut MultiSelectModel est Player. Autrement, la valeur par défaut est Document. Les applications UWP sont toujours démarrées en mode Player.

Afficher le contenu du fichier dans une image miniature dans l’Explorateur de fichiers

Permettez aux utilisateurs d’afficher une image miniature du contenu du fichier lorsque l’icône du fichier s’affiche en taille moyenne, grande ou très grande.

espace de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/2
http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Éléments et attributs de cette extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <ThumbnailHandler
            Clsid  ="[Clsid  ]" />
    </FileTypeAssociation>
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.fileTypeAssociation`.
Nom	Nom de l’association de types de fichiers. Vous pouvez utiliser ce nom pour organiser et regrouper des types de fichiers. Le nom doit contenir uniquement des minuscules, sans espace.
FileType	Les extensions de fichier appropriées.
Clsid	L’ID de classe de votre application.

Exemple

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap2, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
            </uap:SupportedFileTypes>
            <desktop2:ThumbnailHandler
              Clsid  ="20000000-0000-0000-0000-000000000001"  />
            </uap3:FileTypeAssociation>
         </uap::Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Afficher le contenu du fichier dans le volet de visualisation de l’Explorateur de fichiers

Permettez aux utilisateurs d’afficher un aperçu du contenu d’un fichier dans le volet de visualisation de l’Explorateur de fichiers.

espace de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/2
http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Éléments et attributs de cette extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <DesktopPreviewHandler Clsid  ="[Clsid  ]" />
    </FileTypeAssociation>
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.fileTypeAssociation`.
Nom	Nom de l’association de types de fichiers. Vous pouvez utiliser ce nom pour organiser et regrouper des types de fichiers. Le nom doit contenir uniquement des minuscules, sans espace.
FileType	Les extensions de fichier appropriées.
Clsid	L’ID de classe de votre application.

Exemple

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap2="http://schemas.microsoft.com/appx/manifest/uap/windows10/2"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap2, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
                </uap:SupportedFileTypes>
              <desktop2:DesktopPreviewHandler Clsid ="20000000-0000-0000-0000-000000000001" />
           </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Permettre aux utilisateurs de grouper des fichiers à l’aide de la colonne Type dans l’Explorateur de fichiers

Vous pouvez associer une ou plusieurs valeurs prédéfinies pour vos types de fichiers avec le champ Type.

Dans l’Explorateur de fichiers, les utilisateurs peuvent regrouper ces fichiers à l’aide de ce champ. Les composants du système utilisent également ce champ à différentes fins, telles que l’indexation.

Pour plus d’informations sur le champ Type et les valeurs que vous pouvez utiliser pour ce champ, consultez Utilisation des noms de type.

espaces de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3

Éléments et attributs de cette extension

<Extension Category="windows.fileTypeAssociation">
    <FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>"[FileExtension]"</FileType>
        </SupportedFileTypes>
        <KindMap>
            <Kind value="[KindValue]">
        </KindMap>
    </FileTypeAssociation>
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.fileTypeAssociation`.
Nom	Nom de l’association de types de fichiers. Vous pouvez utiliser ce nom pour organiser et regrouper des types de fichiers. Le nom doit contenir uniquement des minuscules, sans espace.
FileType	Les extensions de fichier appropriées.
value	Une valeur de type valide

Exemple

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities/3"
  IgnorableNamespaces="uap, rescap">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
           <uap:FileTypeAssociation Name="mediafiles">
             <uap:SupportedFileTypes>
               <uap:FileType>.m4a</uap:FileType>
               <uap:FileType>.mta</uap:FileType>
             </uap:SupportedFileTypes>
             <rescap:KindMap>
               <rescap:Kind value="Item">
               <rescap:Kind value="Communications">
               <rescap:Kind value="Task">
             </rescap:KindMap>
          </uap:FileTypeAssociation>
      </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Mettre à disposition les propriétés du fichier pour la recherche, les index, les boîtes de dialogue des propriétés et le volet d’informations

espace de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10
http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Éléments et attributs de cette extension

<uap:Extension Category="windows.fileTypeAssociation">
    <uap:FileTypeAssociation Name="[Name]">
        <SupportedFileTypes>
            <FileType>.bar</FileType>
        </SupportedFileTypes>
        <DesktopPropertyHandler Clsid ="[Clsid]"/>
    </uap:FileTypeAssociation>
</uap:Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.fileTypeAssociation`.
Nom	Nom de l’association de types de fichiers. Vous pouvez utiliser ce nom pour organiser et regrouper des types de fichiers. Le nom doit contenir uniquement des minuscules, sans espace.
FileType	Les extensions de fichier appropriées.
Clsid	L’ID de classe de votre application.

Exemple

<Package
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="uap, uap3, desktop2">
  <Applications>
    <Application>
      <Extensions>
        <uap:Extension Category="windows.fileTypeAssociation">
          <uap3:FileTypeAssociation Name="myfiletypes">
            <uap:SupportedFileTypes>
              <uap:FileType>.bar</uap:FileType>
            </uap:SupportedFileTypes>
            <desktop2:DesktopPropertyHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
          </uap3:FileTypeAssociation>
        </uap:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Si votre application de bureau définit un gestionnaire de menu contextuel, utilisez cette extension pour enregistrer le gestionnaire de menu.

espaces de noms XML

http://schemas.microsoft.com/appx/manifest/foundation/windows10
http://schemas.microsoft.com/appx/manifest/desktop/windows10/4

Éléments et attributs de cette extension

<Extensions>
    <com:Extension Category="windows.comServer">
        <com:ComServer>
            <com:SurrogateServer AppId="[AppID]" DisplayName="[DisplayName]">
                <com:Class Id="[Clsid]" Path="[Path]" ThreadingModel="[Model]"/>
            </com:SurrogateServer>
        </com:ComServer>
    </com:Extension>
    <desktop4:Extension Category="windows.fileExplorerContextMenus">
        <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type="[Type]">
                <desktop4:Verb Id="[ID]" Clsid="[Clsid]" />
            </desktop4:ItemType>
        </desktop4:FileExplorerContextMenus>
    </desktop4:Extension>
</Extensions>

Vous trouverez la référence complète du schéma ici : com:ComServer et desktop4:FileExplorerContextMenus.

Instructions

Pour enregistrer votre gestionnaire de menu contextuel, suivez ces instructions.

Dans votre application de bureau, implémentez un gestionnaire de menu contextuel en implémentant l'interface IExplorerCommand ou IExplorerCommandState. Pour obtenir un exemple, consultez l'exemple de code ExplorerCommandVerb. Veillez à définir un GUID de classe pour chacun de vos objets d’implémentation. Par exemple, le code suivant définit un ID de classe pour une implémentation de IExplorerCommand.
```
class __declspec(uuid("00001111-aaaa-2222-bbbb-3333cccc4444")) CExplorerCommandVerb;
```

Dans le manifeste de votre package, spécifiez une extension d'application com:ComServer qui enregistre un serveur de substitution COM avec l'ID de classe de votre implémentation de gestionnaire de menu contextuel.

<com:Extension Category="windows.comServer">
    <com:ComServer>
        <com:SurrogateServer AppId="00001111-aaaa-2222-bbbb-3333cccc4444" DisplayName="ContosoHandler">
            <com:Class Id="00001111-aaaa-2222-bbbb-3333cccc4444" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
        </com:SurrogateServer>
    </com:ComServer>
</com:Extension>

Dans le manifeste de votre package, spécifiez une extension d'application desktop4:FileExplorerContextMenus qui enregistre votre implémentation de gestionnaire de menu contextuel.

<desktop4:Extension Category="windows.fileExplorerContextMenus">
    <desktop4:FileExplorerContextMenus>
        <desktop4:ItemType Type=".rar">
            <desktop4:Verb Id="Command1" Clsid="00001111-aaaa-2222-bbbb-3333cccc4444" />
        </desktop4:ItemType>
    </desktop4:FileExplorerContextMenus>
</desktop4:Extension>

Exemple

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  xmlns:desktop4="http://schemas.microsoft.com/appx/manifest/desktop/windows10/4"
  xmlns:com="http://schemas.microsoft.com/appx/manifest/com/windows10"
  IgnorableNamespaces="desktop4">
  <Applications>
    <Application>
      <Extensions>
        <com:Extension Category="windows.comServer">
          <com:ComServer>
            <com:SurrogateServer AppId="00001111-aaaa-2222-bbbb-3333cccc4444" DisplayName="ContosoHandler">
              <com:Class Id="00001111-aaaa-2222-bbbb-3333cccc4444" Path="ExplorerCommandVerb.dll" ThreadingModel="STA"/>
            </com:SurrogateServer>
          </com:ComServer>
        </com:Extension>
        <desktop4:Extension Category="windows.fileExplorerContextMenus">
          <desktop4:FileExplorerContextMenus>
            <desktop4:ItemType Type=".contoso">
              <desktop4:Verb Id="Command1" Clsid="00001111-aaaa-2222-bbbb-3333cccc4444" />
            </desktop4:ItemType>
          </desktop4:FileExplorerContextMenus>
        </desktop4:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Permettre l'affichage des fichiers de votre service cloud dans l'explorateur de fichiers

Inscrivez les gestionnaires que vous souhaitez implémenter dans votre application. Vous pouvez également ajouter des options de menu local qui apparaîtront lorsque les utilisateurs cliquent avec le bouton droit sur vos fichiers cloud dans l'explorateur de fichier.

espace de noms XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10

Éléments et attributs de cette extension

<Extension Category="windows.cloudfiles" >
    <CloudFiles IconResource="[Icon]">
        <CustomStateHandler Clsid ="[Clsid]"/>
        <ThumbnailProviderHandler Clsid ="[Clsid]"/>
        <ExtendedPropertyhandler Clsid ="[Clsid]"/>
        <CloudFilesContextMenus>
            <Verb Id ="Command3" Clsid= "[GUID]">[Verb Label]</Verb>
        </CloudFilesContextMenus>
    </CloudFiles>
</Extension>

Nom	Description
Category	Toujours `windows.cloudfiles`.
iconResource	L'icône représentant votre service fournisseur de fichier cloud. L'icône apparaît dans le volet Navigation de l'explorateur de fichier. Les utilisateurs sélectionnent cette icône pour afficher les fichiers provenant de votre service cloud.
CustomStateHandler Clsid	L’ID de classe de l’application qui implémente l'élément CustomStateHandler. Le système utilise cet ID de classe pour demander les états et colonnes personnalisés des fichiers cloud.
ThumbnailProviderHandler Clsid	L’ID de classe de l’application qui implémente l'élément ThumbnailProviderHandler. Le système utilise cet ID de classe pour demander les images miniatures des fichiers cloud.
ExtendedPropertyHandler Clsid	L’ID de classe de l’application qui implémente l'élément ExtendedPropertyHandler. Le système utilise cet ID de classe pour demander les propriétés étendues d'un fichier cloud.
Verbe	Le nom qui apparaît dans le menu local de l'explorateur de fichier pour les fichiers fournis par votre service cloud.
Id	L’ID unique du verbe.

Exemple

<Package
    xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
    IgnorableNamespaces="desktop">
  <Applications>
    <Application>
      <Extensions>
        <Extension Category="windows.cloudfiles" >
            <CloudFiles IconResource="images\Wide310x150Logo.png">
                <CustomStateHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <ThumbnailProviderHandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <ExtendedPropertyhandler Clsid ="20000000-0000-0000-0000-000000000001"/>
                <desktop:CloudFilesContextMenus>
                    <desktop:Verb Id ="keep" Clsid=
                       "20000000-0000-0000-0000-000000000001">
                       Always keep on this device</desktop:Verb>
                </desktop:CloudFilesContextMenus>
            </CloudFiles>
          </Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Démarrer votre application de différentes manières

Démarrer votre application à l’aide d’un protocole
Démarrer votre application à l’aide d’un alias
Démarrer un fichier exécutable lorsque les utilisateurs se connectent à Windows
Permettre aux utilisateurs de démarrer votre application lorsqu'ils connectent à un appareil à leur PC
Redémarrer automatiquement après avoir reçu une mise à jour à partir du Microsoft Store

Démarrer votre application à l’aide d’un protocole

Les associations de protocole permettent l’interopérabilité entre votre application empaquetée et les autres programmes et composants système. Lorsque votre application empaquetée est démarrée à l’aide d’un protocole, vous pouvez spécifier des paramètres spécifiques à transmettre à ses arguments d’événement d’activation afin qu’elle puisse se comporter en conséquence. Les paramètres sont pris en charge uniquement pour les applications empaquetées et de confiance totale. Les applications UWP ne peuvent pas utiliser de paramètres.

espace de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10/3

Éléments et attributs de cette extension

<Extension
    Category="windows.protocol">
  <Protocol
      Name="[Protocol name]"
      Parameters="[Parameters]" />
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.protocol`.
Nom	Nom du protocole.
Paramètres	La liste des paramètres et des valeurs à transmettre en tant qu’arguments d’événement à votre application lorsqu’elle est activée. Si une variable peut contenir un chemin d’accès de fichier, placez la valeur du paramètre entre guillemets. Vous éviterez les problèmes qui se produisent dans les cas où le chemin d’accès contient des espaces.

Exemple

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="uap3, desktop">
  <Applications>
    <Application>
      <Extensions>
        <uap3:Extension
          Category="windows.protocol">
          <uap3:Protocol
            Name="myapp-cmd"
            Parameters="/p &quot;%1&quot;" />
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Démarrer votre application à l’aide d’un alias

Les utilisateurs et autres processus peuvent utiliser un alias pour démarrer votre application sans avoir à spécifier le chemin d’accès complet à votre application. Vous pouvez spécifier ce nom d’alias.

espaces de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10/3
http://schemas.microsoft.com/appx/manifest/desktop/windows10

Éléments et attributs de cette extension

<uap3:Extension
    Category="windows.appExecutionAlias"
    Executable="[ExecutableName]"
    EntryPoint="Windows.FullTrustApplication">
    <uap3:AppExecutionAlias>
        <desktop:ExecutionAlias Alias="[AliasName]" />
    </uap3:AppExecutionAlias>
</uap3:Extension>

Nom	Description
Category	Toujours `windows.appExecutionAlias`.
Exécutable	Le chemin d’accès relatif du fichier exécutable à démarrer lorsque l’alias est appelé.
Alias	Le nom court de votre application. Il doit toujours se terminer par l’extension « .exe ». Vous ne pouvez spécifier qu’un seul alias d’exécution d’application pour chaque application du package. Si plusieurs applications présentent le même alias, le système appellera la dernière inscrite. Prenez donc soin de choisir un alias peu susceptible d’être remplacé par d’autres applications.

Exemple

<Package
  xmlns:uap3="http://schemas.microsoft.com/appx/manifest/uap/windows10/3"
  IgnorableNamespaces="uap3">
  <Applications>
    <Application>
      <Extensions>
         <uap3:Extension
                Category="windows.appExecutionAlias"
                Executable="exes\launcher.exe"
                EntryPoint="Windows.FullTrustApplication">
            <uap3:AppExecutionAlias>
                <desktop:ExecutionAlias Alias="Contoso.exe" />
            </uap3:AppExecutionAlias>
        </uap3:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Vous trouverez la référence de schéma complète ici.

Démarrer un fichier exécutable lorsque les utilisateurs se connectent à Windows

Les tâches de démarrage permettent à votre application d’exécuter un fichier exécutable automatiquement dès qu’un utilisateur se connecte.

Notes

L’utilisateur doit démarrer votre application au moins une fois pour enregistrer cette tâche de démarrage.

Votre application peut déclarer plusieurs tâches de démarrage. Chaque tâche démarre indépendamment. Toutes les tâches de démarrage apparaissent dans le Gestionnaire des tâches sous l’onglet Démarrage avec le nom que vous spécifiez dans le manifeste de votre application et l’icône de votre application. Le Gestionnaire des tâches analyse automatiquement l’impact de vos tâches sur le démarrage.

Les utilisateurs peuvent désactiver manuellement la tâche de démarrage de votre application à l’aide du Gestionnaire des tâches. Si un utilisateur désactive une tâche, vous ne pouvez pas la réactiver par programme.

espace de noms XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10

Éléments et attributs de cette extension

<Extension
    Category="windows.startupTask"
    Executable="[ExecutableName]"
    EntryPoint="Windows.FullTrustApplication">
  <StartupTask
      TaskId="[TaskID]"
      Enabled="true"
      DisplayName="[DisplayName]" />
</Extension>

Nom	Description
Category	Toujours `windows.startupTask`.
Exécutable	Le chemin d’accès relatif au fichier exécutable à démarrer.
TaskId	Un identificateur unique pour votre tâche. À l’aide de cet identificateur, votre application peut appeler les API de la classe Windows.ApplicationModel.StartupTask pour activer ou désactiver une tâche de démarrage par programmation.
activé	Indique si la tâche est activée ou désactivée au démarrage. Les tâches activées seront exécutées la prochaine fois que l’utilisateur se connecte (sauf si celui-ci les désactive).
DisplayName	Le nom de la tâche qui s’affiche dans le Gestionnaire des tâches. Vous pouvez localiser cette chaîne à l’aide de `ms-resource`.

Exemple

<Package
  xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10"
  IgnorableNamespaces="desktop">
  <Applications>
    <Application>
      <Extensions>
        <desktop:Extension
          Category="windows.startupTask"
          Executable="bin\MyStartupTask.exe"
          EntryPoint="Windows.FullTrustApplication">
        <desktop:StartupTask
          TaskId="MyStartupTask"
          Enabled="true"
          DisplayName="My App Service" />
        </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
 </Package>

Permettre aux utilisateurs de démarrer votre application lorsqu'ils connectent à un appareil à leur PC

La lecture automatique peut présenter votre application en tant qu’option lorsque l’utilisateur connecte un périphérique à son PC.

espace de noms XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10/3

Éléments et attributs de cette extension

<Extension Category="windows.autoPlayHandler">
  <AutoPlayHandler>
    <InvokeAction ActionDisplayName="[action string]" ProviderDisplayName="[name of your app/service]">
      <Content ContentEvent="[Content event]" Verb="[any string]" DropTargetHandler="[Clsid]" />
      <Content ContentEvent="[Content event]" Verb="[any string]" Parameters="[Initialization parameter]"/>
      <Device DeviceEvent="[Device event]" HWEventHandler="[Clsid]" InitCmdLine="[Initialization parameter]"/>
    </InvokeAction>
  </AutoPlayHandler>

Nom	Description
Category	Toujours `windows.autoPlayHandler`.
ActionDisplayName	Une chaîne représentant l'action que les utilisateurs peuvent choisir avec un appareil qu'ils connectent à un PC (par exemple : « Importer les fichiers » ou « Lire la vidéo »).
ProviderDisplayName	Une chaîne qui représente votre application ou service (par exemple : « Lecteur vidéo Contoso »).
ContentEvent	Le nom d’un événement de contenu qui envoie une invite aux utilisateurs avec vos éléments `ActionDisplayName` et `ProviderDisplayName`. Les événements de contenu se déclenchent lorsqu’un périphérique de volume, tel que la carte mémoire d’un appareil photo, une clé USB ou un DVD, est inséré dans le PC. Vous trouverez la liste complète de ces événements ici.
Verbe	Le paramètre Verbe identifie une valeur qui est transmise à votre application pour l’option sélectionnée. Vous pouvez spécifier plusieurs options de lancement pour un événement de lecture automatique et utiliser le paramètre Verbe pour déterminer l’option sélectionnée par l’utilisateur pour votre application. Vous pouvez savoir quelle option l’utilisateur a sélectionnée en vérifiant la propriété verb des arguments de l’événement de démarrage transmis à votre application. Vous pouvez attribuer n’importe quelle valeur au paramètre Verbe, sauf la valeur open qui est réservée.
DropTargetHandler	L’ID de classe de l’application qui implémente l'interface IDropTarget. Les fichiers du média amovibles sont transmis à la méthode Drop de votre implémentation IDropTarget.
Paramètres	Vous n'êtes pas obligé d'implémenter l'interface IDropTarget pour tous les événements de contenu. Pour tous les événements de contenu, vous avez la possibilité de fournir des paramètres de ligne de commande au lieu d'implémenter l'interface IDropTarget. Pour ces événements, la lecture automatique démarre votre application en utilisant ces paramètres de ligne de commande. Vous pouvez analyser ces paramètres dans le code d'initialisation de votre application afin de déterminer s'il a été démarré par la lecture automatique, puis fournir votre implémentation par défaut.
DeviceEvent	Le nom d’un événement d'appareil qui envoie une invite aux utilisateurs avec vos éléments `ActionDisplayName` et `ProviderDisplayName`. Un événement d'appareil est déclenché lorsqu’un appareil est connecté au PC. Les événements d'appareil commencent par la chaîne `WPD`. Ils sont répertoriés ici.
HWEventHandler	L’ID de classe de l’application qui implémente l'interface IHWEventHandler.
InitCmdLine	Le paramètre de chaîne que vous souhaitez transmettre dans la méthode Initialiser de l'interface IHWEventHandler.

Exemple

<Package
  xmlns:desktop3="http://schemas.microsoft.com/appx/manifest/desktop/windows10/3"
  IgnorableNamespaces="desktop3">
  <Applications>
    <Application>
      <Extensions>
        <desktop3:Extension Category="windows.autoPlayHandler">
          <desktop3:AutoPlayHandler>
            <desktop3:InvokeAction ActionDisplayName="Import my files" ProviderDisplayName="ms-resource:AutoPlayDisplayName">
              <desktop3:Content ContentEvent="ShowPicturesOnArrival" Verb="show" DropTargetHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8"/>
              <desktop3:Content ContentEvent="PlayVideoFilesOnArrival" Verb="play" Parameters="%1" />
              <desktop3:Device DeviceEvent="WPD\ImageSource" HWEventHandler="CD041BAE-0DEA-4472-9B7B-C98043D26EA8" InitCmdLine="/autoplay"/>
            </desktop3:InvokeAction>
          </desktop3:AutoPlayHandler>
      </Extensions>
    </Application>
  </Applications>
</Package>

Redémarrer automatiquement après avoir reçu une mise à jour à partir du Microsoft Store

Si votre application est ouverte lorsque les utilisateurs installent une mise à jour, l’application se ferme.

Si vous souhaitez que cette application redémarre une fois la mise à jour terminée, appelez la fonction RegisterApplicationRestart dans chaque processus que vous souhaitez redémarrer.

Chaque fenêtre active dans votre application reçoit un message WM_QUERYENDSESSION. À ce stade, votre application peut rappeler la fonction RegisterApplicationRestart pour mettre à jour la ligne de commande, si nécessaire.

Lorsque chaque fenêtre active dans votre application reçoit le message WM_ENDSESSION, votre application doit enregistrer les données et s'arrêter.

Notes

Votre fenêtre active reçoit également le message WM_CLOSE au cas où l’application ne gère pas le message WM_ENDSESSION.

À ce stade, votre application dispose de 30 secondes pour fermer ses propres processus, sinon la plateforme les arrête de manière forcée.

Une fois la mise à jour terminée, votre application redémarre.

Utiliser d’autres applications

Intégration avec d’autres applications, démarrer d’autres processus ou partager des informations.

Afficher votre application en tant que cible d’impression dans des applications qui prennent en charge l’impression
Partager des polices avec d’autres applications Windows
Démarrer un processus Win32 à partir d’une application de plateforme Windows universelle (UWP)

Afficher votre application en tant que cible d’impression dans des applications qui prennent en charge l’impression

Lorsque les utilisateurs souhaitent imprimer des données à partir d’une autre application, telle que le Bloc-notes Windows, vous pouvez afficher votre application comme cible d’impression dans la liste des cibles d’impression disponibles de l’application.

Vous devrez modifier votre application afin qu’elle reçoive les données d’impression au format XML Paper Specification (XPS).

espaces de noms XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10/2

Éléments et attributs de cette extension

<Extension Category="windows.appPrinter">
    <AppPrinter
        DisplayName="[DisplayName]"
        Parameters="[Parameters]" />
</Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.appPrinter`.
DisplayName	Le nom que vous souhaitez voir apparaître dans la liste des cibles d’impression pour une application.
Paramètres	Tous les paramètres dont votre application a besoin pour gérer correctement la demande.

Exemple

<Package
  xmlns:desktop2="http://schemas.microsoft.com/appx/manifest/desktop/windows10/2"
  IgnorableNamespaces="desktop2">
  <Applications>
  <Application>
    <Extensions>
      <desktop2:Extension Category="windows.appPrinter">
        <desktop2:AppPrinter
          DisplayName="Send to Contoso"
          Parameters="/insertdoc %1" />
      </desktop2:Extension>
    </Extensions>
  </Application>
</Applications>
</Package>

Trouver un exemple qui utilise cette extension ici

Partagez vos polices personnalisées avec d’autres applications Windows.

Notes

Avant de pouvoir soumettre au Store une application qui utilise cette extension, vous devez obtenir l’approbation de l’équipe du Store. Pour cela, accédez à https://aka.ms/storesupport, cliquez sur Nous contacter, puis choisissez les options qui concernent la soumission d’applications au tableau de bord. Ce processus d’approbation permet de s’assurer qu’il n’y a pas de conflits entre les polices installées par votre application et celles installées avec le système d’exploitation. Si vous n’obtenez pas d’approbation, vous recevrez une erreur semblable à la suivante quand vous soumettrez votre application : « Erreur de validation de l’acceptation du package : Vous ne pouvez pas utiliser l’extension windows.sharedFonts avec ce compte. Contactez notre équipe du support technique si vous souhaitez demander des autorisations pour l’utiliser. »

espaces de noms XML

http://schemas.microsoft.com/appx/manifest/uap/windows10/4

Éléments et attributs de cette extension

<Extension Category="windows.sharedFonts">
    <SharedFonts>
      <Font File="[FontFile]" />
    </SharedFonts>
  </Extension>

Vous trouverez la référence de schéma complète ici.

Nom	Description
Category	Toujours `windows.sharedFonts`.
Fichier	Le fichier qui contient les polices que vous souhaitez partager.

Exemple

<Package
  xmlns:uap4="http://schemas.microsoft.com/appx/manifest/uap/windows10/4"
  IgnorableNamespaces="uap4">
  <Applications>
    <Application>
      <Extensions>
        <uap4:Extension Category="windows.sharedFonts">
          <uap4:SharedFonts>
            <uap4:Font File="Fonts\JustRealize.ttf" />
            <uap4:Font File="Fonts\JustRealizeBold.ttf" />
          </uap4:SharedFonts>
        </uap4:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Démarrer un processus Win32 à partir d’une application de plateforme Windows universelle (UWP)

Démarrer un processus Win32 qui s’exécute en mode de confiance totale.

espaces de noms XML

http://schemas.microsoft.com/appx/manifest/desktop/windows10

Éléments et attributs de cette extension

<Extension Category="windows.fullTrustProcess" Executable="[executable file]">
  <FullTrustProcess>
    <ParameterGroup GroupId="[GroupID]" Parameters="[Parameters]"/>
  </FullTrustProcess>
</Extension>

Nom	Description
Category	Toujours `windows.fullTrustProcess`.
GroupID	Une chaîne qui identifie un ensemble de paramètres que vous souhaitez transmettre au fichier exécutable.
Paramètres	Paramètres que vous souhaitez transmettre au fichier exécutable.

Exemple

<Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
         xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
         xmlns:rescap=
"http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
         xmlns:desktop="http://schemas.microsoft.com/appx/manifest/desktop/windows10">
  ...
  <Capabilities>
      <rescap:Capability Name="runFullTrust"/>
  </Capabilities>
  <Applications>
    <Application>
      <Extensions>
          <desktop:Extension Category="windows.fullTrustProcess" Executable="fulltrustprocess.exe">
              <desktop:FullTrustProcess>
                  <desktop:ParameterGroup GroupId="SyncGroup" Parameters="/Sync"/>
                  <desktop:ParameterGroup GroupId="OtherGroup" Parameters="/Other"/>
              </desktop:FullTrustProcess>
           </desktop:Extension>
      </Extensions>
    </Application>
  </Applications>
</Package>

Cette extension peut être utile si vous souhaitez créer une interface utilisateur de plateforme Windows universelle qui s’exécute sur tous les appareils, mais que vous souhaitez que les composants de votre application Win32 poursuivent leur exécution en mode de confiance totale.

Il vous suffit de créer un package d’application Windows pour votre application Win32. Ensuite, ajoutez cette extension au fichier de package de votre application UWP. Cette extension indique que vous souhaitez démarrer un fichier exécutable dans le package d’application Windows. Si vous souhaitez communiquer entre votre application UWP et votre application Win32, vous pouvez configurer un ou plusieurs services d’application pour ce faire. Pour en savoir plus sur ce scénario, reportez-vous ici.

Étapes suivantes

Des questions ? Contactez-nous sur Stack Overflow. Notre équipe supervise ces étiquettes. Vous pouvez également nous poser vos questions ici.

Partager via

Intégrez votre application de bureau à Windows à l’aide des extensions de package.

Migrer les utilisateurs vers votre application

Rediriger votre application de bureau existante vers votre application empaquetée

Ajouter des entrées de Registre pour rediriger l’exécutable de votre application de bureau non empaquetée

Inscrire votre application empaquetée à lancer

Désactiver la redirection

espaces de noms XML

Éléments et attributs de cette extension

Pointer les vignettes existantes de l’écran de démarrage et les boutons de barre des tâches vers votre application empaquetée

Espace de noms XML

Éléments et attributs de cette extension

Exemple

Exemple connexe

Ouvrir des fichiers à l’aide de votre application empaquetée au lieu de votre application de bureau

Espaces de noms XML

Éléments et attributs de cette extension

Exemple

Exemple connexe

Associer votre application empaquetée à un ensemble de types de fichiers

espaces de noms XML

Éléments et attributs de cette extension

Exemple

Exemple connexe

Ajouter des options aux menus contextuels de fichiers d'un certain type

espaces de noms XML

Éléments et attributs de cette extension

Exemple

Exemple connexe

Ouvrir certains types de fichiers directement à l’aide d’une URL

Espaces de noms XML

Éléments et attributs de cette extension

Exemple

Effectuer des tâches de configuration

Créer une exception de pare-feu pour votre application

espace de noms XML

Éléments et attributs de cette extension

Exemple

Placer vos fichiers DLL dans n'importe quel dossier du package

espace de noms XML

Éléments et attributs de cette extension

Exemple

Intégration avec l’Explorateur de fichiers

Définir le comportement de votre application lorsque les utilisateurs sélectionnent et ouvrent plusieurs fichiers en même temps

espaces de noms XML

Éléments et attributs de cette extension

Exemple

Afficher le contenu du fichier dans une image miniature dans l’Explorateur de fichiers

espace de noms XML

Éléments et attributs de cette extension

Exemple

Afficher le contenu du fichier dans le volet de visualisation de l’Explorateur de fichiers

espace de noms XML

Éléments et attributs de cette extension

Exemple

Permettre aux utilisateurs de grouper des fichiers à l’aide de la colonne Type dans l’Explorateur de fichiers

espaces de noms XML

Éléments et attributs de cette extension

Exemple

Mettre à disposition les propriétés du fichier pour la recherche, les index, les boîtes de dialogue des propriétés et le volet d’informations

espace de noms XML

Éléments et attributs de cette extension

Exemple

Spécifier un gestionnaire de menu contextuel pour un type de fichier

espaces de noms XML

Éléments et attributs de cette extension

Instructions

Exemple

Permettre l'affichage des fichiers de votre service cloud dans l'explorateur de fichiers

espace de noms XML

Éléments et attributs de cette extension

Exemple

Démarrer votre application de différentes manières

Démarrer votre application à l’aide d’un protocole

espace de noms XML

Éléments et attributs de cette extension

Exemple

Démarrer votre application à l’aide d’un alias

espaces de noms XML

Éléments et attributs de cette extension