Partage via

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

  • Article

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

Vous pouvez installer le SDK Azure Sphere sur un ordinateur exécutant le système d’exploitation Linux pour développer, déployer et déboguer des applications Azure Sphere.

Prérequis

L’installation du SDK Azure Sphere nécessite les prérequis suivants :

  • Kit de développement Azure Sphere.
  • Un ordinateur avec un processeur x86-64 exécutant Ubuntu 24.04 (préversion), Ubuntu 22.04 LTS ou Ubuntu 20.04 LTS. Seuls les processeurs x86-64 compatibles Intel sont pris en charge ; d’autres architectures telles que ARM (y compris le Raspberry Pi), Itanium ou SPARC ne sont pas prises en charge. L’architecture x86-64 est également appelée x64, x86_64, AMD64 et Intel 64.
  • Autorisation sudo de Linux.
  • Une connexion Internet ou un moyen de transférer des fichiers depuis un ordinateur ayant une connexion Internet vers votre ordinateur. Pour plus d’informations, consultez Installer le SDK sans connexion Internet.

Ajouter les packages Linux nécessaires

Avant d’exécuter le script d’installation du SDK, vous devez ajouter les packages Linux nécessaires sur votre ordinateur s’ils ne sont pas déjà installés. Entrez les lignes suivantes dans un terminal Linux. Vous pouvez omettre les packages déjà installés.

sudo apt-get update
sudo apt-get install -y net-tools curl

Installer le kit SDK Azure Sphere

Effectuez les étapes suivantes :

  1. Téléchargez le script d’installation.

  2. Accédez au dossier dans lequel vous avez téléchargé le fichier compressé.

  3. Extrayez le contenu du fichier compressé. Par exemple : tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Le fichier .tar.gz contient le fichier install_azure_sphere_sdk.sh.

  4. Exécutez le script d’installation comme sudo suit :

    sudo ./install_azure_sphere_sdk.sh

    Si vous voyez l’erreur command not found lors de l’exécution du script, activez l’exécution du script d’installation avec cette commande :

    chmod +x install_azure_sphere_sdk.sh

  5. Pendant l’installation, le script affiche les messages de confirmation. Les messages de confirmation peuvent être ignorés en appelant le script avec l’indicateur -y :

    sudo ./install_azure_sphere_sdk.sh -y

    Sans l’indicateur -y , le script attend des réponses aux invites suivantes :

    The SDK tarball signature is valid. The fingerprint of the key used is:

Primary key fingerprint: <hexadecimal>

Please check that this fingerprint matches the Microsoft GPG public key fingerprint shown on https://aka.ms/AzureSphereSDKVerification/Linux before proceeding. Do not proceed if these values do not match.
Proceed with installation? (Y/N)

    Accédez au site de empreinte digitale de clé public de Microsoft et vérifiez que la valeur d’empreinte digitale hexadécimale affichée pendant l’installation correspond à l’empreinte digitale de clé publique Microsoft affichée sur la page. Ne continuez pas si les deux empreintes ne correspondent pas.

    Installing CLI.
This SDK contains two versions of the Azure Sphere CLI: the new Azure Sphere CLI (recommended) and Azure Sphere classic CLI (retiring). See https://aka.ms/AzureSphereCLIVersions for more information on the versions.

You can choose which version is available through the command 'azsphere'.

Note that the Azure Sphere classic CLI will always be available to use with 'azsphere_v1' and the new Azure Sphere CLI will always be available to use with 'azsphere_v2'.
Use the recommended (new) CLI for 'azsphere'? (Y/N)

    Sélectionnez cette option Y pour définir l’interface CLI Azure Sphere comme cli par défaut ou N pour définir l’interface CLI classique Azure Sphere comme cli par défaut.

    Some device operations require root permissions, or permissions granted by a udev rule. Set up the default udev rule and group (azsphere), and add the current user to it? (Y/N)

    Sélectionnez cette option Y pour configurer le groupe azsphere et créer la règle udev.

  6. Une fois l’installation terminée, vous devez vous reconnecter à votre application de bureau ou à votre interpréteur de commandes de connexion pour initialiser l’interface CLI.

Après l’installation, la commande azsphere se trouve sur le chemin d’accès et les nouvelles règles udev pour votre appareil se trouvent à /etc/udev/rules.d/.

