Condividi tramite

Uso di Visual Studio Code con Secure Shell (SSH) in un host remoto

  • Articolo

Importante

Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).

Visual Studio Code può essere usato con Azure Sphere SDK per compilare ed eseguire il debug del codice in un host remoto tramite Secure Shell (SSH). Sono supportati due scenari:

  • Codice nel computer remoto e nel dispositivo nel computer locale.

  • Sia il codice che il dispositivo nel computer remoto.

Un terzo scenario, ovvero il codice nel computer locale e nel dispositivo nel computer remoto, non è supportato.

Configurare il computer locale

  1. Scaricare e installare Visual Studio Code.

  2. Installare Azure Sphere SDK per Windows o Linux.

  3. Installare l'estensione Azure Sphere cercando Azure Sphere nel pannello dell'estensione di Visual Studio Code e facendo clic su Installa.

    Suggerimento

    Sono disponibili due Azure Sphere estensioni, che verranno installate entrambe: l'interfaccia utente di Azure Sphere per il componente dell'interfaccia utente e Azure Sphere per il componente dell'area di lavoro.

  4. Installare l'estensione Remote-SSH cercando Remote-SSH nel pannello dell'estensione di Visual Studio Code e facendo clic sul pulsante Installa .

Configurare il computer remoto

  1. È consigliabile configurare il computer remoto per l'autenticazione basata su chiave.
  2. Installare Azure Sphere SDK per Windows o Linux.

Codice nel computer remoto e nel dispositivo nel computer locale

  1. Connettere il dispositivo tramite USB al computer locale.
  2. Se non è ancora presente un progetto nel computer remoto, è possibile clonare il repository degli esempi o ottenere un singolo progetto dal browser Microsoft Samples.
  3. Aprire Visual Studio Code in locale.
  4. Solo prima volta: aprire Visual Studio Code da Visualizza>riquadro>comandi Remote-SSH: aggiungere un nuovo host SSH e immettere le informazioni sull'host SSH come richiesto. Per impostazione predefinita, nella home directory viene scritto un file denominato config. Ciò talvolta causa problemi di autorizzazioni se il computer locale è Windows. È possibile spostare il file in un'altra directory e specificare il percorso assoluto in Estensioni>impostazioni>preferenze>file>Remote - SSH: File di configurazione.

Connettersi al computer remoto

  1. Connettersi al computer remoto eseguendo il comando Visualizza riquadro comandi >di>Visual Studio Code Remote-SSH: Connettersi all'host ().Shift+Ctrl+P

  2. Installare le estensioni di Azure Sphere nel computer remoto cercando Azure Sphere nel pannello dell'estensione di Visual Studio Code e facendo clic sul pulsante Installa in SSH: [nome remoto]. Potrebbe essere necessario riavviare Visual Studio Code e riconnettersi al computer remoto dopo l'installazione.

    Suggerimento

    Per verificare se l'estensione è installata correttamente nel computer remoto, deselezionare la casella di ricerca nel pannello dell'estensione e assicurarsi che Azure Sphere le estensioni siano visualizzate nella visualizzazione SSH: [remote name] - INSTALLED .

  3. Aprire la cartella del progetto o l'area di lavoro usando l'area di lavoro Apri>cartella o Apri file.>

Compilare, distribuire nel dispositivo locale ed eseguire il debug

  1. Premere F5 per compilare ed eseguire il debug del progetto. Se il progetto non è stato compilato in precedenza o se i file sono stati modificati e la ricompilazione è necessario, Visual Studio Code compilerà il progetto prima dell'avvio del debug.

  2. Attendere alcuni secondi per consentire a Visual Studio Code di compilare l'applicazione, creare un pacchetto immagine, distribuirlo nella scheda e avviarlo in modalità di debug. Nel riquadro Output verranno visualizzati gli aggiornamenti dello stato.

    Prima di tutto, CMake determina se l'applicazione deve essere compilata. In tal caso, lo stato attivo passa alla finestra di output, che visualizza l'output da CMake/Build.

    Il riquadro Output mostra quindi il risultato quando il pacchetto immagine viene distribuito nel dispositivo. Infine, la console di debug riceve lo stato attivo e mostra l'output del debugger.

