Charger une version test d’un package d’images d’application
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).
Pendant le développement, vous devrez peut-être procéder au chargement indépendant d’un package d’images sur l’appareil Azure Sphere à des fins de test. Quand vous générez une application avec l’environnement de développement intégré (IDE) de Visual Studio ou de Visual Studio Code, le SDK empaquette l’image d’application pour vous. Si vous disposez d’un accès direct à un appareil Azure Sphere, le SDK peut également supprimer les applications existantes qui ne sont pas marquées comme partenaires, charger le nouveau package d’images sur l’appareil, le démarrer et activer le débogage. Vous pouvez également procéder au chargement indépendant d’un package d’images directement depuis la ligne de commande.
Vous devez d’abord activer la fonctionnalité appDevelopment pour l’appareil, puis ajouter l’appareil à un groupe d’appareils qui ne prend pas en charge les mises à jour d’applications cloud. L’affectation d’appareils à un tel groupe garantit que vos applications chargées de façon indépendante (« sideloaded ») ne sont pas remplacées par des déploiements cloud. Pour préparer votre appareil, utilisez la commande azsphere device enable-development. Vous pouvez alors charger l’image de façon indépendante.
Procéder au chargement indépendant d’un package d’images et le déboguer depuis la ligne de commande
Pour procéder au chargement indépendant (sideloading) du package d’images depuis la ligne de commande, vous supprimez toutes les applications existantes sur l’appareil, puis vous chargez la nouvelle.
Pour arrêter et supprimer toutes les applications sur l’appareil :
azsphere device sideload delete
Pour supprimer une seule application, ajoutez l’option --component-id, comme suit :
azsphere device sideload delete --component-id <ComponentID>
Ensuite, procédez au chargement indépendant du nouveau package d’images :
azsphere device sideload deploy --image-package <imagepackagepath>
Remplacez imagepackagepath par le chemin du package d’image. Si vous utilisez Visual Studio ou Visual Studio Code, vous trouverez le package d’image dans le sous-dossier bin\ARM\Debug ou bin\ARM\Release du dossier projet de l’application. Par défaut, la commande démarre l’application après l’avoir déployée.
Pour déboguer l’application, ajoutez l’indicateur --manual-start à la commande azsphere device sideload deploy pour supprimer le démarrage automatique, puis démarrez l’application pour le débogage :
azsphere device sideload deploy --manual-start --image-package <imagepackagepath>
azsphere device app start --debug --component-id <ComponentID>
La commande affiche les ports de sortie et de débogage pour les applications de haut niveau :
Output Port: 2342
GDB Port: 2345
Marquer les applications comme partenaires
Les applications connexes doivent être marquées comme applications partenaires. Il existe de nombreux cas de figure qui demandent de charger plusieurs applications, par exemple, une application de haut niveau et une application en temps réel qui communiquent l’une avec l’autre. Le marquage des applications comme partenaires empêche la suppression de l’une lors du chargement de l’autre. Quand les IDE de Visual Studio et de Visual Studio Code procèdent au sideloading d’un nouveau package d’images, ils suppriment toutes les applications existantes qui ne sont pas marquées comme étant des applications partenaires.
Pour marquer une application en tant que partenaire en utilisant CMake dans Visual Studio :
Modifiez le fichier launch.vs.json pour l’application.
Ajoutez la ligne suivante :
"partnerComponents": [ "<Component ID>" ]Remplacez l’ID de composant de l’application partenaire pour
<Component ID>, puis enregistrez le fichier. Vous trouverez l’ID de composant de chaque application dans son fichier app_manifest.json ou à l’aide d’une liste d’images d’appareil azsphere installée ou azsphere device app show-status.
Pour marquer une application en tant que partenaire en utilisant CMake dans Visual Studio Code :
Modifiez le fichier .vscode\launch.json pour l’application.
Ajoutez la ligne suivante :
"partnerComponents": [ "<Component ID>" ]Remplacez l’ID de composant de l’application partenaire pour
<Component ID>, puis enregistrez le fichier. Vous trouverez l’ID de composant de chaque application dans son fichier app_manifest.json ou à l’aide d’une liste d’images d’appareil azsphere installée ou azsphere device app show-status.