Comment gérer l’activation des fichiers (applications du Windows Store en JavaScript et HTML)

Windows permet à une application de s’inscrire afin de devenir le gestionnaire par défaut pour un certain type de fichier. Les applications de bureau et les applications du Windows Store peuvent s’inscrire pour devenir un gestionnaire de fichiers par défaut. Si l’utilisateur choisit votre application en tant que gestionnaire par défaut pour un certain type de fichier, celle-ci sera activée à chaque lancement de ce type de fichier.

Vous devez vous inscrire uniquement pour un type de fichier si vous pensez gérer tous les lancements de fichiers pour ce type. Si votre application nécessite uniquement d’utiliser ce type de fichier en interne, vous ne devez pas vous inscrire pour devenir le gestionnaire par défaut. Si vous choisissez de vous inscrire pour un type de fichier, il est important que vous fournissiez à l’utilisateur final la fonctionnalité attendue lorsque votre application est activée pour ce type de fichier. Par exemple, une visionneuse d’images doit s’inscrire pour afficher un fichier .jpg. Pour plus d’informations sur les associations de fichiers, voir Recommandations et liste de vérification pour les types de fichiers et les URI.

Les étapes suivantes vous montrent comment s’inscrire pour un type de fichier personnalisé, .alsdk, et comment votre application peut être activée lorsque l’utilisateur lance un fichier .alsdk.

Instructions

Étape 1: Spécifier le point d’extension dans le manifeste du package

L’application reçoit des événements d’activation uniquement pour les extensions de fichiers répertoriées dans le manifeste du package. Procédez comme suit pour indiquer que votre application gère les fichiers portant l’extension .alsdk.

1. Double-cliquez pour ouvrir package.appxmanifest dans l’Explorateur de solutions.

   Pour plus d’informations sur les identificateurs utilisés par les associations de fichiers, voir Identificateurs programmatiques. Vous trouverez ci-dessous une brève description de chacun des champs que vous devez renseigner dans le manifeste du package :

   Champ	Description
   Type de contenu	Spécifiez le type de contenu MIME (par exemple, image/jpeg) pour un type de fichier particulier. Remarque importante sur les types de contenu autorisés:  Voici une liste alphabétique des types de contenu MIME que vous ne pouvez pas entrer dans le manifeste du package parce qu’ils sont réservés ou interdits : application/force-download, application/octet-stream, application/unknown, application/x-msdownload.
   Name	Choisissez un nom pour un groupe de types de fichiers partageant un nom complet, une info-bulle et des indicateurs de modification identiques. Choisissez un nom de groupe que vous pouvez conserver pour toutes les applications à mettre à jour. Remarque  Le nom doit être entièrement en minuscules.
   Info-bulle	Spécifiez l’info-bulle d’un groupe de types de fichiers. Cette info-bulle s’affiche lorsque l’utilisateur pointe sur l’icône d’un fichier de ce type avec la souris.
   Indicateurs de modification	Spécifiez les indicateurs de modification d’un groupe de types de fichiers. Les indicateurs de modification contrôlent l’accès à un fichier acquis à partir d’une source non fiable. L’indicateur OpenIsSafe signale que le verbe Open correspondant au type de fichier peut être appelé en toute sécurité pour tous les fichiers téléchargés. L’indicateur AlwaysUnsafe signale que l’option d’appel automatique du verbe Open est désactivée. L’utilisateur peut remplacer cet attribut dans la boîte de dialogue Type de fichier. L’utilisateur de cet indicateur signifie que la valeur OpenIsSafe n’est pas respectée. Il empêche l’activation de la case à cocher Ne plus poser cette question dans la boîte de dialogue de sécurité lors de l’ouverture de fichiers non approuvés de ce type.
   Nom complet	Spécifiez le nom complet d’un groupe de types de fichiers. Le nom complet sert à identifier le type de fichier dans l’option Définir les programmes par défaut du Panneau de configuration.
   Logo	Spécifiez le logo utilisé pour identifier le type de fichier sur le Bureau et dans l’option Définir les programmes par défaut du Panneau de configuration. Si aucune valeur n’est spécifiée pour Logo, le petit logo de l’application est utilisé.
   Type de fichier	Précisez le type de fichier à inscrire précédé d’un point (par exemple, « .jpeg »).

    