Le script installe le SDK dans /opt/azurespheresdk et les chaînes d’outils dans /opt/azurespheresdk/Sysroots/version-sysroot/tools, où version-sysroot identifie un sysroot pour lequel le SDK prend en charge le développement d’applications.

Le programme d’installation installe à la fois l’interface CLI Azure Sphere et les versions de l’interface CLI classique d’Azure Sphere. 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 /opt/azurespheresdk/Tools_v2 et l’interface CLI classique Azure Sphere est installée dans /opt/azurespheresdk/Tools.

Sur Linux, vous pouvez exécuter Azure Sphere CLI à partir d’un terminal à l’aide azsphere_v2 d’un terminal et azsphere s’il a été sélectionné comme cli par défaut pendant l’installation.

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

Règles Udev

Le SDK Azure Sphere spécifie des règles udev pour les informations de l’appareil de votre ordinateur. Le SDK crée un groupe appelé azsphere et ajoute l’utilisateur actuellement connecté au groupe. La règle udev accorde la propriété des appareils USB correspondant à la description d’appareil Azure Sphere. Après avoir installé le SDK et redémarré votre ordinateur, vous n’avez pas besoin d’utiliser sudo pour la récupération de l’appareil ou le débogage d’ARM Cortex-M4.

Le groupe azsphere est ajouté afin d’accorder des autorisations à l’aide de la règle udev. Ne modifiez pas le groupe manuellement.

Installer le SDK sans connexion Internet

Si vous n’avez pas de connexion Internet sur l’ordinateur sur lequel vous installez le Kit de développement logiciel (SDK), vous devez télécharger ces fichiers sur un ordinateur connecté à Internet et les transférer vers l’ordinateur d’installation.

  1. Téléchargez ces fichiers et transférez-les sur l’ordinateur d’installation :

    • Sdk Azure Sphere pour Linux : choisissez Ubuntu 24.04 (préversion), Ubuntu 22.04 LTS ou Ubuntu 20.04 LTS.

      Le fichier téléchargé est un fichier tar compressé (fichier .tar.gz ) avec un nom commençant Azure_Sphere_SDK_Bundle.

    • Script d’installation : il s’agit d’un fichier tar compressé (fichier .tar.gz) avec un nom commençant install_azure_sphere_sdk.

    • Clé publique GPG de Microsoft : il s’agit d’un fichier texte ASCII.

  2. Sur l’ordinateur d’installation, accédez au dossier dans lequel vous avez transféré les fichiers.

  3. Extrayez le contenu du fichier de script d’installation compressé. Par exemple : tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Le fichier .tar.gz contient le fichier install_azure_sphere_sdk.sh. Laissez le bundle du KIT de développement logiciel (SDK) Azure Sphere en tant que fichier tar compressé (fichier tar.gz ).

  4. Exécutez le script d’installation avec sudo. Incluez le paramètre pour spécifier le -i chemin d’accès au bundle sdk et le -k paramètre pour spécifier le chemin d’accès à la clé. Votre commande doit être similaire à ceci :

    sudo ./install_azure_sphere_sdk.sh -i [pathtopackage]/[sdkbundle] -k [pathtokey]/microsoft.asc

    Si vous voyez l’erreur command not found lors de l’exécution du script, activez l’exécution du script d’installation avec cette commande :

    chmod +x install_azure_sphere_sdk.sh

Passez à l’installation, comme décrit dans Installer le Kit de développement logiciel (SDK) Azure Sphere.

Configurer votre environnement de développement

Vous pouvez développer des applications Azure Sphere sur Linux avec Visual Studio Code ou l’interface de ligne de commande (CLI). Quel que soit l’outil que vous utilisez, vous devez installer CMake et Ninja sur votre machine de développement si vous ne les avez pas déjà. Reportez-vous aux instructions pour ajouter le référentiel APT Kitware à votre installation.

Installer CMake et Ninja

Pour installer CMake et Ninja, reportez-vous d’abord aux instructions pour ajouter le référentiel APT Kitware à votre installation, puis utilisez la commande suivante :

sudo apt-get install cmake ninja-build

Remarque

N’installez pas cmake ou ninja avec snap.

Installer l’extension Azure Sphere pour Visual Studio Code

Si vous souhaitez utiliser Visual Studio Code comme environnement de développement, vous devez l’installer et l’extension Azure Sphere.

  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

Revendiquer votre appareil