Partager via


Démarrage rapide : Installer le Kit de développement logiciel (SDK) Azure Sphere pour Windows

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

Pour commencer à utiliser un kit de développement Azure Sphere sur Windows, vous devez configurer le kit de développement, installer le Kit de développement logiciel (SDK) et installer tout logiciel supplémentaire requis pour votre environnement de développement.

Prérequis

  • Un Kit de développement Azure Sphere
  • Pc exécutant la mise à jour anniversaire Windows 11 ou Windows 10 (ou version ultérieure)
  • Un port USB inutilisé et, si vous exécutez une machine virtuelle, la prise en charge du transfert USB

Configurer votre kit de développement sur un PC Windows

Connectez votre kit de développement Azure Sphere à votre PC via USB. Lorsqu’il est branché, l’appareil expose quatre convertisseurs série USB.

La première fois que vous branchez l’appareil, les pilotes doivent être automatiquement téléchargés et installés. L’installation peut être lente. Si les pilotes ne sont pas installés automatiquement, cliquez avec le bouton droit sur le nom de l’appareil dans Gestionnaire de périphériques, puis sélectionnez Mettre à jour le pilote. Vous pouvez également télécharger les pilotes à partir du site de FTDI (Future Technology Devices International). Choisissez le pilote correspondant à votre installation de Windows (32 ou 64 bits).

Pour vérifier l’installation, ouvrez Gestionnaire de périphériques. Sous contrôleurs serial bus universels, recherchez quatre convertisseurs série USB. Gestionnaire de périphériques avec quatre convertisseurs série USB

Remarque

Si vous avez déjà utilisé cette carte et activé le développement RTApp, vous verrez trois convertisseurs au lieu de quatre. Il s’agit d’une erreur normale et ne représente pas une erreur.

Si d’autres erreurs se produisent, consultez Résoudre les problèmes d’Azure Sphere pour obtenir de l’aide.

Installer le kit SDK Azure Sphere

  1. Téléchargez le SDK. Enregistrez le fichier téléchargé sur votre PC.

  2. Exécutez le fichier .exe téléchargé pour installer le SDK. Acceptez les termes du contrat de licence, puis sélectionnez Suivant.

  3. Sélectionnez Installer pour démarrer l’installation.

  4. Acceptez l’invite d’élévation si celle-ci apparaît.

  5. Une fois l’installation terminée, redémarrez votre PC si l’application d’installation le demande.

Si le programme d’installation retourne des erreurs, essayez de désinstaller puis de réinstaller le package du SDK.

Conseil

La licence du Kit de développement logiciel (SDK) Azure Sphere est installée dans C :\Program Files (x86)\Kit de développement logiciel (SDK) Microsoft Azure Sphere\license.rtf.

Le Kit de développement logiciel (SDK) inclut des bibliothèques pour le développement d’applications et les versions azure Sphere CLI classiques d’Azure Sphere de l’interface CLI. Vous n’avez pas besoin de désinstaller la version actuelle, car l’installation met à jour une version existante. Azure Sphere CLI est installé dans C :\Program Files (x86)\Microsoft Azure Sphere SDK\Tools_v2 et Azure Sphere Classic CLI est installé dans C :\Program Files (x86)\Microsoft Azure Sphere SDK\Tools.

Vous pouvez exécuter Azure Sphere CLI avec la commande à partir de l’invite azsphere de commandes Windows ou de PowerShell. Nous vous recommandons PowerShell, car il offre la fonctionnalité d’achèvement de tabulation qui n’est pas disponible à partir de l’invite de commandes Windows. Azure Sphere Classic CLI continuera d’être disponible à l’aide de l’invite de commandes du développeur Azure Sphere Classic (mise hors service), disponible dans le menu Démarrer sous Azure Sphere.

Après avoir installé l’interface CLI pour la première fois, vérifiez qu’elle est bien installée et que vous disposez de la version appropriée en exécutant azsphere show-version.

Si vous essayez d’exécuter l’interface CLI et que vous recevez un message d’erreur indiquant qu’il azsphere ne s’agit pas d’une commande reconnue, ajoutez le chemin d’accès au sdk Azure Sphere exécutable aux variables d’environnement Windows. Accédez aux paramètres système avancés Panneau de configuration> System et Security>System>Advanced. Sélectionnez les variables d’environnement et, dans les variables système, ajoutez le chemin d’accès à azsphere.exe (par exemple, C :\Program Files (x86)\Microsoft Azure Sphere SDK\Tools_v2).

Installer l’extension Azure Sphere pour Visual Studio

Vous pouvez utiliser Visual Studio Enterprise, Professional ou Community 2022 (ou 2019 version 16.11 ou ultérieure) pour développer des applications Azure Sphere.

  1. Si ce n’est déjà fait, installez Visual Studio :

  2. Accédez à Visual Studio Marketplace pour installer l’extension Visual Studio pour Azure Sphere :

Le Kit de développement logiciel (SDK) Azure Sphere et l’extension Azure Sphere pour Visual Studio incluent tous les outils dont vous avez besoin pour développer des applications Azure Sphere.

Installer CMake et Ninja sur Windows

Si vous envisagez d’utiliser Visual Studio Code ou Windows CLI, vous devez installer CMake et Ninja manuellement.

  1. Pour installer CMake, téléchargez et installez la version appropriée de CMake pour votre environnement de développement à partir de la page de téléchargement CMake.

  2. Téléchargez Ninja. Le téléchargement est un petit fichier zip. Pour installer Ninja, ouvrez le fichier zip, sélectionnez Extraire tout, puis notez l’emplacement du fichier extrait ninja.exe.

  3. Ajoutez le répertoire CMake bin (généralement C :\Program Files\CMake\bin) et le répertoire contenant ninja.exe à votre variable d’environnement PATH. Pour trouver des informations sur la définition de cette variable d’environnement dans Windows, tapez « chemin » dans la zone de recherche.

Conseil

Redémarrez votre ordinateur après avoir modifié les variables d’environnement pour vous assurer que tous les processus récupèrent les modifications.

Installer l’extension Azure Sphere pour Visual Studio Code

  1. Utilisez les liens dans Télécharger Visual Studio Code pour installer Visual Studio Code , si ce n’est déjà fait.

  2. Pour installer l’extension Azure Sphere, recherchez « Azure Sphere » dans la Place de marché d’extension à partir d’un navigateur ou dans Visual Studio Code. Vous devez voir deux résultats, l’interface utilisateur Azure Sphere et Azure Sphere. Sélectionnez Installer pour l’une ou l’autre ; l’autre doit être installé automatiquement.

  3. Après l’installation, vous devez voir les extensions Azure Sphere, C/C++ et CMake Tools dans le volet Extensions ACTIVÉES de l’IDE Visual Studio Code.

Une fois l’installation terminée, la page Lisez-moi de l’extension s’ouvre. La page Lisez-moi fournit des informations utiles sur la configuration et les exigences de Visual Studio Code et est mise à jour avec l’extension. Vous pouvez afficher la page Lisez-moi à tout moment en ouvrant le volet Extensions et en sélectionnant Azure Sphere.

Étapes suivantes