Se você ainda não tem o editor VSCode instalado, acesse https://code.visualstudio.com/, faça o download para a plataforma desejada e instale conforme passo-a-passo do site oficial.

A partir do editor VSCode, acompanhando a ilustração de itens na imagem abaixo, acesse na barra de ferramentas disponível na lateral esquerda na posição vertical, o atalho de extensões do VSCode, destacado no item (1) abaixo, informe "TDS" na caixa superior de filtro, item (2), selecione a extensão TOTVS Developer Studio for VSCode (AdvPL, TLPP e 4GL) conforme mostra o item(3) e cliquei em INSTALL item (4).

Image Modified

No Logix o formato de codificação padrão dos códigos fonte é ISO8859-1 ou CP1252 e para que isso seja reconhecido automaticamente no VSCode é preciso configurar a lista de extensões dos arquivos fontes previstos para cada linguagem, sendo que no Logix fazemos uso atualmente de 3 linguagens de desenvolvimento, sendo: 4GL, ADVPL e TLPP, sendo esta última prevista a partir do build Harpia.

Siga o passo a passo abaixo e veja como é simples configurar as extensões de arquivos por linguagem no VSCode e depois indicar o formato de codificação padrão de cada extensão.

No VSCode acesse no menu  File | Preferences | Settings (Arquivo >> Preferências >> Configurações)  e, conforme mostra a imagem abaixo, acesse a aba User item (1), opção Extensions item (2) e a direita acesse o link descrito comoEdit in settings.jsonitem (3) para abrir o arquivo de configurações do usuário do VSCode.

Image Modified

Com o arquivo settings.json aberto para edição inclua as configurações abaixo, verificando sempre se as respectivas chaves já estão informadas, para que não sejam registradas de forma duplicada.

    "files.encoding": "utf8",
    "files.associations": {
        "*.ini": "advpl",
        "*.pro": "4gl",
        "*.4gl": "4gl",
        "*.cnv": "4gl",
        "*.xml": "4gl",
        "*.per": "4gl",
        "*.msg": "4gl",
        "*.prw": "advpl",
        "*.apw": "advpl",
        "*.prg": "advpl",
        "*.prx": "advpl",
        "*.tlpp": "advpl",
        "*.ppp": "advpl",
        "*.ppx": "advpl",
        "*.apl": "advpl",
        "*.aph": "advpl",
        "*.ahu": "advpl",
        "*.tres": "advpl",
        "*.res": "advpl",
        "*.txt": "advpl"
    },
    "[4gl]": {
        "files.encoding": "iso88591"
    },
    "[advpl]": {
        "files.encoding": "windows1252",
    }

Salve o arquivo e a partir de agora seu editor VSCode já irá abrir cada fonte desenvolvido no LOGIX respeitando o formato de codificação (ENCODE) correto para não gerar problemas durante a execução do produto após compilação dos fontes, onde podem ser exibidas os textos em telas e mensagens contendo caracteres estranhos, por terem sido salvos com ENCODE incorreto.

Caso surja mais alguma extensão de arquivo que não esteja na lista acima, pode ser adicionada, desde que respeitando o formato e delimitadores das chaves e valores no arquivo settings.json.

Image Modified

Para criar um espaço de trabalho (Workspace) para desenvolvimento no LOGIX, a exemplo do TDS (Totvs Developer Studio) podíamos indicar uma pasta para armazenar todas as configurações desejadas, onde tínhamos um projeto com a lista de fontes em formato de árvore (TreeView) e também era possível configurar a lista de pastas de includes para o projeto (utilizados para compilação de fontes ADVPL).

Para o VSCode isso não muda, pois também é possível abrir tanto um único arquivo como uma pasta completa e no caso de abertura de uma pasta o VSCode entende que estamos definindo um novo espaço de trabalho (Workspace), onde então ele cria automaticamente uma subpasta chamada .vscode\ onde irá armazenar todos os arquivos das configurações utilizadas.

Toda vez que uma pasta nova é aberta a partir do VSCode e consequentemente uma nova Workspace é criada, por padrão será apresentada uma tela de Boas Vindas conforme imagem abaixo:

