Quickstart: De Azure Sphere SDK voor Linux installeren

Artikel
04/03/2024

U kunt de Azure Sphere SDK installeren op een computer met het Linux-besturingssysteem om Azure Sphere-toepassingen te ontwikkelen, implementeren en fouten op te sporen.

Voorwaarden

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 (pre-release), 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 staat ook bekend als x64, x86_64, AMD64 en Intel 64.
Linux-machtiging sudo .
Een internetverbinding of een manier om bestanden over te dragen vanaf 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 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 als sudo 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 worden bevestigingsberichten weergegeven. 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)

Navigeer naar de openbare-sleutel vingerafdruksite van Microsoft en controleer of de hexadecimale vingerafdrukwaarde die tijdens de installatie wordt weergegeven, overeenkomt met de microsoft-vingerafdruk voor openbare sleutel 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 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 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 Azure Sphere (verouderde) CLI te initialiseren.

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

Het script installeert de SDK naar /opt/azurespheresdk en de toolchains naar /opt/azurespheresdk/Sysroots/sysroot-version/tools, waarbij sysroot-version een sysroot identificeert waarmee de SDK app-ontwikkeling ondersteunt.

Het installatieprogramma installeert de Azure Sphere (verouderde) CLI-versies van de CLI. U hoeft de huidige versie niet te verwijderen omdat met de installatie een bestaande versie wordt bijgewerkt. Azure Sphere (verouderde) CLI wordt geïnstalleerd in /opt/azurespheresdk/Tools_v2 en de klassieke CLI van Azure Sphere (verouderd) wordt geïnstalleerd in /opt/azurespheresdk/Tools.

In Linux kunt u Azure Sphere (verouderde) 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 de eerste keer 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 de bestanden downloaden naar een computer die is verbonden met internet en ze overbrengen naar de installatiecomputer.

Download deze bestanden en breng ze over naar de installatiecomputer:
- Azure Sphere SDK voor Linux: kies uit Ubuntu 24.04 (pre-release) of 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 GPG: dit is een ASCII-tekstbestand.
Navigeer op de installatiecomputer naar de map waarnaar u de bestanden hebt overgebracht.
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 op te geven en de -k parameter 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 Azure Sphere-extensie voor Azure CLI installeren

Het opdrachtregelprogramma voor het beheren van gekoppelde Azure Sphere-apparaten en cloudimplementaties wordt gedistribueerd als een Azure CLI-extensie. Voer de volgende stappen uit om de extensie toe te voegen of bij te werken:

Installeer de Azure CLI als u dit nog niet hebt gedaan.

Voer de volgende opdracht uit om de Azure Sphere-extensie toe te voegen:
```
az extension add --name azure-sphere
```
Voer de volgende opdracht uit om de Azure Sphere-extensie bij te werken:
```
az extension udpate --name azure-sphere
```

U moet zich aanmelden met Azure CLI om u aan te melden bij het Azure-abonnement dat u wilt gebruiken voor het beheren van Azure Sphere-apparaten.

Zie De Azure Sphere-extensie downloaden en uitvoeren voor meer informatie.

Uw ontwikkelomgeving instellen

U kunt Azure Sphere-apps in Linux ontwikkelen met behulp van Visual Studio Code of de opdrachtregelinterface (CLI). Wat u ook gebruikt, U moet CMake en Ninja installeren op uw ontwikkelcomputer, als u deze 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

Opmerking

Installeer cmake of ninja niet met behulp van 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'. U ziet nu twee resultaten: Azure Sphere en Azure Sphere UI. Selecteer Installeren voor een van beide; de andere moet automatisch worden geïnstalleerd.
Na de installatie ziet u extensies voor 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 pagina Leesmij 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 weergeven door het deelvenster Extensies te openen en Azure Sphere te selecteren.

Volgende stappen

Uw apparaat claimen