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

Article
03/01/2025

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 LTS, 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 :

Téléchargez le script d’installation.
Accédez au dossier dans lequel vous avez téléchargé le fichier compressé.
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.
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
```

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)

Sélectionnez Y pour démarrer l’installation.

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.

By proceeding with this installation you agree to the license terms available at https://aka.ms/AzureSphereSDKLicense/Linux and which will be installed to /opt/azurespheresdk. Proceed? (Y/N) y
Uninstalling previous instance.
Installing SDK files.
Installing toolchain version 'xx'.
Installing toolchain version 'xx'.
Installing toolchain version 'xx'.
Installing toolchain version 'xx+Betaxxxx'.
Installing CLI.
SDK installed to '/opt/azurespheresdk'.
Installing Device Communication service.
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 (xxx) to it? (Y/N) y
Add the Azure Sphere CLI to the PATH for all users (this will add a file to /etc/profile.d/)? (Y/N) y
Azure Sphere CLI added to PATH for all users. You will need to restart your user session for this change to take effect.
Azure Sphere SDK installation complete. Visit https://aka.ms/AzureSphereSDK for documentation and samples.

Pourboire

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

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 Azure Sphere (héritée).

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 l’interface CLI Azure Sphere (héritée). Vous n’avez pas besoin de désinstaller la version actuelle, car l’installation met à jour une version existante.

L’interface CLI Azure Sphere (Legacy) est installée dans /opt/azurespheresdk/Tools_v2.

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 les fichiers sur un ordinateur connecté à Internet et les transférer vers l’ordinateur d’installation.

Téléchargez ces fichiers et transférez-les sur l’ordinateur d’installation :
- Kit de développement logiciel (SDK) Azure Sphere pour Linux : choisissez Ubuntu 24.04 LTS ou 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.
Sur l’ordinateur d’installation, accédez au dossier dans lequel vous avez transféré les fichiers.
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 ).
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.

Installer l’extension Azure Sphere pour Azure CLI

L’outil en ligne de commande pour la gestion des appareils attachés à Azure Sphere et des déploiements cloud est distribué en tant qu’extension Azure CLI. Procédez comme suit pour ajouter ou mettre à jour l’extension :

Installez Azure CLI si vous ne l’avez pas encore fait.

Pour ajouter l’extension Azure Sphere, exécutez la commande suivante :
```
az extension add --name azure-sphere
```
Pour mettre à jour l’extension Azure Sphere, exécutez la commande suivante :
```
az extension update --name azure-sphere
```

Vous devez vous connecter avec Azure CLI pour vous connecter à l’abonnement Azure que vous souhaitez utiliser pour gérer les appareils Azure Sphere.

Pour plus d’informations, consultez Télécharger et exécuter l’extension 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.

Utilisez les liens dans Télécharger Visual Studio Code pour installer Visual Studio Code , si ce n’est déjà fait.
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.
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