Partilhar via

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

  • Artigo

Importante

Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) 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 Secure Shell (SSH). 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. Baixe e instale o Visual Studio Code.

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

  3. Instale a extensão Azure Sphere procurando Azure Sphere no painel de extensão Código do Visual Studio e clicando em Instalar.

    Gorjeta

    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 espaço de trabalho.

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

Configurar a máquina remota

  1. É altamente recomendável que você configure sua máquina remota 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 na máquina remota, você poderá clonar o repositório de amostras ou obter um único projeto do Microsoft Samples Browser.
  3. Abra o Visual Studio Code localmente.
  4. Somente pela primeira vez: Abra o código do Visual Studio a partir da paleta>de comandos View>Remote-SSH: 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 no diretório base. Isso às vezes causa problemas de permissões se sua máquina local for Windows. Você pode mover o arquivo para outro diretório e especificar o caminho absoluto em File>Preferences>Settings>Extensions>Remote - SSH: Config File.)

Conecte-se à máquina remota

  1. Conecte-se à máquina remota executando o comando >Visual Studio Code View Command Palette>Remote-SSH: Connect to host ().Shift+Ctrl+P

  2. Instale as extensões do Azure Sphere na máquina remota procurando pelo Azure Sphere no painel de extensão do Visual Studio Code e clicando no botão Instalar em SSH: [nome remoto]. Talvez seja necessário reiniciar o Visual Studio Code e se reconectar à máquina remota após a instalação.

    Gorjeta

    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 aparecem na visualização SSH: [nome remoto] - INSTALADO .

  3. Abra a pasta ou o espaço de trabalho do projeto usando a Pasta Aberta de Arquivo>ou a área de trabalho Abrir Arquivo.>

Compilar, implantar no dispositivo local e depurar

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

  2. Aguarde alguns segundos para que o Visual Studio Code crie o aplicativo, crie um pacote de imagem, implante-o no quadro 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. Em caso afirmativo, 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 imagem é implantado no dispositivo. Finalmente, o Debug Console recebe o foco e mostra a saída do depurador.

Use o depurador de código do Visual Studio para definir pontos de interrupção, pausar, ultrapassar, 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 na máquina remota, você poderá clonar o repositório de amostras ou obter um único projeto do Microsoft Samples Browser.
  3. Abra o Visual Studio Code localmente.
  4. Somente pela primeira vez: Abra o código do Visual Studio a partir da paleta>de comandos View>Remote-SSH: 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 no diretório base. Isso às vezes causa problemas de permissões se sua máquina local for Windows. Você pode mover o arquivo para outro diretório e especificar o caminho absoluto em File>Preferences>Settings>Extensions>Remote - SSH: Config File.)

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

  1. Conecte-se à máquina remota executando o comando VS Code View>Command Palette>Remote-SSH: Connect to host ().Shift+Ctrl+P

  2. Adicione configurações remotas executando o comando VS Code View>Command Palette>Preferences: Abra Configurações remotas e adicione o seguinte campo ao objeto JSON (se for um arquivo vazio, você precisa encapsular isso em ):{}

        "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 na máquina remota procurando pelo Azure Sphere no painel de extensão do Visual Studio Code e clicando no botão Instalar em SSH: [nome remoto]. Talvez seja necessário reiniciar o Visual Studio Code e se reconectar à máquina remota após a instalação.

    Gorjeta

    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 aparecem na visualização SSH: [nome remoto] - INSTALADO .

  4. Abra a pasta ou o espaço de trabalho do projeto usando a pasta Abrir arquivo>ou o espaço de trabalho Abrir arquivo>'.

Crie, implante no dispositivo remoto e depure

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

  2. Aguarde alguns segundos para que o Visual Studio Code crie o aplicativo, crie um pacote de imagem, implante-o no quadro 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. Em caso afirmativo, 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 imagem é implantado no dispositivo. Finalmente, o Debug Console recebe o foco e mostra a saída do depurador.

Use o depurador de código do Visual Studio para definir pontos de interrupção, pausar, ultrapassar, entrar, reiniciar ou parar o aplicativo.

Feche a conexão

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