Étape 2 : Créer des métadonnées de périphérique pour votre application UWP pour périphériques

Article
03/06/2024

device app workflow, step 2.

Cette rubrique explique comment utiliser l’Assistant de création de métadonnées de périphérique pour créer de nouvelles métadonnées de périphérique qui associent votre application d’appareil UWP à un appareil. L’assistant peut également créer un fichier StoreManifest.xml que vous devrez peut-être ajouter à votre application à l’étape suivante.

Une application UWP pour périphérique est un type spécial d’application UWP que les fabricants de périphériques créent pour servir de compagnon à leur périphérique interne ou périphérique. En utilisant les métadonnées de périphérique, les applications de périphérique peuvent exécuter des opérations privilégiées et s’installer automatiquement lorsqu’un périphérique est branché. Pour plus d’informations sur les applications UWP pour périphériques, veuillez consulter la section Découvrir les applications UWP pour périphériques.

Ce sujet fait partie d’une série étape par étape. Veuillez vous rendre dans la section Créer une application UWP pour périphérique étape par étape pour lire l’introduction.

Avant de commencer

Pour utiliser l’Assistant de création de métadonnées de périphérique, vous devez installer Microsoft Visual Studio Professional, Microsoft Visual Studio Ultimate, ou le SDK autonome pour Windows 8.1, avant de compléter la procédure de cette rubrique. L’installation de Microsoft Visual Studio Express pour Windows installe une version du SDK qui n’inclut pas l’assistant.

Créer des métadonnées de périphérique

L’Assistant de création de métadonnées de périphérique est utilisé pour créer de nouvelles métadonnées de périphérique.

Pour créer de nouvelles métadonnées de périphérique

Lancez l’Assistant de création de métadonnées de périphérique depuis %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86, en double-cliquant sur DeviceMetadataWizard.exe.
Cliquez sur Nouvelles métadonnées de périphérique.
Sur la page Sélectionnez le type de package de métadonnées, cliquez sur métadonnées d’application UWP pour périphériques, puis sur Suivant.
Sur la page Sélectionnez les catégories de périphériques, sélectionnez les catégories de périphériques qui doivent être attribuées à votre périphérique. Un périphérique peut appartenir à plusieurs catégories de périphériques, mais seule une catégorie principale peut être attribuée. Sélectionnez Suivant.
Sur la page Spécifiez les paramètres régionaux, sélectionnez au moins un paramètre régional qui doit être associé au package de métadonnées du périphérique. Vous pouvez également définir un paramètre régional par défaut qui est utilisé lorsqu’un package spécifique à un paramètre régional n’est pas disponible sur l’ordinateur. Sélectionnez Suivant.
Sur la page Décrivez le périphérique, saisissez les informations qui sont affichées aux utilisateurs finaux lorsqu’ils branchent votre périphérique. Un nom de modèle et un fabricant sont requis pour chaque paramètre régional.
Sur la page Spécifiez les informations matérielles, ajoutez au moins un identifiant matériel et un identifiant de modèle. L’identifiant matériel doit inclure l’identifiant du fabricant pour votre entreprise. L’identifiant de modèle est un GUID et est la méthode recommandée pour associer les métadonnées de périphérique à des périphériques prenant en charge un identifiant de modèle. Sélectionnez Suivant.
Sur la page Spécifiez les informations de l’application UWP pour périphériques :
- Si vous souhaitez activer l’installation automatique pour votre application de périphérique, ou étendre l’expérience de caméra ou d’imprimante (ce qui nécessite une installation automatique), saisissez les informations de l’application Microsoft Store dans la zone Application UWP pour périphérique. Cliquez sur Importer le fichier manifeste de l’application UWP pour entrer automatiquement le Nom du package, le Nom de l’éditeur, et l’ID de l’application UWP.
  
  Avertissement
  
  Il est important de noter que la fonctionnalité d’installation automatique ne fournit pas de notification à l’utilisateur lorsque l’application est installée. Certains utilisateurs peuvent trouver cette expérience confuse et frustrante, ce qui pourrait entraîner une mauvaise note pour votre application.
- Si votre application s’inscrit pour des notifications d’imprimante, remplissez la boîte Gestionnaires de notifications. Dans ID de l’événement, saisissez le nom du gestionnaire d’événements d’impression. Dans Actif de l’événement, saisissez le nom du fichier où ce code réside.
- Si vous souhaitez spécifier votre application comme une application privilégiée, saisissez ces informations dans la zone Application privilégiée. La désignation d’application privilégiée permet à une application UWP pour périphériques d’effectuer des mises à jour de périphériques, telles que des mises à jour du firmware. Elle permet également aux OEM et aux fournisseurs de composants de développer des applications pour des périphériques internes.
Lorsque vous avez fini de spécifier les détails de l’installation automatique et de l’application privilégiée, cliquez sur Suivant.
Sur la page Spécifiez les paramètres Windows, vous pouvez configurer si le périphérique est affiché dans le Gestionnaire de périphériques lorsqu’il est déconnecté et comment le périphérique doit répondre à une activation AutoPlay.

Si vous souhaitez spécifier une application pour être le gestionnaire AutoPlay par défaut pour votre périphérique, sélectionnez Utiliser une application UWP pour périphérique dans la zone Gestionnaire AutoPlay. Vous pouvez sélectionner n’importe quelle application UWP ou application UWP pour périphérique, mais cette application doit gérer l’activation AutoPlay pour votre périphérique et spécifier l’identifiant d’expérience correspondant dans le manifeste du package de l’application (comme décrit dans AutoPlay pour les applications UWP pour périphériques).
- Nom du package : dans le manifeste du package d’application, il s’agit de l’attribut Name de l’élément Identity.
- Nom de l’éditeur : dans le manifeste du package d’application, il s’agit de l’attribut Publisher de l’élément Identity.
- ID d’application : dans le manifeste du package d’application, il s’agit de l’attribut ID de l’élément Application.
- Verb : il s’agit de l’identificateur pour l’activation de AutoPlay. Votre application l’utilisera pour déterminer si l’activation provient de votre appareil. Vous pouvez attribuer n’importe quelle valeur au paramètre Verbe, sauf open qui est réservée.
- Type d’événement AutoPlay : laissez cela en Appareil/Périphérique. Dans les métadonnées de l’appareil, l’Assistant spécifie automatiquement l’Identifiant d’expérience associé à votre application d’appareil UWP.
Si vous souhaitez laisser d’autres applications agir en tant que gestionnaires AutoPlay pour votre appareil, sélectionnez Activer AutoPlay pour les applications enregistrées.

Pour plus d’informations sur AutoPlay, veuillez consulter la section AutoPlay pour les applications UWP pour périphériques.
Lorsque vous êtes prêt à continuer, cliquez sur Suivant.
Sur la page Examiner le package de métadonnées du périphérique, assurez-vous que tous les paramètres sont corrects. Si vous souhaitez que ce package de métadonnées de périphérique soit disponible dans le magasin de métadonnées local, sélectionnez la case à cocher Copier le package de métadonnées de périphérique dans le magasin de métadonnées sur l’ordinateur local, puis cliquez sur Enregistrer.
Lorsque vous êtes prêt à soumettre votre package de métadonnées de périphérique, ou si vous devez le modifier, vous devez utiliser le fichier .devicemanifest-ms. Le fichier .devicemetadata-ms ne doit être utilisé que pour tester localement les métadonnées de périphérique.