Schnellstart: Installieren des Azure Sphere SDK für Linux

Artikel
10/17/2024

Sie können das Azure Sphere SDK auf einem Computer mit dem Linux-Betriebssystem installieren, um Azure Sphere-Anwendungen zu entwickeln, bereitzustellen und zu debuggen.

Voraussetzungen

Für eine Azure Sphere SDK-Installation ist Folgendes erforderlich:

Ein Azure Sphere-Entwicklungskit.
Ein Computer mit einem x86-64-basierten Prozessor mit 64-Bit-Ubuntu 24.04 (Vorabversion), Ubuntu 22.04 LTS oder Ubuntu 20.04 LTS. Nur Intel-kompatible x86-64-Prozessoren werden unterstützt; andere Architekturen wie ARM (einschließlich Raspberry Pi), Itanium oder SPARC werden nicht unterstützt. Die x86-64-Architektur wird auch als x64, x86_64, AMD64 und Intel 64 bezeichnet.
Eine Linux-Berechtigung sudo
Eine Internetverbindung oder eine Möglichkeit zur Übertragung von Dateien von einem Computer mit Internetverbindung auf Ihren Computer. Weitere Informationen finden Sie unter Installieren des SDK ohne Internetverbindung.

Hinzufügen erforderlicher Linux-Pakete

Bevor Sie das SDK-Installationsskript ausführen, müssen Sie dem Computer erforderliche Linux-Pakete hinzufügen, sofern diese nicht bereits installiert sind. Geben Sie die folgenden Zeilen in einem Linux-Terminal ein. Bereits installierte Pakete können weggelassen werden.

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

Installieren des Azure Sphere SDK

Führen Sie folgende Schritte aus:

Laden Sie das Installationsskript herunter.
Navigieren Sie zu dem Ordner, in den Sie die komprimierte Datei heruntergeladen haben.
Extrahieren Sie den Inhalt der komprimierten Datei. Beispiel: tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Die .tar.gz Datei enthält die install_azure_sphere_sdk.sh Datei.
Führen Sie das Installationsskript wie folgt aus sudo :
```
sudo ./install_azure_sphere_sdk.sh
```
Wenn beim Ausführen des Skripts der Fehler command not found angezeigt wird, aktivieren Sie die Ausführung des Installationsskripts mit diesem Befehl:
```
chmod +x install_azure_sphere_sdk.sh
```

Während der Installation zeigt das Skript Bestätigungsmeldungen an. Bestätigungsmeldungen können übersprungen werden, indem sie das Skript mit der -y Kennzeichnung aufrufen:

sudo ./install_azure_sphere_sdk.sh -y

Ohne die -y Kennzeichnung erwartet das Skript Antworten auf die folgenden Eingabeaufforderungen:

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)

Navigieren Sie zur Öffentlichen Schlüsselfingerabdruck-Website von Microsoft, und überprüfen Sie, ob der hexadezimale Fingerabdruckwert, der während der Installation angezeigt wird, mit dem Auf der Seite angezeigten Microsoft Public Key Fingerabdruck übereinstimmt. Sollten die beiden Fingerabdrücke nicht übereinstimmen, setzen Sie den Vorgang nicht fort.

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)

Wählen Sie diese Option Y aus, um Azure Sphere CLI als Standard-CLI festzulegen oder N die klassische Azure Sphere CLI als Standard-CLI festzulegen.

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)

Wählen Sie diese Option Y aus, um die Azsphere-Gruppe einzurichten und die Udev-Regel zu erstellen.

Nach Abschluss der Installation müssen Sie sich erneut bei Ihrer Desktopanwendung oder Anmeldeshell anmelden, um die Azure Sphere (Legacy)-CLI zu initialisieren.

Nach der Installation befindet sich der Azsphere-Befehl auf dem PATH, und die neuen udev-Regeln für Ihr Gerät befinden sich bei /etc/udev/rules.d/.

Das Skript installiert das SDK unter „/opt/azurespheresdk“ und die Toolketten unter „/opt/azurespheresdk/Sysroots/sysroot-version/tools“. sysroot-version gibt ein sysroot-Verzeichnis an, für das das SDK die App-Entwicklung unterstützt.

Das Installationsprogramm installiert die Cli-Versionen von Azure Sphere (Legacy) der CLI. Sie müssen die aktuelle Version nicht deinstallieren, da die Installation eine vorhandene Version aktualisiert. Azure Sphere (Legacy) CLI wird in /opt/azurespheresdk/Tools_v2 und Azure Sphere (Legacy) classic CLI in /opt/azurespheresdk/Tools installiert.

Unter Linux können Sie azure Sphere (Legacy)-CLI über ein Terminal azsphere_v2 ausführen, das verwendet wird und azsphere ob sie während der Installation als Standard-CLI ausgewählt wurde.

Nachdem Sie die CLI zum ersten Mal installiert haben, überprüfen Sie, ob sie installiert ist, und Sie haben die richtige Version, indem Sie azsphere show-version ausführen.

Udev-Regeln

Das Azure Sphere SDK gibt udev-Regeln für die Geräteinformationen Ihres Computers an. Das SDK erstellt eine neue Gruppe mit dem Namen azsphere und fügt den aktuell angemeldeten Benutzer der Gruppe hinzu. Die udev-Regel erteilt Besitzrechte für USB-Geräte, die der Azure Sphere-Gerätebeschreibung entsprechen. Wenn Sie das SDK installiert und den Computer neu gestartet haben, müssen Sie für die Gerätewiederherstellung oder das ARM Cortex-M4-Debugging nicht sudo verwenden.

