Compartilhar via


Usando o Visual Studio Code com Secure Shell (SSH) em um host remoto

Importante

Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

O Visual Studio Code pode ser usado com o SDK do Azure Sphere para criar e depurar código em um host remoto por meio do SSH (Secure Shell). Há suporte para dois cenários:

  • Código na máquina remota e dispositivo na máquina local.

  • Código e dispositivo na máquina remota.

Um terceiro cenário — código na máquina local e dispositivo na máquina remota — não é suportado.

Configurar a máquina local

  1. Baixar e instalar o Visual Studio Code.

  2. Instale o SDK do Azure Sphere para Windows ou Linux.

  3. Instale a extensão do Azure Sphere pesquisando o Azure Sphere no painel de extensão do Visual Studio Code e clicando em Instalar.

    Dica

    Há duas Azure Sphere extensões e a instalação de qualquer uma delas instalará ambas: a interface do usuário do Azure Sphere para o componente de interface do usuário e o Azure Sphere para o componente de workspace.

  4. Instale a extensão Remote-SSH pesquisando Remote-SSH no painel de extensão do Visual Studio Code e clicando no botão Instalar .

Configurar a máquina remota

  1. É altamente recomendável que você configure seu computador remoto para autenticação baseada em chave.
  2. Instale o SDK do Azure Sphere para Windows ou Linux.

Código na máquina remota e dispositivo na máquina local

  1. Conecte o dispositivo via USB à máquina local.
  2. Se ainda não houver um projeto no computador remoto, você poderá clonar o repositório de exemplos ou obter um único projeto do Navegador de Exemplos da Microsoft.
  3. Abra o Visual Studio Code localmente.
  4. Somente na primeira vez: abrir o Visual Studio Code na Paleta de Comandos>de Exibição>SSH remoto: adicione um novo host SSH e insira as informações do host SSH conforme solicitado. (Por padrão, um arquivo chamado config é gravado no diretório .ssh em seu diretório inicial. Às vezes, isso causa problemas de permissões se o computador local for o Windows. Você pode querer mover o arquivo para outro diretório e especificar o caminho absoluto em Preferências>de Arquivo>Configurações>Extensões>Remotas - SSH: Arquivo de Configuração.)

Conecte-se à máquina remota

  1. Conecte-se ao computador remoto executando o comando do Visual Studio Code View>Command Palette>Remote-SSH: Conecte-se ao host ().Shift+Ctrl+P

  2. Instale as extensões do Azure Sphere no computador remoto pesquisando o Azure Sphere no painel de extensão do Visual Studio Code e clicando no botão Instalar no SSH: [nome remoto]. Talvez seja necessário reiniciar o Visual Studio Code e reconectar-se ao computador remoto após a instalação.

    Dica

    Para verificar se a extensão está instalada corretamente na máquina remota, desmarque a caixa de pesquisa no painel de extensão e certifique-se de que Azure Sphere as extensões apareçam na exibição SSH: [nome remoto] - INSTALADO .

  3. Abra a pasta ou área de trabalho do projeto usando a área de trabalho Abrir>pasta ou Abrir arquivo.>

Compilar, implantar no dispositivo local e depurar

  1. Pressione F5 para compilar e depurar o projeto. Se o projeto não tiver sido criado anteriormente ou se os arquivos tiverem sido alterados e a recompilação for necessária, o Visual Studio Code compilará o projeto antes do início da depuração.

  2. Aguarde alguns segundos para que o Visual Studio Code compile o aplicativo, crie um pacote de imagens, implante-o na placa e inicie-o no modo de depuração. Você verá atualizações de status no painel Saída ao longo do caminho.

    Primeiro, o CMake determina se o aplicativo precisa ser criado. Nesse caso, o foco muda para a janela de saída, que exibe a saída do CMake/Build.

    Em seguida, o painel Saída mostra o resultado à medida que o pacote de imagens é implantado no dispositivo. Por fim, o Console de Depuração recebe o foco e mostra a saída do depurador.

Use o depurador do Visual Studio Code para definir pontos de interrupção, pausar, passar, entrar, reiniciar ou parar o aplicativo.

Código e dispositivo na máquina remota

  1. Conecte o dispositivo via USB à máquina remota.
  2. Se ainda não houver um projeto no computador remoto, você poderá clonar o repositório de exemplos ou obter um único projeto do Navegador de Exemplos da Microsoft.
  3. Abra o Visual Studio Code localmente.
  4. Somente na primeira vez: abrir o Visual Studio Code na Paleta de Comandos>de Exibição>SSH remoto: adicione um novo host SSH e insira as informações do host SSH conforme solicitado. (Por padrão, um arquivo chamado config é gravado no diretório .ssh em seu diretório inicial. Às vezes, isso causa problemas de permissões se o computador local for o Windows. Você pode querer mover o arquivo para outro diretório e especificar o caminho absoluto em Preferências>de Arquivo>Configurações>Extensões>Remotas - SSH: Arquivo de Configuração.)

Conecte-se à máquina remota e defina as configurações remotas

  1. Conecte-se à máquina remota executando o comando VS Code Exibir>paleta>de comandos Remote-SSH: Conecte-se ao host ().Shift+Ctrl+P

  2. Adicionar configurações remotas executando o comando VS Code Exibir>Preferências da Paleta>de Comandos: Abra Configurações Remotas e adicione o seguinte campo ao objeto JSON (se for um arquivo vazio, você precisará envolvê-lo):{}

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

    Em vez disso, você pode adicionar essa configuração às configurações de usuário/espaço de trabalho, dependendo da configuração de seus projetos e de sua equipe.

  3. Instale as extensões do Azure Sphere no computador remoto pesquisando o Azure Sphere no painel de extensão do Visual Studio Code e clicando no botão Instalar no SSH: [nome remoto]. Talvez seja necessário reiniciar o Visual Studio Code e reconectar-se ao computador remoto após a instalação.

    Dica

    Para verificar se a extensão está instalada corretamente na máquina remota, desmarque a caixa de pesquisa no painel de extensão e certifique-se de que Azure Sphere as extensões apareçam na exibição SSH: [nome remoto] - INSTALADO .

  4. Abra a pasta ou área de trabalho do projeto usando a área de trabalho Abrir pasta> ou Abrir arquivo>'.

Compilar, implantar em dispositivo remoto e depurar

  1. Pressione F5 para compilar e depurar o projeto. Se o projeto não tiver sido criado anteriormente ou se os arquivos tiverem sido alterados e a recompilação for necessária, o Visual Studio Code compilará o projeto antes do início da depuração.

  2. Aguarde alguns segundos para que o Visual Studio Code compile o aplicativo, crie um pacote de imagens, implante-o na placa e inicie-o no modo de depuração. Você verá atualizações de status no painel Saída ao longo do caminho.

    Primeiro, o CMake determina se o aplicativo precisa ser criado. Nesse caso, o foco muda para a janela de saída, que exibe a saída do CMake/Build.

    Em seguida, o painel Saída mostra o resultado à medida que o pacote de imagens é implantado no dispositivo. Por fim, o Console de Depuração recebe o foco e mostra a saída do depurador.

Use o depurador do Visual Studio Code para definir pontos de interrupção, pausar, passar, entrar, reiniciar ou parar o aplicativo.

Fechar a conexão

Para encerrar uma sessão de depuração remota, selecione Arquivo>Fechar Conexão Remota.