Usare il debugger di Visual Studio Code per impostare punti di interruzione, sospendere, eseguire il passaggio, eseguire l'istruzione, riavviare o arrestare l'applicazione.

Codice e dispositivo nel computer remoto

  1. Connettere il dispositivo tramite USB al computer remoto.
  2. Se non è ancora presente un progetto nel computer remoto, è possibile clonare il repository degli esempi o ottenere un singolo progetto dal browser Microsoft Samples.
  3. Aprire Visual Studio Code in locale.
  4. Solo prima volta: aprire Visual Studio Code da Visualizza>riquadro>comandi Remote-SSH: aggiungere un nuovo host SSH e immettere le informazioni sull'host SSH come richiesto. Per impostazione predefinita, nella home directory viene scritto un file denominato config. Ciò talvolta causa problemi di autorizzazioni se il computer locale è Windows. È possibile spostare il file in un'altra directory e specificare il percorso assoluto in Estensioni>impostazioni>preferenze>file>Remote - SSH: File di configurazione.

Connettersi al computer remoto e configurare le impostazioni remote

  1. Connettersi al computer remoto eseguendo il comando Visualizza>riquadro comandi> di VS Code Remote-SSH: Connettersi all'host ().Shift+Ctrl+P

  2. Aggiungere le impostazioni remote eseguendo il comando di VS Code Visualizza>preferenze del>riquadro comandi: Apri impostazioni remote e aggiungi il campo seguente all'oggetto JSON (se si tratta di un file vuoto, devi eseguirne il wrapping in ):{}

        "remote.extensionKind": {
        "ms-vscode.azure-sphere-tools-ui": [
            "workspace"
        ]
    }

    È possibile aggiungere questa impostazione alle impostazioni utente/area di lavoro, a seconda della configurazione dei progetti e del team.

  3. Installare le estensioni di Azure Sphere nel computer remoto cercando Azure Sphere nel pannello dell'estensione di Visual Studio Code e facendo clic sul pulsante Installa in SSH: [nome remoto]. Potrebbe essere necessario riavviare Visual Studio Code e riconnettersi al computer remoto dopo l'installazione.

    Suggerimento

    Per verificare se l'estensione è installata correttamente nel computer remoto, deselezionare la casella di ricerca nel pannello dell'estensione e assicurarsi che Azure Sphere le estensioni siano visualizzate nella visualizzazione SSH: [remote name] - INSTALLED .

  4. Aprire la cartella o l'area di lavoro del progetto usando l'area di lavoro Apri>cartella o Apri file>'.

Compilare, distribuire nel dispositivo remoto ed eseguire il debug

  1. Premere F5 per compilare ed eseguire il debug del progetto. Se il progetto non è stato compilato in precedenza o se i file sono stati modificati e la ricompilazione è necessario, Visual Studio Code compilerà il progetto prima dell'avvio del debug.

  2. Attendere alcuni secondi per consentire a Visual Studio Code di compilare l'applicazione, creare un pacchetto immagine, distribuirlo nella scheda e avviarlo in modalità di debug. Nel riquadro Output verranno visualizzati gli aggiornamenti dello stato.

    Prima di tutto, CMake determina se l'applicazione deve essere compilata. In tal caso, lo stato attivo passa alla finestra di output, che visualizza l'output da CMake/Build.

    Il riquadro Output mostra quindi il risultato quando il pacchetto immagine viene distribuito nel dispositivo. Infine, la console di debug riceve lo stato attivo e mostra l'output del debugger.

Usare il debugger di Visual Studio Code per impostare punti di interruzione, sospendere, eseguire il passaggio, eseguire l'istruzione, riavviare o arrestare l'applicazione.

Chiudere la connessione

Per terminare una sessione di debug remoto, selezionare Chiudi>connessione remota file.