A janela de Boas Vindas não aparece?

Para ativar ou desativar a exibição da janela de Boas Vindas é preciso mudar a configuração Totvs Language Server: Welcome Page (File | Preferences | Settings | Extensions | TOTVS | Welcome Page) conforme mostra o vídeo abaixo:

Image Modified

Para ajustar configurações de um atalho existente d do Smartclient é possível acionar a partir da lista de comandos no VsCode o comando TOTVS:Configure Launchers.

Pressione o atalho CTRL+SHIFT+P e informe o filtro do comando como "TOTVS" conforme imagem abaixo e selecione TOTVS:Configure Launchers

É possível também registrar alterações dos atalhos do Smartclient diretamente no arquivo de configuração de forma manual no arquivo /.vscode/launch.json existente na pasta de workspace aberta no VsCode.

Para isso a partir do editor VSCode, acompanhando a ilustração de itens na imagem abaixo, acesse na barra de ferramentas disponível na lateral esquerda na posição vertical, o atalho de excução "Run and Debug", destacado no item (1) abaixo, em seguida selecione o atalho do smartclient desejado item (2)  e em seguida clique sobre o botão de configurações ao lado item (3) para que seja possível abrir para edição o arquivo launch.json correto, já que para cada Workspace criada no TDS-VSCode existirá um arquivo launch.json diferente com a configuração de atalhos de Smartclient.

Para criar uma conexão com um novo AppServer para desenvolvimento no LOGIX, a partir do editor VSCode, acompanhando a ilustração de itens na imagem abaixo, acesse na barra de ferramentas disponível na lateral esquerda na posição vertical, o atalho TOTVS AppServer  , destacado no item (1) abaixo, depois clique no na opção  na caixa superior de filtro, item(2).

Após conexão do AppServer já ter sido criada, deve-se registrar os ambientes de execução ou Environment, que já estão configurados no arquivo INI do AppServer.

Diferentemente de como os ambientes do AppServer eram acessados no TDS, onde ao conectar um AppServer já tínhamos disponíveis todos os ambientes para uso já registrados no AppServer, via TDS for VSCode deve-se registrar os ambientes um a um, baseados nos ambientes já registrados no arquivo INI do AppServer. 

Não sabe o que é um Environment ou Ambiente no AppServer?

Um ambiente ou Environment é uma seção do arquivo INI do AppServer onde configuramos o acesso para execução de programas, indicando caminho do repositório de objetos (RPO), banco de dados a ser conectado, pasta raiz do AppServer (ROOTPATH), pasta inicial de trabalhos (STARTPATH), arquivo de SCHEMA de banco de dados utilizado na compilação de fontes 4GL (arquivos com extensão .sch). Veja um exemplo abaixo de um ambiente de conexão no AppServer utilizado para execução do produto Logix:

[Logix12_ora]
OUTPUTDIR=c:\totvs\logix\lst\
SOURCEPATH=c:\totvs\logix\apo
ROOTPATH=c:\totvs\logix\
STARTPATH=\totvs_data\
RPODB=SQL
RPOLANGUAGE=Portuguese
RPOVERSION=102
RPOPREFIX=lgx
SCROLLCURSORSIZE=100000000
DBALIAS=lgx12_oracle
DBDATABASE=ORACLE
FGLDBPATH=C:\TOTVS\schema\teste

Para compilar fontes ADVPL e 4GL, o processo é bem semelhante a antiga ferramenta de desenvolvimento TDS, no entanto no VSCode é OBRIGATÓRIA a utilização de uma CHAVE DE COMPILAÇÃO.Para saber de TDS, no entanto no VSCode a compilação dos fontes não irá mais atualizar o RPO padrão do produto, mas sim um RPO customizado, que denominamos RPO CUSTOM. Para mais informações a respeito da chave de compilação, acesse o item Solicitando e aplicando Chave de compilaçãodo conceito de RPO CUSTOM acesse Instalação build HARPIA LOGIX.

Seguem algumas opções de compilação de fontes:

