Configuração

Para utilizar a extensão é necessário a configuração de algumas chaves. Essas chaves podem estar tanto na WorkSpace Settings ou na User Settings

advpl.environments : Array com os ambientes configurados

Cada ambiente deve especificar:

• environment: Nome do ambiente que será feito o debug e a compilação
• serverVersion.": Versão do server - Atualmente suporta o 131227A e o 170117A.
• server: Server IP, Padrão: localhost
• port : Porta do servidor
• user: Nome do usuário para se conectar no Protheus, se não informado utiliza "Admin"
• passwordCipher : Senha criptografada do usuário de login no Protheus, para gerá-la utilize o comando CipherPassword
• includeList: Lista de diretórios separado por ponto-e-vírugla. Exemplo: C:\\Protheus\\include\\;C:\\Protheus\\include_2\\
• language: Língua do repositório, se não informado será português, valores permitidos: PORTUGUESE, ENGLISH, SPANISH
• rpoType: Tipo do RPO, se não informado será "TOP", valores permitidos: TOP, CTREE, DBF

• advpl.selectedEnvironment Ambiente atualmente selecionado

• advpl.startProgram: Módulo ou função que será sugerido no launch do Debug

• compileFolderRegex: Regex que ira validar se na compilação de folders, o arquivo irá ser compilado ou não.

Compilação

• advpl.compile_force_recompile : Caso esteja como true, força recompilar os fontes mesmo que não tiveram alteração.

Chave de compilação

Clique aqui para ver como trabalhar com chave de compilação

Configuração de Encode dos arquivos.

O Visual Code padrão utiliza utf8 como encode dos arquivos abertos. O TDS utiliza como padrão o windows1252, caso você utilize fontes nos dois ambientes é recomendando mudar o encode do utf8 para windows1252.

Para proceder isso vá em Files -> Preferences -> WorkSpace Será aberto na direta os valores default, e na esquerda os seus valores.

{ "files.encoding": "windows1252" }

Comandos adicionados ao visual code

Gerar senha de acesso ao um ambiente.

Para gerar uma chave devemos usar o VS Code Quick Open (atalho Ctrl + P) e digitar:

>cipher Será apresentado um inputbox para digitar a senha. Ao confirmar o VsCode ira apresentar a senha criptografada. que deve ser colocada no advpl.passwordCipher.

Pegando o código de liberação autorização TOTVS

Caso você utilize liberação de compilação e necessite de uma para o VS code, abra o VS Code Quick Open (atalho Ctrl + P),e digitar:

>Código Autorização para ser solicitada pela Totvs

Ao começar a digitar o comando o VS code ira já sugerir as correspondências, não sendo necessário digitar o comando inteiro.

Exemplo de arquivo de configuração:

{
 "advpl.environments":[{
 "smartClientPath": "C:\\binarios\\P12\\last_tfs\\smartclient\\",
 "environment": "fluig",
 "includeList": "D:\\LIB120\\INCLUDE\\;D:\\LIB120\\INCLUDE-LIB\\",
 "server": "localhost",
 "port": "1201",
 "user": "Admin",
 "passwordCipher": " TDBXQzYWZoTm92NTlmTFFKbi9DTzROVjY5Q0FUVmFlb1JNN28="

},{

 "smartClientPath": "C:\\binarios\\P12\\last_tfs\\smartclient\\",
 "environment": "amb1",
 "includeList": "D:\\TOTVS\\LIB110\\INCLUDE\\;D:\\TOTVS\\LIB110\\INCLUDE-LIB\\",
 "server": "localhost",
 "port": "1101",
 "user": "Admin",
  "passwordCipher": "elhlY3FxQTJKNTZDR0xiK2VWa1ZrbVRGaDhVWXFrTjYvM2JiUnc="

}],

    //Chave
    "advpl.authorization_generation": "20160831",

    // Data de validade da chave no formato yyyymmdd
    "advpl.authorization_validation": "20161129",

    // 1 - Para permitir substiuir fontes TOTVS, 0 para Não
    "advpl.authorization_permission": "1",

    // Chave de compilação
    "advpl.authorization_code": "013SPL032RFRR74F1E7671310",   
    
}

Selecionando o Ambiente em execução

Após configurar os ambientes, no canto inferior direito, do lado do esquilo é possível visualizar o ambiente corrente. Caso queira muda-lo basta clicar sobre a barra , será apresentando uma lista de ambientes configurados.