Partage via


Qu’est-ce qu’un ID de composant ?

Important

Il s’agit de la documentation Azure Sphere (héritée). Azure Sphere (hérité) prend sa retraite le 27 septembre 2027 et les utilisateurs doivent migrer vers Azure Sphere (intégré) pour l’instant. Utilisez le sélecteur de version situé au-dessus du TOC pour afficher la documentation Azure Sphere (intégrée).

Chaque application Azure Sphere doit avoir un ID de composant unique afin qu’elle puisse être facilement identifiée. L’ID de composant est un identificateur universel unique (UUID) également appelé identificateur global unique (GUID), qui est une chaîne qui contient un ensemble de chiffres hexadécimaux. Par exemple, 02ce3860-3126-42af-8ac7-c2a661134129. Chaque application a un ID de composant différent pour éviter les conflits possibles.

Générer un ID de composant

La première fois que vous ouvrez un projet CMake dans Visual Studio ou Visual Studio Code, la génération CMakeLists s’exécute automatiquement et définit l’ID de composant de l’application dans le fichier app_manifest.json. Si vous exécutez l’application sans ID de composant, la build échoue. Si nécessaire, vous pouvez générer manuellement un GUID/UUID et mettre à jour le paramètre de manifeste d’application.

Pour générer un GUID ou un UUID :

  1. Dans le menu Outils , choisissez Créer un Guid.
  2. Dans le programme Générateur de GUID , sélectionnez la case d'option Format du Registre , choisissez le bouton Copier , puis le bouton Quitter .

Collez le GUID/UUID généré dans le ComponentId champ du fichier app_manifest.json de l’application. Par exemple : "ComponentId": "a5e23798-9bef-4bb0-9ae9-45643e788cb7"

Rechercher l’ID du composant

L’ID de composant d’une application est requis pour identifier une application. Vous trouverez l’ID de composant d’une application de toutes les manières suivantes :

  • Vérifiez l’ID du composant dans le ComponentId champ du fichier app_manifest.json de l’application.
  • Utilisez la commande azsphere device app show-status pour répertorier l’état et l’ID de composant de l’application sur l’appareil attaché.
  • Utilisez la commande azsphere device image list-installed pour répertorier les images actuellement sur l’appareil attaché. Notez l’ID de composant de l’application requise.