Comment gérer l’activation des URI (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 nom de schéma d’URI. Les applications de bureau et les applications du Windows Store peuvent s’inscrire pour être gestionnaire par défaut pour un nom de schéma d’URI. Si l’utilisateur choisit votre application en tant que gestionnaire par défaut pour un nom de schéma d’URI, celle-ci sera activée à chaque lancement de ce type d’URI.

Vous devez vous inscrire pour un nom de schéma d’URI uniquement si vous pensez gérer tous les lancements d’URI pour ce type de schéma d’URI. Si vous choisissez de vous inscrire pour un nom de schéma d’URI, il est important que vous fournissiez à l’utilisateur final la fonctionnalité attendue lorsque votre application est activée pour ce schéma d’URI. Par exemple, une application qui s’inscrit pour le nom de schéma d’URI mailto: doit ouvrir un nouveau message électronique de sorte que l’utilisateur puisse composer un nouveau message électronique. Pour plus d’informations sur les associations de fichiers, voir Recommandations et liste de vérification sur les types de fichiers et les URI.

Les étapes suivantes vous montrent comment s’inscrire pour un nom de schéma d’URI personnalisé, alsdk://, et comment votre application peut être activée quand l’utilisateur lance un URI 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 noms de schémas d’URI répertoriées dans le manifeste du package. Procédez comme suit pour indiquer que votre application gère le nom de schéma d’URI alsdk.

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

    Voici une brève description de chacun des champs qu’il est possible de renseigner dans le formulaire ci-dessus :

    ChampDescription

    Nom

    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.

    Nom d’affichage

    Spécifiez le nom d’affichage pour identifier le nom de schéma d’URI dans l’applet Définir les programmes par défaut du Panneau de configuration.

    Logo

    Spécifiez le logo qui est utilisé pour identifier le nom de schéma d’URI dans l’applet 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é.

    Affichage souhaité

    Spécifiez le champ Desired View pour indiquer la quantité d’espace nécessaire à la fenêtre de l’application quand elle est lancée pour le nom de schéma d’URI. Les valeurs possibles de Desired View sont Default, UseLess, UseHalf, UseMore ou UseMinimum.

    Remarque  Windows tient compte de plusieurs facteurs différents pour déterminer la taille finale de la fenêtre de l’application cible, par exemple, la préférence de l’application source, le nombre d’applications à l’écran, l’orientation de l’écran, etc. La définition du champ Affichage souhaité ne garantit pas un comportement de fenêtrage spécifique pour l’application cible.

    Windows 8.1:  Desired View n’est pas pris en charge dans les versions antérieures à Windows 8.1 et Windows Server 2012 R2.

     

  2. Sélectionnez l’onglet Déclarations.
  3. Sélectionnez Protocole dans la liste déroulante, puis cliquez sur Ajouter.
  4. Entrez alsdk comme Nom.

    Remarque importante:  La liste alphabétique suivante recense les noms de schémas d’URI que vous ne pouvez pas utiliser dans le manifeste du package car ils sont réservés ou interdits : application.manifest, application.reference, batfile, blob, cerfile, chm.file, cmdfile, comfile, cplfile, dllfile, drvfile, exefile, explorer.assocactionid.burnselection, explorer.assocactionid.closesession, explorer.assocactionid.erasedisc, explorer.assocactionid.zipselection, explorer.assocprotocol.search-ms, explorer.burnselection, explorer.closesession, explorer.erasedisc, explorer.zipselection, file, fonfile, hlpfile, htafile, inffile , insfile, internetshortcut, jsefile, lnkfile, microsoft.powershellscript.1, ms-accountpictureprovider, ms-appdata, ms-appx, ms-autoplay, msi.package, msi.patch, ms-windows-store, ocxfile, piffile, regfile, scrfile, scriptletfile, shbfile, shcmdfile, shsfile,smb, sysfile, ttffile,unknown, usertileprovider,vbefile,vbsfile, windows.gadget,wsffile, wsfile,wshfile.

  5. Entrez « images\Icon.png » comme logo.
  6. 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.protocol indique que l’application gère le nom de schéma d’URI alsdk .



<Package xmlns="http://schemas.microsoft.com/appx/2010/manifest" xmlns:m2="http://schemas.microsoft.com/appx/2013/manifest">
   <Applications>
      <Application Id="AutoLaunch.App">
         <Extensions>
            <Extension Category="windows.protocol">
               <Protocol Name="alsdk" m2:DesiredView="useLess"/>
               <Logo>images\logo.png</Logo>										
               <DisplayName>SDK Sample URI Scheme</DisplayName>
            </Extension>			            
         </Extensions>
      </Application>
   </Applications>
</Package>

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

Les applications qui deviennent la valeur par défaut d’un nom de schéma d’URI ont leurs icônes affichées à différents emplacements dans l’ensemble du système, par exemple dans l’applet Programmes par défaut du Panneau de configuration.

Il est important d’inclure les icônes appropriées dans votre projet, afin que votre logo s’affiche correctement. Vous devez inclure les tailles 16/32/48/256 px pour le petit logo et les icônes dans votre dossier d’images. Ces icônes doivent correspondre à l’aspect du logo de la vignette de l’application avec des illustrations de couleurs intégrées. Vous devez tester vos icônes sur des arrière-plans blancs. Pour obtenir des exemples d’icônes, voir l’Exemple d’association pour un lancement d’application.

L’Explorateur de solutions avec un affichage des fichiers dans le dossier d’images. Des versions à 16, 32, 48 et 256 pixels de « Icon.targetsize » et de « smallTile-sdk » sont présentées.

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

Inscrivez-vous pour l’événement activated pour gérer l’activation de l’URI.


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 URI.


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

       // The received URI is eventArgs.detail.uri.rawUri
   }
}

Remarques

N’importe quelle application ou n’importe quel site Web peut utiliser votre nom de schéma d’URI, y compris des applications et sites malveillants. Par conséquent, toute donnée reçue dans cet URI peut provenir d’une source non approuvée. N’effectuez jamais une action permanente en fonction des paramètres que vous recevez dans un URI. Par exemple, les paramètres d’URI peuvent être utilisés pour lancer l’application sur la page de compte d’un utilisateur, mais ne doivent jamais être utilisés pour modifier directement le compte de l’utilisateur.

Remarque  Si vous créez un nom de schéma d’URI pour votre application, prenez soin de suivre les recommandations de la norme RFC 4395. Cela permet de garantir que votre nom respecte les normes applicables aux schémas d’URI.

Remarque  

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 d’URI
Guide de référence sur la compatibilité de Windows 8 Release Preview et de Windows Server 2012 RC (Informations sur le modèle utilisateur)
Tâches
Comment lancer l’application par défaut d’un URI
Comment gérer l’activation des fichiers
Recommandations
Recommandations et liste de vérification sur les types de fichiers et les URI
Référence
Windows.UI.WebUI.WebUIProtocolActivatedEventArgs
WinJS.Application.onactivated

 

 

Afficher:
© 2014 Microsoft. Tous droits réservés.