Snabbstart: Installera Azure Sphere SDK för Linux
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 ellerN
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 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 både Azure Sphere CLI och azure sphere klassiska CLI-versioner av CLI. Du behöver inte avinstallera den aktuella versionen eftersom någon befintlig version uppdateras vid installationen. Azure Sphere CLI installeras i /opt/azuresfärsdk/Tools_v2 och Azure Sphere klassiska CLI installeras i /opt/azuresfärsdk/Tools.
På Linux kan du köra Azure Sphere 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), 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.
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.