Snabbstart: Installera Azure Sphere SDK för Linux

Artikel
03/26/2024

Du kan installera Azure Sphere SDK på en dator som kör Linux-operativsystemet för att utveckla, distribuera och felsöka Azure Sphere-program.

Förutsättningar

Azure Sphere SDK-installationen kräver följande krav:

Ett Azure Sphere-utvecklingspaket.
En dator med en x86-64-baserad processor som kör 64-bitars Ubuntu 24.04 (förhandsversion), Ubuntu 22.04 LTS eller Ubuntu 20.04 LTS. Endast Intel-kompatibla x86-64-processorer stöds. andra arkitekturer som ARM (inklusive Raspberry Pi), Itanium eller SPARC stöds inte . X86-64-arkitekturen kallas även x64, x86_64, AMD64 och Intel 64.
Linux-behörighet sudo .
En Internetanslutning eller ett sätt att överföra filer från en dator som har en Internetanslutning till datorn. Mer information finns i Installera SDK utan internetanslutning.

Lägga till nödvändiga Linux-paket

Innan du kör SDK-installationsskriptet måste du lägga till nödvändiga Linux-paket på datorn om de inte redan är installerade. Ange följande rader i en Linux-terminal. Du kan utelämna paket som redan är installerade.

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

Installera Azure Sphere SDK

Följ de här anvisningarna:

Ladda ned installationsskriptet.
Gå till mappen som du laddade ned den komprimerade filen till.
Extrahera innehållet i den komprimerade filen. Till exempel tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Den .tar.gz filen innehåller den install_azure_sphere_sdk.sh filen.
Kör installationsskriptet på sudo följande sätt:
```
sudo ./install_azure_sphere_sdk.sh
```
Om du ser felet command not found när du kör skriptet aktiverar du körning av installationsskriptet med det här kommandot:
```
chmod +x install_azure_sphere_sdk.sh
```

Under installationen visas bekräftelsemeddelanden i skriptet. Bekräftelsemeddelanden kan hoppas över genom att anropa skriptet med -y flaggan:

sudo ./install_azure_sphere_sdk.sh -y

-y Utan flaggan förväntar sig skriptet svar på följande uppmaningar:

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)

Gå till Microsofts offentliga fingeravtryckswebbplats och kontrollera att det hexadecimala fingeravtrycksvärdet som visas under installationen matchar Microsoft Public Key Fingerprint som visas på sidan. Fortsätt inte om de två fingeravtrycken inte matchar.

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)

Välj det här alternativet om du Y vill ange Azure Sphere CLI som standard-CLI eller N för att ange azure sphere klassisk CLI som standard 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)

Välj Y för att konfigurera azsfärgruppen och skapa udevregeln.

När installationen är klar måste du logga in igen i skrivbordsprogrammet eller inloggningsgränssnittet för att initiera Azure Sphere (legacy) CLI.

Efter installationen finns azsfärkommandot på PATH och de nya udev-reglerna för din enhet är på /etc/udev/rules.d/.

Skriptet installerar SDK till /opt/azuresfärsdk och verktygschains till /opt/azuresfärsdk/Sysroots/sysroot-version/tools, där sysroot-versionen identifierar en sysroot mot vilken SDK:et stöder apputveckling.

Installationsprogrammet installerar Cli-versionerna av Azure Sphere (legacy). Du behöver inte avinstallera den aktuella versionen eftersom någon befintlig version uppdateras vid installationen. Azure Sphere (äldre) CLI installeras i /opt/azuresfärsdk/Tools_v2 och Azure Sphere (äldre) klassiska CLI installeras i /opt/azuresfärsdk/Tools.

På Linux kan du köra Azure Sphere (legacy) CLI från en terminal med azsphere_v2 och azsphere om det valdes som standard CLI under installationen.

När du har installerat CLI för första gången kontrollerar du att det är installerat och att du har rätt version genom att köra azsfärvisningsversionen.

Udev-regler

Azure Sphere SDK anger udev regler för datorns enhetsinformation. SDK:et skapar en ny grupp som heter azsphere och lägger till den inloggade användaren i gruppen. Regeln udev beviljar ägarskap för USB-enheter som matchar beskrivningen av Azure Sphere-enheten. När du har installerat SDK:et och startat om datorn behöver du inte använda sudo för enhetsåterställning eller ARM Emoji-M4-felsökning.

