Utvecklingsmiljö
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 utveckla program för Azure Sphere i Windows 11, Windows 10 Anniversary Update (eller senare) eller på en Linux-dator som kör Ubuntu 24.04 (förhandsversion), Ubuntu 22.04 LTS eller Ubuntu 20.04 LTS. Om du använder Windows 11 använder du versionen 22.02 (eller senare) av Azure Sphere SDK.
- Installera Windows SDK för Windows. Du kan använda Visual Studio, Visual Studio Code eller kommandoraden för att skapa, distribuera och felsöka program i Windows.
- Installera Linux SDK för Linux. Du kan använda Visual Studio Code eller kommandoraden för att skapa, distribuera och felsöka program i Linux.
Azure Sphere SDK innehåller följande huvudkomponenter:
- Sysroots, som innehåller bibliotek, huvudfiler och verktyg som används för att kompilera och länka ett program som är avsett för en viss API-uppsättning.
- Maskinvarudefinitioner som beskriver de maskinvarufunktioner som är tillgängliga på olika maskinvaruenheter och kan användas för att ange dessa i app-manifest.json filer.
- CMakeFiles, som definierar Azure Sphere-tilläggen till CMake.
- Kommandoradsgränssnittet för Azure Sphere (CLI).
Självstudierna beskriver hur du skapar och distribuerar ditt första program. Vi tillhandahåller även en lagringsplats med exempel på GitHub som innehåller exempelprogram som visar hur du programmerar Azure Sphere-maskinvara och använder API:erna.
Azure Sphere Application Runtime
Azure Sphere Application Runtime innehåller två uppsättningar bibliotek för programutveckling på hög nivå: bas-API:erna och applibs-API:erna. Bas-API :erna baseras på bibliotek som inte enbart riktar sig till Azure Sphere-enheter, medan applibs-API: erna specifikt riktar sig till Azure Sphere-enheter. Högnivåprogram som skapats med Azure Sphere SDK kompilerar och länkar till dessa gränssnitt. Dessa API:er kan inte användas i realtidskompatibla program.
Huvudfilerna för bas-API:erna installeras i mapparna Sysroots\API set\usr\include i Installationskatalogen för Azure Sphere SDK. Huvudfilerna för applibs-API:erna installeras i mappen Sysroots\API set\usr\include\applibs i installationskatalogen för Azure Sphere SDK.
Dricks
POSIX C-standardrubrikerna finns i två mappar: Sysroots\API set\usr\include för allmänna API-huvuden och Sysroots\API set\usr\include\sys för systemberoende API-huvuden på låg nivå. Vi rekommenderar att du använder de allmänna API:erna.
Verktyg
Azure Sphere SDK innehåller Azure Sphere CLI för att hantera enheter, utveckla och distribuera program och arbeta med molntjänster.
CMake, tillsammans med det lätta Ninja-byggverktyget, tillhandahåller byggsamordning för Azure Sphere-program. Om du använder Visual Studio installeras CMake och Ninja automatiskt åt dig. Om du använder Visual Studio Code eller Azure Sphere CLI måste du installera dem själv i Windows eller Linux.
Både Visual Studio och Visual Studio Code har Azure Sphere-tillägg som förenklar utvecklingen av Azure Sphere-program. Med dessa tillägg kan du enkelt skapa, felsöka, testa och distribuera dina Azure Sphere-program direkt från IDE. Båda tilläggen har fullt stöd för Azure Spheres CMake-verktyg.
Containers
Azure Sphere tillhandahåller en container som paketerade SDK:et i en fristående Linux-miljö. Genom att använda en container med en fördefinierad byggmiljö kan du undvika stegen för att installera (eller avinstallera och sedan installera om) rätt SDK-byggmiljö. Du kan ändra byggmiljön så att den passar dina egna behov och replikera den miljön till alla dina värddatorer samtidigt med enhetliga resultat. Mer information finns i Använda containrar för att skapa Azure Sphere-appar . Du kan också använda en container som en del av ett scenario för kontinuerlig integrering där en bygg-pipeline som GitHub Actions eller Azure Pipelines automatiskt återskapar ditt program när en ändring görs i den underliggande koden. Mer information finns i Lägga till kontinuerlig integrering i dina containerversioner .
Vad är en container?
Containrar är bärbara paket som levereras med sina egna lätta miljöer som körs på en värddators kernel. Containrar är lätta eftersom de använder delade lager. Dessa lager kan delas sektorer i ett operativsystem eller delade program. Lager undviker omkostnaderna för en virtuell dator, som innehåller ett helt operativsystem och alla associerade program. Delning gör att containrar kan vara små och starta snabbt.
Du kan ladda ned containrar från ett containerregister, till exempel Microsofts artefaktregister (MAR).
Vilka containrar tar med sig till Azure Sphere
Containern för Microsoft Azure Sphere SDK-byggmiljön ger dig en fördefinierad utvecklingsmiljö. Containern tillhandahåller följande:
- Versionen av Ubuntu Linux för den aktuella Azure Sphere-versionen
- Den aktuella versionen av Azure Sphere SDK för Linux
- Ytterligare verktyg som behövs av SDK som CMake och Ninja
Azure Sphere använder Docker-containrar som har konfigurerats med Dockerfile-textfiler . Du kan skapa Dockerfiles som använder en bascontaineravbildning för att skapa en anpassad container för att skapa Azure Sphere-program. När du kör den anpassade containern hämtas den senaste basavbildningen om den inte finns på värddatorn, skapar den nya anpassade containern om det behövs, skapar det angivna programmet och avslutar. Du kan sedan kopiera utdata från programversionen till en värddator som har Azure Sphere SDK installerat och separat läsa in programmet på en enhet. Den anpassade byggcontainern används vanligtvis inte interaktivt, men det kan till exempel vara för att diagnostisera byggproblem.