Uso de Visual Studio Code con Secure Shell (SSH) en un host remoto

Artículo
11/05/2024

Importante

Esta es la documentación de Azure Sphere (heredado). Azure Sphere (heredado) se retira el 27 de septiembre de 2027 y los usuarios deben migrar a Azure Sphere (integrado) en este momento. Use el selector de versiones situado encima de la TOC para ver la documentación de Azure Sphere (integrado).

Visual Studio Code se puede usar con el SDK de Azure Sphere para compilar y depurar código en un host remoto mediante Secure Shell (SSH). Se admiten dos escenarios:

Código en el equipo remoto y el dispositivo en la máquina local.
Tanto el código como el dispositivo en la máquina remota.

No se admite un tercer escenario( código en el equipo local y el dispositivo en la máquina remota).

Configuración de la máquina local

Descargue e instale Visual Studio Code.
Instale el SDK de Azure Sphere para Windows o Linux.
Para instalar la extensión de Azure Sphere, busque Azure Sphere en el panel de extensión de Visual Studio Code y haga clic en Instalar.

Sugerencia

Hay dos Azure Sphere extensiones y la instalación de cualquiera de ellas instalará: la interfaz de usuario de Azure Sphere para el componente de interfaz de usuario y Azure Sphere para el componente del área de trabajo.
Instale la extensión Remote-SSH buscando Remote-SSH en el panel de extensión de Visual Studio Code y haciendo clic en el botón Instalar .

Configuración de la máquina remota

Se recomienda encarecidamente configurar la máquina remota para la autenticación basada en claves.
Instale el SDK de Azure Sphere para Windows o Linux.

Código en el equipo remoto y el dispositivo en la máquina local

Conecte el dispositivo a través de USB a la máquina local.
Si aún no hay un proyecto en la máquina remota, puede clonar el repositorio de ejemplos o obtener un único proyecto del Explorador de ejemplos de Microsoft.
Abra Visual Studio Code localmente.
Solo la primera vez: abra Visual Studio Code desde la paleta>>de comandos Remote-SSH: agregue un nuevo host SSH y escriba la información del host SSH como se le solicite. (De forma predeterminada, se escribe un archivo denominado config en el directorio .ssh del directorio principal. Esto a veces provoca problemas de permisos si la máquina local es Windows. Es posible que desee mover el archivo a otro directorio y especificar la ruta de acceso absoluta en >Extensiones>de configuración de>preferencias>de archivo remoto - SSH: Archivo de configuración).

Conexión a la máquina remota

Conéctese a la máquina remota ejecutando el comando Ver>>paleta de comandos de Visual Studio Code Remote-SSH: Conectarse al host ().Shift+Ctrl+P
Instale las extensiones de Azure Sphere en la máquina remota; para ello, busque Azure Sphere en el panel de extensión de Visual Studio Code y haga clic en el botón Instalar en SSH: [nombre remoto]. Es posible que tenga que reiniciar Visual Studio Code y volver a conectarse a la máquina remota después de la instalación.

Sugerencia

Para comprobar si la extensión está instalada correctamente en la máquina remota, desactive el cuadro de búsqueda en el panel de extensión y asegúrese de que Azure Sphere las extensiones aparecen en la vista SSH: [nombre remoto] - INSTALADO .
Abra la carpeta del proyecto o el área de trabajo mediante archivo>abrir carpeta o abrir archivo>área de trabajo.

Compilación, implementación en un dispositivo local y depuración

Presione F5 para compilar y depurar el proyecto. Si el proyecto no se ha compilado previamente o si se han cambiado los archivos y se requiere la regeneración, Visual Studio Code compilará el proyecto antes de que se inicie la depuración.
Espere varios segundos para que Visual Studio Code compile la aplicación, cree un paquete de imágenes, impleméntelo en la placa e inícielo en modo de depuración. Verá las actualizaciones de estado en el panel Salida a lo largo del proceso.