Die Gruppe azsphere wird hinzugefügt, um Berechtigungen mithilfe der Regel udev zu erteilen. Die Gruppe darf nicht manuell geändert werden.

Installieren des SDK ohne Internetverbindung

Wenn Sie keine Internetverbindung auf dem Computer haben, auf dem Sie das SDK installieren, müssen Sie die Dateien auf einen Computer herunterladen, der mit dem Internet verbunden ist, und sie auf den Installationscomputer übertragen.

Laden Sie diese Dateien herunter, und übertragen Sie sie auf den Installationscomputer:
- Azure Sphere SDK für Linux: Wählen Sie aus Ubuntu 24.04 (Vorabversion) oder Ubuntu 22.04 LTS oder Ubuntu 20.04 LTS.
  
  Die heruntergeladene Datei ist eine komprimierte Tar-Datei (.tar.gz Datei) mit einem Namen, der Azure_Sphere_SDK_Bundle beginnt.
- Installationsskript: Dies ist eine komprimierte Tar-Datei (.tar.gz Datei) mit einem Namen, der install_azure_sphere_sdk beginnt.
- Öffentlicher SCHLÜSSEL von Microsoft: Dies ist eine ASCII-Textdatei.
Navigieren Sie auf dem Installationscomputer zu dem Ordner, in den Sie die Dateien übertragen haben.
Extrahieren Sie den Inhalt der komprimierten Installationsskriptdatei. Beispiel: tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Die .tar.gz Datei enthält die install_azure_sphere_sdk.sh Datei. Lassen Sie das Azure Sphere SDK Bundle als komprimierte Tar-Datei (tar.gz Datei) ab.
Führen Sie das Installationsskript mithilfe von sudo aus. Schließen Sie den -i Parameter ein, um den Pfad zum SDK-Bundle und den -k Parameter anzugeben, um den Pfad zum Schlüssel anzugeben. Ihr Befehl sollte in etwa wie folgt aussehen:

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

Wenn beim Ausführen des Skripts der Fehler command not found angezeigt wird, aktivieren Sie die Ausführung des Installationsskripts mit diesem Befehl:
```
chmod +x install_azure_sphere_sdk.sh
```

Fahren Sie mit der Installation fort, wie unter Installieren des Azure Sphere SDK beschrieben.

Installieren der Azure Sphere-Erweiterung für Azure CLI

Das Befehlszeilentool zum Verwalten von angefügten Azure Sphere-Geräten und Cloudbereitstellungen wird als Azure CLI-Erweiterung verteilt. Führen Sie die folgenden Schritte aus, um die Erweiterung hinzuzufügen oder zu aktualisieren:

Installieren Sie die Azure CLI , wenn Sie dies noch nicht getan haben.

Führen Sie den folgenden Befehl aus, um die Azure Sphere-Erweiterung hinzuzufügen:
```
az extension add --name azure-sphere
```
Führen Sie den folgenden Befehl aus, um die Azure Sphere-Erweiterung zu aktualisieren:
```
az extension udpate --name azure-sphere
```

Sie müssen sich mit Azure CLI anmelden, um sich beim Azure-Abonnement anzumelden, das Sie zum Verwalten von Azure Sphere-Geräten verwenden möchten.

Weitere Informationen finden Sie unter Herunterladen und Ausführen der Azure Sphere-Erweiterung.

Einrichten der Entwicklungsumgebung

Sie können Azure Sphere-Apps unter Linux mithilfe von Visual Studio Code oder über die Befehlszeilenschnittstelle (CLI) entwickeln. Unabhängig vom verwendeten Programm müssen Sie CMake und Ninja auf Ihrem Entwicklungscomputer installieren, sofern sie noch nicht vorhanden sind. Anweisungen zum Hinzufügen des Kitware APT-Repositorys zu Ihrer Installation finden Sie in den Anweisungen.

Installieren von CMake und Ninja

Wenn Sie CMake und Ninja installieren möchten, lesen Sie zunächst die Anweisungen zum Hinzufügen des Kitware APT Repositorys zu Ihrer Installation, und verwenden Sie dann den folgenden Befehl:

sudo apt-get install cmake ninja-build

Hinweis

Installieren Sie CMake oder Ninja nicht mithilfe von snap.

Installieren der Azure Sphere-Erweiterung für Visual Studio Code

Wenn Sie Visual Studio Code als Entwicklungsumgebung verwenden möchten, müssen Sie es und die Azure Sphere-Erweiterung installieren.

Verwenden Sie die Links in Visual Studio Code herunterladen, um Visual Studio Code zu installieren, sofern noch nicht geschehen.
Um die Azure Sphere-Erweiterung zu installieren, suchen Sie in einem Browser oder in Visual Studio Code im Erweiterungs-Marketplace nach "Azure Sphere". Es sollten zwei Ergebnisse angezeigt werden: Azure Sphere und Azure Sphere UI. Wählen Sie "Installieren " für eine der beiden Optionen aus. Die andere sollte automatisch installiert werden.
Nach der Installation sollten die Erweiterungen für Azure Sphere, C/C++ und CMake Tools im Bereich der aktivierten Erweiterungen in der Visual Studio Code-IDE angezeigt werden.

Nach Abschluss der Installation wird die Readme-Seite für die Erweiterung geöffnet. Auf der Infoseite finden Sie nützliche Informationen zu Visual Studio Code-Konfiguration und -Anforderungen und werden zusammen mit der Erweiterung aktualisiert. Sie können die Infoseite jederzeit anzeigen, indem Sie den Bereich "Erweiterungen" öffnen und Azure Sphere auswählen.

Nächste Schritte

Anfordern Ihres Geräts