Quickstart: De Azure Sphere SDK voor Linux installeren

Artikel
09/27/2024

Belangrijk

Dit is de Documentatie voor Azure Sphere (verouderd). Azure Sphere (verouderd) wordt op 27 september 2027 buiten gebruik gesteld en gebruikers moeten tegen deze tijd migreren naar Azure Sphere (geïntegreerd). Gebruik de versiekiezer boven de inhoudsweergave om de Documentatie van Azure Sphere (geïntegreerd) weer te geven.

U kunt de Azure Sphere SDK installeren op een computer waarop het Linux-besturingssysteem wordt uitgevoerd voor het ontwikkelen, implementeren en opsporen van fouten in Azure Sphere-toepassingen.

Vereisten

Voor de installatie van de Azure Sphere SDK zijn de volgende vereisten vereist:

Een Azure Sphere-ontwikkelkit.
Een computer met een x86-64-processor met 64-bits Ubuntu 24.04 (voorlopige versie), Ubuntu 22.04 LTS of Ubuntu 20.04 LTS. Alleen Intel-compatibele x86-64-processors worden ondersteund; andere architecturen zoals ARM (inclusief de Raspberry Pi), Itanium of SPARC worden niet ondersteund. De x86-64-architectuur wordt ook wel x64, x86_64, AMD64 en Intel 64 genoemd.
Linux-machtiging sudo .
Een internetverbinding of een manier om bestanden over te dragen van een computer met een internetverbinding naar uw computer. Zie De SDK installeren zonder internetverbinding voor meer informatie.

Vereiste Linux-pakketten toevoegen

Voordat u het SDK-installatiescript uitvoert, moet u vereiste Linux-pakketten toevoegen aan uw computer als deze nog niet zijn geïnstalleerd. Voer de volgende regels in een Linux-terminal in. U kunt pakketten weglaten die al zijn geïnstalleerd.

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

De Azure Sphere SDK installeren

Volg vervolgens deze stappen:

Download het installatiescript.
Navigeer naar de map waarin u het gecomprimeerde bestand hebt gedownload.
Pak de inhoud van het gecomprimeerde bestand uit. Bijvoorbeeld: tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Het .tar.gz bestand bevat het install_azure_sphere_sdk.sh-bestand.
Voer het installatiescript sudo als volgt uit:
```
sudo ./install_azure_sphere_sdk.sh
```
Als u de fout command not found ziet bij het uitvoeren van het script, schakelt u de uitvoering van het installatiescript in met deze opdracht:
```
chmod +x install_azure_sphere_sdk.sh
```

Tijdens de installatie geeft het script bevestigingsberichten weer. Bevestigingsberichten kunnen worden overgeslagen door het script aan te roepen met de -y vlag:

sudo ./install_azure_sphere_sdk.sh -y

Zonder de -y vlag verwacht het script antwoorden op de volgende prompts:

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)

Ga naar de openbare-sleutelvingerafdruksite van Microsoft en controleer of de hexadecimale vingerafdrukwaarde die tijdens de installatie wordt weergegeven, overeenkomt met de vingerafdruk van de openbare sleutel van Microsoft die op de pagina wordt weergegeven. Ga niet verder als de twee vingerafdrukken niet overeenkomen.

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)

Selecteer Y deze optie om Azure Sphere CLI in te stellen als uw standaard-CLI of N om de klassieke Cli van Azure Sphere in te stellen als uw standaard-CLI.

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)

Selecteer Y deze optie om de azsphere-groep in te stellen en de udev-regel te maken.

Wanneer de installatie is voltooid, moet u zich opnieuw aanmelden bij uw bureaubladtoepassing of aanmeldingsshell om de CLI te initialiseren.

Na de installatie bevindt de azsphere-opdracht zich op path en bevinden de nieuwe udev-regels voor uw apparaat zich op /etc/udev/rules.d/.

Met het script wordt de SDK geïnstalleerd op /opt/azurespheresdk en de hulpprogrammaketens naar /opt/azurespheresdk/Sysroots/sysroot-version/tools, waarbij sysroot-version een sysroot identificeert waarmee de SDK app-ontwikkeling ondersteunt.

Het installatieprogramma installeert zowel de Azure Sphere CLI als de klassieke Azure Sphere CLI-versies van de CLI. U hoeft de huidige versie niet te verwijderen omdat de installatie een bestaande versie bijwerkt. Azure Sphere CLI wordt geïnstalleerd in /opt/azurespheresdk/Tools_v2 en de klassieke Azure Sphere CLI wordt geïnstalleerd in /opt/azurespheresdk/Tools.

In Linux kunt u Azure Sphere CLI uitvoeren vanuit een terminal met behulp van azsphere_v2 en azsphere als deze is geselecteerd als de standaard-CLI tijdens de installatie.