Gruppen azsphere läggs till för att bevilja behörigheter med hjälp av udev regeln. Ändra inte gruppen manuellt.

Installera SDK:et utan internetanslutning

Om du inte har någon Internetanslutning på den dator där du installerar SDK:t måste du ladda ned filerna till en dator som är ansluten till Internet och överföra dem till installationsdatorn.

Ladda ned dessa filer och överför dem till installationsdatorn:
- Azure Sphere SDK för Linux: välj mellan Ubuntu 24.04 (förhandsversion) eller Ubuntu 22.04 LTS eller Ubuntu 20.04 LTS.
  
  Den nedladdade filen är en komprimerad tjärfil (.tar.gz fil) med ett namn som börjar Azure_Sphere_SDK_Bundle.
- Installationsskript: det här är en komprimerad tjärfil (.tar.gz fil) med ett namn som börjar install_azure_sphere_sdk.
- Microsofts offentliga GPG-nyckel: det här är en ASCII-textfil.
Gå till mappen som du överförde filerna till på installationsdatorn.
Extrahera innehållet i den komprimerade installationsskriptfilen. Till exempel tar xvfz install_azure_sphere_sdk_<version>.tar.gz. Den .tar.gz filen innehåller den install_azure_sphere_sdk.sh filen. Lämna Azure Sphere SDK Bundle som en komprimerad tjärfil (tar.gz fil).
Kör installationsskriptet med .sudo Ta med parametern -i för att ange sökvägen till SDK-paketet och parametern -k för att ange sökvägen till nyckeln. Kommandot bör se ut ungefär så här:

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

Om du ser felet command not found när du kör skriptet aktiverar du körning av installationsskriptet med det här kommandot:
```
chmod +x install_azure_sphere_sdk.sh
```

Fortsätt med installationen enligt beskrivningen i Installera Azure Sphere SDK.

Installera Azure Sphere-tillägget för Azure CLI

Kommandoradsverktyget för hantering av Azure Sphere-anslutna enheter och molndistributioner distribueras som ett Azure CLI-tillägg. Gör så här för att lägga till eller uppdatera tillägget:

Installera Azure CLI om du ännu inte har gjort det.

Om du vill lägga till Azure Sphere-tillägget kör du följande kommando:
```
az extension add --name azure-sphere
```
Om du vill uppdatera Azure Sphere-tillägget kör du följande kommando:
```
az extension udpate --name azure-sphere
```

Du måste logga in med Azure CLI för att logga in på den Azure-prenumeration som du vill använda för att hantera Azure Sphere-enheter.

Mer information finns i Ladda ned och köra Azure Sphere-tillägget.

Konfigurera utvecklingsmiljön

Du kan utveckla Azure Sphere-appar på Linux med antingen Visual Studio-kod eller kommandoradsgränssnittet (CLI). Oavsett vilken du använder måste du installera CMake och Ninja på din utvecklingsdator, om du inte redan har dem. Läs instruktionerna för att lägga till Kitware APT-lagringsplatsen i installationen.

Installera CMake och Ninja

Om du vill installera CMake och Ninja ska du först läsa instruktionerna för att lägga till Kitware APT-lagringsplatsen i installationen och sedan använda följande kommando:

sudo apt-get install cmake ninja-build

Observera

Installera inte cmake eller ninja med snap.

Installera Azure Sphere-tillägget för Visual Studio-kod

Om du vill använda Visual Studio-kod som utvecklingsmiljö måste du installera den och Azure Sphere-tillägget.

Använd länkarna i Ladda ned Visual Studio-kod för att installera Visual Studio-kod, om du inte redan har gjort det.
Om du vill installera Azure Sphere-tillägget söker du efter "Azure Sphere" på Extension Marketplace från en webbläsare eller med Visual Studio-kod. Du bör se två resultat: Azure Sphere och Azure Sphere-gränssnittet. Välj Installera för något av alternativen. den andra ska installeras automatiskt.
Efter installationen bör tilläggen Azure Sphere, C/C++ och CMake Tools visas i fönstret ENABLED Extensions i Visual Studio Code IDE.

När installationen är klar öppnas sidan Viktigt för tillägget. Sidan Viktigt innehåller användbar information om Visual Studio-kodkonfiguration och -krav och uppdateras tillsammans med tillägget. Du kan visa readme-sidan när som helst genom att öppna fönstret Tillägg och välja Azure Sphere.

Nästa steg

Gör anspråk på din enhet