Snabbstart: Installera Azure Sphere SDK för Linux

Artikel
09/27/2024

Viktigt!

Det här är dokumentationen om Azure Sphere (Legacy). Azure Sphere (Legacy) upphör den 27 september 2027 och användarna måste migrera till Azure Sphere (integrerad) vid den här tiden. Använd versionsväljaren ovanför TOC för att visa dokumentationen om Azure Sphere (integrerad).

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

Installationen av Azure Sphere SDK 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 stegen:

Ladda ned installationsskriptet.
Navigera till mappen där du laddade ned den komprimerade filen.
Extrahera innehållet i den komprimerade filen. Exempel: tar xvfz install_azure_sphere_sdk_<version>.tar.gz Filen .tar.gz innehåller filen install_azure_sphere_sdk.sh.
Kör installationsskriptet med följande sudo :
```
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 visar skriptet bekräftelsemeddelanden. 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 frågor:

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 microsofts fingeravtryck för offentlig nyckel 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 Y för att ange Azure Sphere CLI som standard-CLI eller N för att ange klassiska Cli för Azure Sphere 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 azsphere-gruppen och skapa udev-regeln.

När installationen är klar måste du logga in igen till skrivbordsprogrammet eller inloggningsgränssnittet för att initiera CLI.

Efter installationen finns kommandot azsphere på PATH och de nya udev-reglerna för enheten finns på /etc/udev/rules.d/.

Skriptet installerar SDK till /opt/azurespheresdk och verktygskedjan till /opt/azurespheresdk/Sysroots/sysroot-version/tools, där sysroot-version identifierar en sysroot som SDK stöder apputveckling mot.

Installationsprogrammet installerar både Azure Sphere CLI och de klassiska CLI-versionerna av CLI i Azure Sphere. Du behöver inte avinstallera den aktuella versionen eftersom installationen uppdaterar någon befintlig version. Azure Sphere CLI installeras i /opt/azurespheresdk/Tools_v2 och klassiska Azure Sphere CLI installeras i /opt/azurespheresdk/Tools.

I Linux kan du köra Azure Sphere CLI från en terminal med och azsphere_v2 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 azsphere show-version.

Udev-regler

Azure Sphere SDK anger udev regler för din dators enhetsinformation. SDK skapar en ny grupp med namnet azsphere och lägger till den inloggade användaren i gruppen. Regeln udev ger ägarskap för USB-enheter som matchar Enhetsbeskrivningen för Azure Sphere. När du har installerat SDK och startat om datorn behöver du inte använda sudo för enhetsåterställning eller ARM Cortex-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 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), 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.
På installationsdatorn navigerar du till mappen som du överförde filerna till.
Extrahera innehållet i den komprimerade installationsskriptfilen. Exempel: tar xvfz install_azure_sphere_sdk_<version>.tar.gz Filen .tar.gz innehåller filen install_azure_sphere_sdk.sh. Lämna Azure Sphere SDK-paketet som en komprimerad tjärfil (tar.gz fil).
Kör installationsskriptet med .sudo Inkludera 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.

Konfigurera utvecklingsmiljön

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

Installera CMake och Ninja

Om du vill installera CMake och Ninja läser du först anvisningarna för att lägga till Kitware APT-lagringsplatsen i installationen och använder sedan följande kommando:

sudo apt-get install cmake ninja-build

Kommentar

Installera inte cmake eller ninja med snäpp.

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

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

Använd länkarna i Ladda ned Visual Studio Code för att installera Visual Studio Code, om du inte redan har gjort det.
Om du vill installera Azure Sphere-tillägget söker du efter "Azure Sphere" på Marketplace-tillägget från en webbläsare eller i Visual Studio Code. Du bör se två resultat, Azure Sphere och Azure Sphere-användargränssnittet. Välj Installera för någon av dem. Den andra ska installeras automatiskt.
Efter installationen bör du se tilläggen Azure Sphere, C/C++ och CMake Tools i fönstret AKTIVERADE tillägg i Visual Studio Code IDE.

När installationen är klar öppnas Readme-sidan för tillägget. Sidan Readme innehåller användbar information om Konfiguration och krav för Visual Studio Code 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

Dela via