Nadat u de CLI voor het eerst hebt geïnstalleerd, controleert u of deze is geïnstalleerd en of u de juiste versie hebt door azsphere show-version uit te voeren.

Udev-regels

De Azure Sphere SDK geeft udev regels op voor de apparaatgegevens van uw computer. De SDK maakt een nieuwe groep met de naam azsphere en voegt de momenteel aangemelde gebruiker toe aan de groep. De udev regel verleent het eigendom van USB-apparaten die overeenkomen met de beschrijving van het Azure Sphere-apparaat. Nadat u de SDK hebt geïnstalleerd en uw computer opnieuw hebt opgestart, hoeft u niet te gebruiken sudo voor apparaatherstel of ARM Cortex-M4-foutopsporing.

De azsphere groep wordt toegevoegd om machtigingen te verlenen met behulp van de udev regel. Wijzig de groep niet handmatig.

De SDK installeren zonder internetverbinding

Als u geen internetverbinding hebt op de computer waarop u de SDK installeert, moet u deze bestanden downloaden naar een computer die is verbonden met internet en deze overdraagt naar de installatiecomputer.

Download deze bestanden en breng ze over naar de installatiecomputer:
- Azure Sphere SDK voor Linux: kies uit Ubuntu 24.04 (voorlopige versie), Ubuntu 22.04 LTS of Ubuntu 20.04 LTS.
  
  Het gedownloade bestand is een gecomprimeerd tar-bestand (.tar.gz bestand) met een naam die begint Azure_Sphere_SDK_Bundle.
- Installatiescript: dit is een gecomprimeerd tar-bestand (.tar.gz bestand) met een naam die begint install_azure_sphere_sdk.
- Openbare sleutel van Microsoft: dit is een ASCII-tekstbestand.
Navigeer op de installatiecomputer naar de map waarin u de bestanden hebt overgedragen.
Pak de inhoud van het gecomprimeerde installatiescriptbestand uit. Bijvoorbeeld: tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Het .tar.gz bestand bevat het install_azure_sphere_sdk.sh-bestand. Laat de Azure Sphere SDK-bundel staan als een gecomprimeerd tar-bestand (tar.gz bestand).
Voer het installatiescript uit met behulp van sudo. Neem de -i parameter op om het pad naar de SDK-bundel en de -k parameter op te geven om het pad naar de sleutel op te geven. Uw opdracht moet er ongeveer als volgt uitzien:

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

Als u de fout command not found ziet bij het uitvoeren van het script, schakelt u de uitvoering van het installatiescript in met deze opdracht:
```
chmod +x install_azure_sphere_sdk.sh
```

Ga verder met de installatie zoals beschreven in De Azure Sphere SDK installeren.

De ontwikkelomgeving instellen

U kunt Azure Sphere-apps ontwikkelen in Linux met behulp van Visual Studio Code of de opdrachtregelinterface (CLI). Ongeacht wat u gebruikt, moet u CMake en Ninja installeren op uw ontwikkelcomputer, als u ze nog niet hebt. Raadpleeg de instructies voor het toevoegen van de Kitware APT-opslagplaats aan uw installatie.

CMake en Ninja installeren

Als u CMake en Ninja wilt installeren, raadpleegt u eerst de instructies voor het toevoegen van de Kitware APT-opslagplaats aan uw installatie en gebruikt u vervolgens de volgende opdracht:

sudo apt-get install cmake ninja-build

Notitie

Installeer cmake of ninja niet met snap.

De Azure Sphere-extensie voor Visual Studio Code installeren

Als u Visual Studio Code wilt gebruiken als uw ontwikkelomgeving, moet u deze en de Azure Sphere-extensie installeren.

Gebruik de koppelingen in Visual Studio Code downloaden om Visual Studio Code te installeren als u dit nog niet hebt gedaan.
Als u de Azure Sphere-extensie wilt installeren, zoekt u in de extensie-marketplace vanuit een browser of in Visual Studio Code naar 'Azure Sphere'. Als het goed is, ziet u twee resultaten: De gebruikersinterface van Azure Sphere en Azure Sphere. Selecteer Installeren voor een van beide. De andere moet automatisch worden geïnstalleerd.
Na de installatie ziet u de extensies Azure Sphere, C/C++ en CMake Tools in het deelvenster ENABLED Extensions in de Visual Studio Code IDE.

Wanneer de installatie is voltooid, wordt de leesmij-pagina voor de extensie geopend. De leesmij-pagina bevat nuttige informatie over de configuratie en vereisten van Visual Studio Code en wordt samen met de extensie bijgewerkt. U kunt de leesmij-pagina op elk gewenst moment bekijken door het deelvenster Extensies te openen en Azure Sphere te selecteren.

Volgende stappen

Uw apparaat claimen

Delen via