Använda Visual Studio Code med Secure Shell (SSH) på en fjärrvärd

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

Visual Studio Code kan användas med Azure Sphere SDK för att skapa och felsöka kod på en fjärrvärd via Secure Shell (SSH). Två scenarier stöds:

Kod på fjärrdatorn och enheten på den lokala datorn.
Både kod och enhet på fjärrdatorn.

Ett tredje scenario – kod på den lokala datorn och enheten på fjärrdatorn – stöds inte.

Konfigurera den lokala datorn

Ladda ned och installera Visual Studio Code.
Installera Azure Sphere SDK för Windows eller Linux.
Installera Azure Sphere-tillägget genom att söka efter Azure Sphere i Visual Studio Code-tilläggspanelen och klicka på Installera.

Dricks

Det finns två Azure Sphere tillägg och om du installerar något av dem installeras båda: Azure Sphere-användargränssnittet för användargränssnittskomponenten och Azure Sphere för arbetsytekomponenten.
Installera Remote-SSH-tillägget genom att söka efter Remote-SSH i Visual Studio Code-tilläggspanelen och klicka på knappen Installera .

Konfigurera fjärrdatorn

Vi rekommenderar starkt att du konfigurerar fjärrdatorn för nyckelbaserad autentisering.
Installera Azure Sphere SDK för Windows eller Linux.

Kod på fjärrdatorn och enheten på den lokala datorn

Anslut enheten via USB till den lokala datorn.
Om det inte finns något projekt ännu på fjärrdatorn kan du antingen klona exempellagringsplatsen eller hämta ett enda projekt från Microsoft Samples Browser.
Öppna Visual Studio Code lokalt.
Endast första gången: Öppna Visual Studio Code från Visa>kommandopaletten>Remote-SSH: Lägg till ny SSH-värd och ange SSH-värdinformation enligt uppmaningen. (Som standard skrivs en fil med namnet config till .ssh-katalogen i din hemkatalog. Detta orsakar ibland behörighetsproblem om den lokala datorn är Windows. Du kanske vill flytta filen till en annan katalog och ange den absoluta sökvägen i Filinställningar>>Inställningar>Tillägg>Remote - SSH: Config File.)

Ansluta till fjärrdatorn

Anslut till fjärrdatorn genom att köra Visual Studio Code-kommandot View>Command Palette>Remote-SSH: Connect to host (Shift+Ctrl+P).
Installera Azure Sphere-tilläggen på fjärrdatorn genom att söka efter Azure Sphere i Visual Studio Code-tilläggspanelen och klicka på knappen Installera i SSH: [fjärrnamn]. Du kan behöva starta om Visual Studio Code och återansluta till fjärrdatorn efter installationen.

Dricks

Om du vill kontrollera om tillägget är korrekt installerat på fjärrdatorn avmarkerar du sökrutan i tilläggspanelen och kontrollerar att Azure Sphere tilläggen visas i vyn SSH: [fjärrnamn] – INSTALLERAT .
Öppna projektmappen eller arbetsytan med hjälp av Öppna filmapp> eller Öppna filarbetsyta.>

Skapa, distribuera till lokal enhet och felsöka

Tryck på F5 för att skapa och felsöka projektet. Om projektet inte har skapats tidigare, eller om filer har ändrats och återskapats krävs, skapar Visual Studio Code projektet innan felsökningen startar.
Vänta några sekunder tills Visual Studio Code har skapat programmet, skapa ett avbildningspaket, distribuera det till brädet och starta det i felsökningsläge. Statusuppdateringar visas i fönstret Utdata längs vägen.

Först avgör CMake om programmet behöver skapas. I så fall flyttas fokus till utdatafönstret, som visar utdata från CMake/Build.

Därefter visar fönstret Utdata resultatet när avbildningspaketet distribueras till enheten. Slutligen får felsökningskonsolen fokus och visar felsökningsutdata.

Använd Visual Studio Code-felsökningsprogrammet för att ange brytpunkter, pausa, gå över, gå in i, starta om eller stoppa programmet.

Kod och enhet på fjärrdatorn

Anslut enheten via USB till fjärrdatorn.
Om det inte finns något projekt ännu på fjärrdatorn kan du antingen klona exempellagringsplatsen eller hämta ett enda projekt från Microsoft Samples Browser.
Öppna Visual Studio Code lokalt.
Endast första gången: Öppna Visual Studio Code från Visa>kommandopaletten>Remote-SSH: Lägg till ny SSH-värd och ange SSH-värdinformation enligt uppmaningen. (Som standard skrivs en fil med namnet config till .ssh-katalogen i din hemkatalog. Detta orsakar ibland behörighetsproblem om den lokala datorn är Windows. Du kanske vill flytta filen till en annan katalog och ange den absoluta sökvägen i Filinställningar>>Inställningar>Tillägg>Remote - SSH: Config File.)

Anslut till fjärrdatorn och konfigurera fjärrinställningar

Anslut till fjärrdatorn genom att köra VS Code-kommandot Visa>kommandopaletten>Remote-SSH: Anslut till värden ().Shift+Ctrl+P
Lägg till fjärrinställningar genom att köra VS Code-kommandot Visa>kommandopalettinställningar>: Öppna Fjärrinställningar och lägg till följande fält i JSON-objektet (om det är en tom fil måste du omsluta detta i ):{}
```
    "remote.extensionKind": {
        "ms-vscode.azure-sphere-tools-ui": [
            "workspace"
        ]
    }
```
Du kan lägga till den här inställningen i användar-/arbetsyteinställningarna i stället, beroende på hur dina projekt och ditt team konfigureras.
Installera Azure Sphere-tilläggen på fjärrdatorn genom att söka efter Azure Sphere i Visual Studio Code-tilläggspanelen och klicka på knappen Installera i SSH: [fjärrnamn]. Du kan behöva starta om Visual Studio Code och återansluta till fjärrdatorn efter installationen.

Dricks

Om du vill kontrollera om tillägget är korrekt installerat på fjärrdatorn avmarkerar du sökrutan i tilläggspanelen och kontrollerar att Azure Sphere tilläggen visas i vyn SSH: [fjärrnamn] – INSTALLERAT .
Öppna projektmappen eller arbetsytan med hjälp av Öppna filmapp> eller Öppna>filarbetsyta.

Skapa, distribuera till fjärrenhet och felsöka

Tryck på F5 för att skapa och felsöka projektet. Om projektet inte har skapats tidigare, eller om filer har ändrats och återskapats krävs, skapar Visual Studio Code projektet innan felsökningen startar.
Vänta några sekunder tills Visual Studio Code har skapat programmet, skapa ett avbildningspaket, distribuera det till brädet och starta det i felsökningsläge. Statusuppdateringar visas i fönstret Utdata längs vägen.

Först avgör CMake om programmet behöver skapas. I så fall flyttas fokus till utdatafönstret, som visar utdata från CMake/Build.

Därefter visar fönstret Utdata resultatet när avbildningspaketet distribueras till enheten. Slutligen får felsökningskonsolen fokus och visar felsökningsutdata.

Använd Visual Studio Code-felsökningsprogrammet för att ange brytpunkter, pausa, gå över, gå in i, starta om eller stoppa programmet.

Stäng anslutningen

Om du vill avsluta en fjärrfelsökningssession väljer du Fjärranslutning för filstängning>.

Dela via