Como começar a usar VSCode

Introdução

Nas próximas semanas, meus colegas de trabalho estão planejando começar a usar VSCode para programar com os produtos InterSystems. Entre as várias vantagens disso, eu gostaria de salientar a possibilidade de se conectar com outras tecnologias, como o GitHub, com facilidade. Além disso, o VSCode também oferece uma extensa loja de extensões, onde você pode achar vários recursos adicionais gratuitos que fazem a programação mais rápida e eficiente. Por último e não menos importante, para conquistar os corações de todo desenvolvedor, é Open Source.

Tendo isso dito, vamos começar o tutorial. Sinta-se à vontade para pular alguns passos se você se sentir confortável de realizá-los sozinho.

 

Passo 1 - Baixar e instalar o VSCode

Pesquise por "VSCode download" ou clique nesse link para baixar pela página oficial. Selecione a instalação correta para a sua máquina e execute o arquivo baixado.

 

Uma vez que o executável rode, você será requisitado para aceitar os termos de licença, selecionar algumas preferências (que são muito pessoais, portanto não vou me estender falando sobre elas) e instalar.

 

Passo 2 - Instalar as extensões InterSystems

Abra seu VSCode na aba de extensões e procure por ObjectScript Extension Pack no marketplace.



Instale o Pack completo.

 

Passo  3 - Configure o VSCode para as suas instâncias

Uma vez que você tem as extensões instaladas, você deve ter uma aba InterSystems. Selecione ela e clique em "+" na seção Servers, como mostrado abaixo, e você será requisitado para passar algumas informações sobre a conexão, como host, porta, usuário e senha.

Outra opção é abrir o arquivo geral de settings.json do seu VSCode, que você pode encontrar facilmente clicando na engrenagem de "gerenciar"    no canto inferior esquerdo da tela, selecionando configurações e clicando em "Abrir configurações (JSON)"     no canto superior direito.

Ali, você pode colar o fragmento JSON abaixo, editando para que aponte para sua instância.

"intersystems.servers": {
        "[YOUR SERVER NAME]": {
            "webServer": {
                "scheme": "http",
                "host": "127.0.0.1",
                "port": 53472
            },
            "username": "_system"
        }

 

Passo 4.1 - Conectar para um servidor e namespace para desenvolver localmente

Outra vez na aba da InterSystems, selecione a seção Explorer e clique no botão "Choose server and namespace".

Você será requisitado para selecionar dentre os servidores adicionados no passo anterior, seu usuário e senha e um namespace.

A seguir, ainda na mesma aba você pode usar as seções Explorer ou Projects para escolher classes e/ou projetos que você deseja exportar. Nesse tipo de desenvolvimento, você pode abrir os arquivos exportados num workspace VSCode e conectar com o GitHub, por exemplo.]

 

Passo 4.2 - Conectar a um servidor e namespace apra desenvolver direto no servidor (minha preferência)

Abra a aba InterSystems na seção Servers e escikha um servidor.

Você pode escolher um projeto e clicar no lápis para abri-lo no seu workspace no modo de edição, ou clicar no olho para abrir no modo de leitura.

Similarmente, você pode escolher entre essas mesmas opções diretamente no namespace para abrir todos os seus arquivos no workspace (minha preferência)

De ambos os modos, você pode receber mais uma requisição para fornecer seu usuário e senha.

 

Passo 5 - Programando

Na aba Explorer, depois do último passo, você deve encontrar na seção workspace algo parecido com a imagem abaixo.

Você pode criar um arquivo e novas pastas clicando com o botão direito do seu mouse em algum diretório, selecionando "Novo Arquivo" e nomeando com o padrão NOMEDAPASTA.NOMEDOARQUIVO.cls. Em outras palavras, você deve nomear as pastas separando seus nomes com pontos. O nome logo antes do último ponto será considerado o real nome do arquivo, e o nome após o último ponto será a extensão para arquivos COS, cls.

Por exemplo, você pode nomear seu arquivo como a imagem abaixo, "folderone.foldertwo.filename.cls", dentro da pasta User, e clicar enter.

Ao fazer isso, você deve ter o diretório e arquivo criados automaticamente como nas imagens a seguir.

Agora, você está pronto para programar como faria no Studio. 

 

Mais algumas dicas

- Você pode usar o atalho Ctrl+Shift+V para abrir arquivos de extensão .int relacionados ao arquivo aberto atual.

- Cuidado: em discordância com o Studio, Ctrl+S no VSCode irá compilar o arquivo além de salvá-lo.

- Agora vou te mostrar o melhor recurso que eu já conheci programando com VSCode. Isso vale ouro! Imagine que você tem uma instância de desenolvimento para as primeiras fases de um projeto, outra instância para testes realizados com o cliente e talvez até mais uma para produção. Isso pode ser ultrajante para migrar arquivos e/ou pequenas mudanças pelo Studio. Contudo, se você está usando VSCode é muito simples.

Na aba Explorer, abra os arquivos de fonte e destino. Por exemplo, se eu tenho um arquivo definindo algum dado persistente, no qual eu adicionei alguns campos no servidor de desenvolvimento e gostaria de migrar as mudanças para a produção, vou abrir o arquivo no sistema de desenvolvimento e o correspondente em produção. (Há uma discussão sobre abrir vários servidores ou namespaces no próximo tópico).

Uma vez que estejam ambos abertos, irão aparecer na seção "Editores Abertos".

Selecione o arquivo fonte com o botão direito do mouse e clique "selecionar para comparar". Clique com o botão direito no arquivo de destino e escolha "comparar com o selecionado". 
BOOM! Você terá esse lindo arquivo de comparação aberto, como mostrado abaixo. 

A barra do lado direito da tela mostra as diferenças entre os arquivos, e você pode usá-la para navegar entre elas em sincronia. Vermelho e verde significa que há algo diferente entre os arquivos. Vermelho significa que há algum texto no arquivo fonte que não está no destino. Verde significa o oposto.

Clique nas setas no meio para trazer as mudanças da fonte para o destino.

Além disso, você pode clicar no botão de setas bidirecionais  no topo direito da tela para mudar os lados dos arquivos: a fonte será o destino e vice-versa. 

Pressionar Ctrl+S com esse editor aberto irá salvar e compilar ambos os arquivos.

- Você pode abrir múltiplas instâncias e namespaces de uma vez só no seu workspace, desde que seu computador consiga aguentar. No entanto, apenas para que você possa ter uma ideia, nas últimas semanas eu tenho trabalhado com dois namespaces pesados de instâncias diferentes abertos, com o Studio, Microsoft Teams (que é escandalosamente pesado), e mais dois aplicativos para conectar com bases de dados e APIs, tudo de uma vez, com um computador com configuração 8GB RAM e CPU 2.10 GHz. A única coisa que algumas vezes ficou lenta foi o Studio.

 

Mais discussão

Eu adoraria falar sobre debugging com VSCode. Ainda não tive o prazer de conhecer alguém que realmente goste disso mais do que das ferramentas de debug do Studio. Eu, por exemplo, confesso que não estou muito familiarizada com as ferramentas de debug do VSCode aplicadas aos produtos InterSystems., então mesmo que o Studio seja muito mais pesado (e por isso mais lento), eu ainda prefiro deixá-lo aberto quando debugo.

Como você combina essas tecnologias? Quais ferramentas você prefere de cada idle?