Compartir vía

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

  • Artículo

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

  • Código en el equipo remoto y dispositivo en el equipo local.

  • Tanto el código como el dispositivo del equipo remoto.

No se admite un tercer escenario, el código del equipo local y el dispositivo del equipo remoto.

Configurar el equipo local

  1. Descarga e instala Visual Studio Code.

  2. Instale Azure Sphere SDK para Windows o Linux.

  3. Instale la extensión Azure Sphere buscando Azure Sphere en el panel de extensión de Visual Studio Code y haciendo clic en Instalar.

    Propina

    Hay dos Azure Sphere extensiones y la instalación de cualquiera de ellas instalará ambas: Azure Sphere UI para el componente de interfaz de usuario y Azure Sphere para el componente de área de trabajo.

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

Configurar el equipo remoto

  1. Le recomendamos encarecidamente que configure el equipo remoto para la autenticación basada en claves.
  2. Instale Azure Sphere SDK para Windows o Linux.

Código del equipo remoto y del dispositivo en el equipo local

  1. Conecta el dispositivo mediante USB a la máquina local.
  2. Si aún no hay un proyecto en el equipo remoto, puede clonar el repositorio de muestras u obtener un único proyecto del explorador de muestras de Microsoft.
  3. Abra Visual Studio Code localmente.
  4. Solo la primera vez: Abra Visual Studio Code desde View>Command Palette>Remote-SSH: Agregue nuevo host SSH e introduzca la información del host SSH cuando se le solicite. (De forma predeterminada, un archivo denominado config se escribe en el directorio .ssh de su directorio principal. A veces, esto provoca problemas de permisos si el equipo local es Windows. Es posible que desee mover el archivo a otro directorio y especificar la ruta de acceso absoluta en Extensiones deconfiguración> depreferencias> de archivo>remotas>- SSH: Archivo config.)

Conectarse al equipo remoto

  1. Conéctate al equipo remoto ejecutando el comando Visual Studio Code Ver> paleta > decomandosRemote-SSH: Conectar al host (Shift+Ctrl+P).

  2. Instale las extensiones de Azure Sphere en el equipo remoto buscando Azure Sphere en el panel de extensión de Visual Studio Code y haciendo clic en el botón Instalar en SSH: [nombre remoto]. Es posible que tengas que reiniciar Visual Studio Code y volver a conectarte al equipo remoto después de la instalación.

    Propina

    Para comprobar si la extensión está instalada correctamente en el equipo remoto, desactive el cuadro de búsqueda en el panel de extensión y asegúrese de que Azure Sphere las extensiones aparezcan en ssh : [remote name] - INSTALLED view.

  3. Abre la carpeta del proyecto o el área de trabajo con lacarpeta Abrirarchivo> o elárea de trabajo Abrirarchivo>.

Compilar, implementar en un dispositivo local y depurar

  1. Presione F5 para compilar y depurar el proyecto. Si el proyecto no se ha creado anteriormente o si los archivos han cambiado y es necesario recompilar, Visual Studio Code creará el proyecto antes de que se inicie la depuración.

  2. Espere varios segundos hasta que Visual Studio Code para crear la aplicación, crear un paquete de imagen, implementarlo en el panel e iniciarlo en modo de depuración. Durante el proceso, verá actualizaciones de estado en el panel Salida .

    En primer lugar, CMake determina si es necesario crear la aplicación. Si es así, el foco se desplaza a la ventana de salida, que muestra la salida de CMake/Build.

    A continuación, el panel Salida muestra el resultado cuando el paquete de imagen se implementa en el dispositivo. Por último, la consola de depuración recibe el foco y muestra la salida del depurador.

Usa el depurador Visual Studio Code para establecer puntos de interrupción, pausar, paso a paso, entrar, reiniciar o detener la aplicación.

Código y dispositivo en el equipo remoto

  1. Conecta el dispositivo mediante USB al equipo remoto.
  2. Si aún no hay un proyecto en el equipo remoto, puede clonar el repositorio de muestras u obtener un único proyecto del explorador de muestras de Microsoft.
  3. Abra Visual Studio Code localmente.
  4. Solo la primera vez: Abra Visual Studio Code desde View>Command Palette>Remote-SSH: Agregue nuevo host SSH e introduzca la información del host SSH cuando se le solicite. (De forma predeterminada, un archivo denominado config se escribe en el directorio .ssh de su directorio principal. A veces, esto provoca problemas de permisos si el equipo local es Windows. Es posible que desee mover el archivo a otro directorio y especificar la ruta de acceso absoluta en Extensiones deconfiguración> depreferencias> de archivo>remotas>- SSH: Archivo config.)

Conectarse al equipo remoto y configurar la configuración remota

  1. Conéctate al equipo remoto ejecutando el comando VS Code View>Command Palette>Remote-SSH: Conectar al host (Shift+Ctrl+P).

  2. Agregue la configuración remota ejecutando el comando VS Code Ver> preferencias depaleta> decomandos: Abra Configuración remota y agregue el campo siguiente al objeto JSON (si es un archivo vacío, debe ajustar esto):{}

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

    Puede agregar esta configuración a la configuración del usuario o área de trabajo en su lugar, según la configuración de sus proyectos y su equipo.

  3. Instale las extensiones de Azure Sphere en el equipo remoto buscando Azure Sphere en el panel de extensión de Visual Studio Code y haciendo clic en el botón Instalar en SSH: [nombre remoto]. Es posible que tengas que reiniciar Visual Studio Code y volver a conectarte al equipo remoto después de la instalación.

    Propina

    Para comprobar si la extensión está instalada correctamente en el equipo remoto, desactive el cuadro de búsqueda en el panel de extensión y asegúrese de que Azure Sphere las extensiones aparezcan en ssh : [remote name] - INSTALLED view.

  4. Abra la carpeta del proyecto o el área de trabajo con lacarpeta Abrirarchivo> o el área detrabajo Abrir archivo>'.

Compilar, implementar en un dispositivo remoto y depurar

  1. Presione F5 para compilar y depurar el proyecto. Si el proyecto no se ha creado anteriormente o si los archivos han cambiado y es necesario recompilar, Visual Studio Code creará el proyecto antes de que se inicie la depuración.

  2. Espere varios segundos hasta que Visual Studio Code para crear la aplicación, crear un paquete de imagen, implementarlo en el panel e iniciarlo en modo de depuración. Durante el proceso, verá actualizaciones de estado en el panel Salida .

    En primer lugar, CMake determina si es necesario crear la aplicación. Si es así, el foco se desplaza a la ventana de salida, que muestra la salida de CMake/Build.

    A continuación, el panel Salida muestra el resultado cuando el paquete de imagen se implementa en el dispositivo. Por último, la consola de depuración recibe el foco y muestra la salida del depurador.

Usa el depurador Visual Studio Code para establecer puntos de interrupción, pausar, paso a paso, entrar, reiniciar o detener la aplicación.

Cerrar la conexión

Para finalizar una sesión de depuración remota, selecciona Archivo>Cerrar conexión remota.