En primer lugar, CMake determina si la aplicación debe compilarse. Si es así, el foco cambia a la ventana de salida, que muestra la salida de CMake/Build.

A continuación, el panel Salida muestra el resultado a medida que se implementa el paquete de imágenes en el dispositivo. Por último, la consola de depuración recibe el foco y muestra la salida del depurador.

Use el depurador de Visual Studio Code para establecer puntos de interrupción, pausar, recorrer paso a paso por instrucciones, reiniciar o detener la aplicación.

Código y dispositivo en la máquina remota

Conecte el dispositivo a través de USB a la máquina remota.
Si aún no hay un proyecto en la máquina remota, puede clonar el repositorio de ejemplos o obtener un único proyecto del Explorador de ejemplos de Microsoft.
Abra Visual Studio Code localmente.
Solo la primera vez: abra Visual Studio Code desde la paleta>>de comandos Remote-SSH: agregue un nuevo host SSH y escriba la información del host SSH como se le solicite. (De forma predeterminada, se escribe un archivo denominado config en el directorio .ssh del directorio principal. Esto a veces provoca problemas de permisos si la máquina local es Windows. Es posible que desee mover el archivo a otro directorio y especificar la ruta de acceso absoluta en >Extensiones>de configuración de>preferencias>de archivo remoto - SSH: Archivo de configuración).

Conexión a la máquina remota y configuración de opciones remotas

Conéctese a la máquina remota ejecutando el comando Ver paleta de comandos de>>VS Code Remote-SSH: Conectarse al host ().Shift+Ctrl+P
Agregue la configuración remota ejecutando comandos de VS Code Ver>preferencias de paleta>de comandos: Abra configuración remota y agregue el siguiente campo al objeto JSON (si es un archivo vacío, debe encapsularlo en ):{}
```
    "remote.extensionKind": {
        "ms-vscode.azure-sphere-tools-ui": [
            "workspace"
        ]
    }
```
Puede agregar esta configuración a la configuración del usuario o del área de trabajo en su lugar, en función de la configuración de los proyectos y el equipo.
Instale las extensiones de Azure Sphere en la máquina remota; para ello, busque Azure Sphere en el panel de extensión de Visual Studio Code y haga clic en el botón Instalar en SSH: [nombre remoto]. Es posible que tenga que reiniciar Visual Studio Code y volver a conectarse a la máquina remota después de la instalación.

Sugerencia

Para comprobar si la extensión está instalada correctamente en la máquina remota, desactive el cuadro de búsqueda en el panel de extensión y asegúrese de que Azure Sphere las extensiones aparecen en la vista SSH: [nombre remoto] - INSTALADO .
Abra la carpeta del proyecto o el área de trabajo mediante archivo>abrir carpeta o abrir archivo>área de trabajo".

Compilación, implementación en dispositivo remoto y depuración

Presione F5 para compilar y depurar el proyecto. Si el proyecto no se ha compilado previamente o si se han cambiado los archivos y se requiere la regeneración, Visual Studio Code compilará el proyecto antes de que se inicie la depuración.
Espere varios segundos para que Visual Studio Code compile la aplicación, cree un paquete de imágenes, impleméntelo en la placa e inícielo en modo de depuración. Verá las actualizaciones de estado en el panel Salida a lo largo del proceso.

En primer lugar, CMake determina si la aplicación debe compilarse. Si es así, el foco cambia a la ventana de salida, que muestra la salida de CMake/Build.

A continuación, el panel Salida muestra el resultado a medida que se implementa el paquete de imágenes en el dispositivo. Por último, la consola de depuración recibe el foco y muestra la salida del depurador.

Use el depurador de Visual Studio Code para establecer puntos de interrupción, pausar, recorrer paso a paso por instrucciones, reiniciar o detener la aplicación.

Cierre de la conexión

Para finalizar una sesión de depuración remota, seleccione Cerrar conexión remota de archivo>.

Compartir a través de