2. Sélectionnez l’onglet Déclarations.
3. Sélectionnez Associations de types de fichiers dans la liste déroulante, puis cliquez sur Ajouter.
4. Entrez alsdk comme Nom.
5. Entrez .alsdk comme Type de fichier.

   Remarque importante:  La liste alphabétique suivante recense les noms de types de fichiers que vous ne pouvez pas utiliser dans le manifeste du package car ils sont réservés ou interdits : Accountpicture-ms, Appx, application, Appref-ms, Bat, Cer, Chm, Cmd, Com, Cpl, crt, dll, drv, Exe, fon, gadget, Hlp, Hta, Inf ,Ins, jse, lnk, Msi, Msp, ocx, pif, Ps1, Reg, Scf, Scr, Shb, Shs, Sys, ttf, url, Vbe, Vbs, Ws, Wsc, Wsf, Wsh.

6. Entrez « images\Icon.png » comme logo.
7. Appuyez sur Ctrl+S pour enregistrer la modification dans package.appxmanifest.

Cette opération ajoute un élément Extension tel que celui-ci dans le manifeste du package. La catégorie windows.fileTypeAssociation indique que l’application gère les fichiers portant l’extension .alsdk.

<Package xmlns="http://schemas.microsoft.com/appx/2010/manifest">
   <Applications>
      <Application Id="AutoLaunch.App">
         <Extensions>
            <Extension Category="windows.fileTypeAssociation">
                <FileTypeAssociation Name="alsdk">
                  <DisplayName>SDK Sample File Type</DisplayName>
                  <Logo>images\logo.png</Logo>
                  <InfoTip>SDK Sample tip </InfoTip>
                  <EditFlags OpenIsSafe="true" />
                  <SupportedFileTypes>
                     <FileType ContentType="image/jpeg">.alsdk</FileType>
                  </SupportedFileTypes>
               </FileTypeAssociation>
            </Extension>
         </Extensions>
      </Application>
   </Applications>
</Package>

Étape 2: Ajouter les icônes appropriées

Les applications qui deviennent la valeur par défaut d’un type de fichier ont leurs icônes affichées à différents emplacements dans l’ensemble du système. Par exemple, ces icônes s’affichent dans :

• la vue d’éléments de l’Explorateur Windows, les menus contextuels et le Ruban ;
• l’applet Programmes par défaut du Panneau de configuration ;
• le sélecteur d’élément
• les résultats de recherche sur l’écran d’accueil.

Étape 3: Enregistrer l’événement activé

Inscrivez-vous pour l’événement activated pour gérer l’activation du fichier.

WinJS.Application.addEventListener("activated", onActivatedHandler, false);

Étape 4: Gérer l’événement activé

Le gestionnaire d’événements activated enregistré à l’étape 1 reçoit tous les événements d’activation. La propriété kind indique le type d’événement d’activation. Cet exemple est défini pour gérer les événements d’activation file.

function onActivatedHandler(eventArgs) {
   if (eventArgs.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.file) 
   {
       // TODO: Handle file activation.

       // The number of files received is eventArgs.detail.files.size
       // The first file is eventArgs.detail.files[0].name
   }
}

Remarques

Les fichiers que vous recevez peuvent provenir d’une source non approuvée. Vérifiez le contenu d’un fichier avant d’entreprendre une quelconque action sur ce fichier. Pour plus d’informations sur la validation d’entrée, voir Écriture de code sécurisé.

Exemple complet

Voir Exemple d’association pour un lancement d’application.

Rubriques associées

Concepts

Programmes par défaut

Modèle d’associations de types de fichiers et de protocoles

Tâches

Comment lancer l’application par défaut d’un fichier

Comment gérer l’activation du protocole

Recommandations

Recommandations et liste de vérification pour les types de fichiers et les protocoles

Référence

Windows.Storage.StorageFile

Windows.UI.WebUI.WebUIFileActivatedEventArgs

WinJS.Application.onactivated