Schnellstart: Installieren des Azure Sphere SDK für Linux

  • Artikel

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

Voraussetzungen

Für die Installation des Azure Sphere SDK sind die folgenden Voraussetzungen erforderlich:

  • Ein Azure Sphere Development Kit.
  • Ein Computer mit einem x86-64-basierten Prozessor mit 64-Bit-Ubuntu 24.04 (Vorabversion), Ubuntu 22.04 LTS oder Ubuntu 20.04 LTS. Es werden nur Intel-kompatible x86-64-Prozessoren 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.
  • Linux-Berechtigung sudo .
  • Eine Internetverbindung oder eine Möglichkeit zum Übertragen von Dateien von einem Computer, der über eine Internetverbindung zu Ihrem Computer verfügt. 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 Ihrem Computer erforderliche Linux-Pakete hinzufügen, sofern diese noch nicht installiert sind. Geben Sie die folgenden Zeilen in ein Linux-Terminal ein. Sie können pakete weglassen, die bereits installiert sind.

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

Installieren des Azure Sphere SDK

Führen Sie die folgenden Schritte aus:

  1. Laden Sie das Installationsskript herunter.

  2. Navigieren Sie zu dem Ordner, in den Sie die komprimierte Datei heruntergeladen haben.

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

  4. Führen Sie das Installationsskript wie folgt aus sudo :

    sudo ./install_azure_sphere_sdk.sh

    Wenn der Fehler command not found beim Ausführen des Skripts angezeigt wird, aktivieren Sie die Ausführung des Installationsskripts mit dem folgenden Befehl:

    chmod +x install_azure_sphere_sdk.sh

  5. Während der Installation zeigt das Skript Bestätigungsmeldungen an. Bestätigungsmeldungen können übersprungen werden, indem das Skript mit dem -y Flag aufgerufen wird:

    sudo ./install_azure_sphere_sdk.sh -y

    Ohne das -y Flag 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 Fingerabdruck des öffentlichen Schlüssels von Microsoft übereinstimmt, der auf der Seite angezeigt wird. Fahren Sie nicht fort, wenn die beiden Fingerabdrücke nicht übereinstimmen.

    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)

    Legen Sie die Azure Sphere-CLI als Standard-CLI fest, oder N legen Sie Y die klassische Azure Sphere-CLI als Standard-CLI fest.

    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 aus Y , um die azsphere group einzurichten, und erstellen Sie die udev-Regel.

  6. Nach Abschluss der Installation müssen Sie sich erneut bei Ihrer Desktopanwendung oder Anmeldeshell anmelden, um die CLI zu initialisieren.

Nach der Installation befindet sich der Befehl azsphere im PFAD, und die neuen udev-Regeln für Ihr Gerät befinden sich unter /etc/udev/rules.d/.

Das Skript installiert das SDK in /opt/azurespheresdk und die Toolchains in /opt/azurespheresdk/Sysroots/sysroot-version/tools, wobei sysroot-version einen sysroot identifiziert, für den das SDK die App-Entwicklung unterstützt.

Das Installationsprogramm installiert sowohl die Azure Sphere-CLI als auch die klassische Azure Sphere-CLI-Versionen der CLI. Sie müssen die aktuelle Version nicht deinstallieren, da die Installation eine vorhandene Version aktualisiert. Die Azure Sphere-CLI wird in /opt/azurespheresdk/Tools_v2 und die klassische Azure Sphere-CLI in /opt/azurespheresdk/Tools installiert.

Unter Linux können Sie die Azure Sphere-CLI über ein Terminal ausführen, indem azsphere_v2 Sie und azsphere verwenden, wenn 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 über die richtige Version verfügen, 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 namens azsphere und fügt der Gruppe den aktuell angemeldeten Benutzer hinzu. Die udev Regel gewährt den Besitz von USB-Geräten, die der Azure Sphere-Gerätebeschreibung entsprechen. Nachdem Sie das SDK installiert und Ihren Computer neu gestartet haben, müssen Sie nicht mehr für die Gerätewiederherstellung oder das ARM Cortex-M4-Debuggen verwenden sudo .

Die azsphere Gruppe wird hinzugefügt, um Berechtigungen mithilfe der udev Regel zu erteilen. Ändern Sie die Gruppe nicht manuell.

Installieren des SDK ohne Internetverbindung

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

  1. Laden Sie diese Dateien herunter, und übertragen Sie sie auf den Installationscomputer:

  2. Navigieren Sie auf dem Installationscomputer zu dem Ordner, in den Sie die Dateien übertragen haben.

  3. 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. Behalten Sie das Azure Sphere SDK-Paket als komprimierte TAR-Datei (tar.gz Datei) bei.

  4. Führen Sie das Installationsskript mit aus sudo. Schließen Sie den -i Parameter ein, um den Pfad zum SDK-Bündel anzugeben, und den -k Parameter, 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 der Fehler command not found beim Ausführen des Skripts angezeigt wird, aktivieren Sie die Ausführung des Installationsskripts mit dem folgenden Befehl:

    chmod +x install_azure_sphere_sdk.sh

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

Einrichten Ihrer Entwicklungsumgebung

Sie können Azure Sphere-Apps unter Linux entweder mit Visual Studio Code oder der Befehlszeilenschnittstelle (CLI) entwickeln. Unabhängig davon, welches Sie verwenden, müssen Sie CMake und Ninja auf Ihrem Entwicklungscomputer installieren, sofern sie noch nicht vorhanden sind. Weitere Informationen finden Sie in den Anweisungen zum Hinzufügen des APT-Repositorys für Kitware zu Ihrer Installation.

Installieren von CMake und Ninja

Um CMake und Ninja zu installieren, 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.

  1. Verwenden Sie die Links unter Herunterladen von Visual Studio Code , um Visual Studio Code zu installieren, sofern noch nicht geschehen.

  2. Um die Azure Sphere-Erweiterung zu installieren, suchen Sie im Erweiterungs-Marketplace in einem Browser oder in Visual Studio Code nach "Azure Sphere". Es sollten zwei Ergebnisse angezeigt werden: Azure Sphere und Azure Sphere-Benutzeroberfläche. Wählen Sie installieren für eines der beiden Optionen aus. der andere sollte automatisch installiert werden.

  3. Nach der Installation sollten die Erweiterungen Azure Sphere, C/C++ und CMake Tools im Bereich ENABLED-Erweiterungen in der Visual Studio Code-IDE angezeigt werden.

Nach Abschluss der Installation wird die Infodateiseite für die Erweiterung geöffnet. Die Infoseite enthält nützliche Informationen zur Konfiguration und den Anforderungen von Visual Studio Code und wird zusammen mit der Erweiterung aktualisiert. Sie können die Infodateiseite jederzeit anzeigen, indem Sie den Bereich Erweiterungen öffnen und Azure Sphere auswählen.

Nächste Schritte

Fordern Sie Ihr Gerät an