OPÇÃO 1 Compilação de fontes de uma pasta da Workspace em uso. Clique com o botão direito do mouse sobre a pasta desejada  item (1) e no menu popup apresentado selecione a opção Compile File/Folder item (2). Image Modified Veja que existem também as opções:  Compile All Workspace para compilar todos os fontes registrados em toda a Workspace em uso  Compile Open Editors para compilar todos os fontes atualmente abertos no editor.

OPÇÃO 2  Compilação avulsa de um fonte em edição. Com o código fonte atualmente em edição e devidamente salvo, pode-se repetir o mesmo processo citado na OPÇÃO 1, no entanto o clique com o botão direito deverá ser realizado sobre o nome do fonte localizado na árvore de arquivos da Workspace e não sobre o nome de uma pasta. Para um código em edição pode-se também pressionar a tecla de atalho CTRL+F9, como mostra a imagem da OPÇÃO 1, Image Modified, Informaçõestip icontitle falseDICA IMPORTANTE Image Added   Este processo de compilação de fontes de uma pasta (OPÇÃO 1OPÇÃO 1) irá ignorar a compilação de fontes que forem detectados como detectados como já compilados no no RPO e  e que não tenham sido detectadas sido detectadas alterações desde sua última compilação no no RPO. Para realizar a ação de de RECOMPILAÇÃO (Recompile) de todos os todos os fontes de uma pasta, Workspace ou  ou dos fontes abertos para ediçãopara edição, conforme as opções do item (2) na imagem a esquerda, deve-se manter a tecla tecla SHIFT pressionada  pressionada e ai então clicar com o botão direito sobre a pasta desejada.

INFORMAÇÕES: Durante o processo de compilação pode-se acompanhar o sucesso ou falha da compilação na seção OUTPUT conforme exemplo da imagem abaixo: Image Added INFORMAÇÕES: Durante o processo de compilação pode-se acompanhar o sucesso ou falha da compilação na seção OUTPUT conforme exemplo da imagem abaixo: Image Removed Veja que em todo processo de compilação é apresentada quantidade de dias para expiração da chave de compilação. Este é um alerta para que você possa providenciar uma nova chave de compilação antes que ela expire.     FIQUE ATENTO a validade da sua chave de compilação, pois sem uma chave válida, você não conseguirá compilar fontes no RPO Logix.     Na ocorrência de erros de compilação será registrada mensagem de alerta na seção OUTPUT e também na seção PROBLEMS, confome pode-se ver no exemplo das imagens abaixo: Image RemovedImage Added Image RemovedImage Added

Para executar um programa já compilado no RPO do ambiente/AppServer conectado é simples. Basta clicar na opção Run and Debug (Ctrl + Shift + D), identificado pela imagem  na barra de ferramentas lateral, conforme mostra imagem do PASSO 1, selecionar o launcher desejado e clicar no botão play.

Para executar um programa em modo DEBUG, basta seguir os seguintes passos:

As etapas a seguir apresentam uma forma de geração e aplicação de PATCH.

As atualizações do VSCode podem ser baixadas manualmente do site GITHUB no link (https://github.com/totvs/tds-vscode/releases/), preferencialmente procurando pela revisão descrita como 

Na página de releases do TDS for VSCode, o arquivo com extensão .vsix é utilizado para ser instalação manual da extensão a partir do VSCode  e é exibido na página de releases conforme exemplo na imagem abaixo:

Image Modified

Baixe o arquivo .VSIX e instale-o a partir do VSCode utilizando o passo a passo a seguir:

1. Acesse a lista de extensões (CTRL+SHIFT+X), ou clique na imagem identificada pelo item(1) na imagem abaixo.
2. A partir do menu das extensões identificado com conforme indicado pelo item(2), escolha a opção  item(3).
3. Escolha o arquivo de extensão .VSIX que foi baixado da página de releases do TDS for VSCode no site GitHub e confirme a instalação.

Image Modified

Para confirmar a versão da extensão instalada, basta clicar sobre a extensão TDS for VSCode que já estará sendo exibida na lista de extensões conforme  imagem abaixo:

Image Modified

e na lateral direita conferir a versão da extensão conforme item(1) abaixo:

Image Modified

PRONTO! Sua extensão TDS for VSCode foi instalada/atualizada com sucesso.