Objetivo

A Ferramenta por linha de comando embutida no

Principais características

• Não tem comunicação cliente/server TCP, os comandos são executados diretamente no AppServer.
• Ambiente simples que necessita apenas do appre, binário do appserver e arquivo de configuração "appserver.ini".
• Compilação mais rápida.
• Suporte a atual chave de compilação utilizada pelo TDS e TDSCli.
• Chave de compilação para Linux utilizando criptografia AES 256bits.
• Compatível com Sistemas Operacionais Windows e Linux.

Funcionalidades

• Compilação de fontes e resources
• Geração e aplicação de patches
• Inspetor de Objetos
• Execução de rotinas, sem interface

Geral

Parâmetros

Parâmetros de linha do

Opção Compile

Compilação

Parâmetros

Nome	Descrição	Obrigatório	Observações
-compile	Necessário para inicialização da ferramenta	Sim
-files	Informa quais fontes serão compilados podendo ser informado das seguintes formas: Arquivo Lst  Pastas (Diretórios e sub-diretórios). Obs: O que não é programa será compilado como resource. Arquivo único (fonte ou resource).	Sim
-includes	Informa o diretório de includes usado durante a o pré-processamento dos fontes.	Sim
-env	Informa o ambiente que deverá ser acessado para compilação.	Sim
-nodelfiles	Utilizado para debug, caso informado, não deleta os arquivos gerados durante o pré-processamento e também mantem os arquivos temporários .Lst gerados durante o processo.	Não
-authorization	Informa a chave de compilação no formato de arquivo .aut, padrão TDS / TDSCli ou, o token de compilação no formato de arquivo .token, no padrão JWT.	Não	Estado colour Blue title A partir da versão 20.3.2.0, não será mais utilizada a autorização da chave de compilação.
-outreport	Gera os arquivos compile_sucess.log, que contem a lista de fontes compilados com sucesso no formato do arquivo .lst, e compile_errors.log, que contem a lista de fontes não compilados e os erros de compilação. A partir da versão 17.3.0.19, também é possível definir o diretório de saída para esses arquivos.	Não	Estado colour Green title Disponível a partir da versão 17.3.0.15

Arquivo .Lst

Arquivo .Lst

Tipo de arquivo com extensão .lst que pode conter uma lista de fontes e resources no formato de path absoluto, ou diretórios para compilação. Quando houverem diretórios, um novo arquivo .lst temporário com prefixo _generated será gerado para Tipo de arquivo com extensão .lst que pode conter uma lista de fontes e resources no formato de path absoluto, ou diretórios para compilação. Quando houverem diretórios, um novo arquivo .lst temporário com prefixo _generated será gerado para a extração dos arquivos contidos no diretório informado, compondo assim uma nova lista de arquivos a serem compilados. Por meio do parâmetro nodelfiles, é possível manter também esses arquivos temporários para análise.

O conteúdo do arquivo deverá respeitar as seguintes regras:

• Usar separador ' ; '
• Todos caminhos de arquivos ou diretórios devem ser inseridos em uma única linha com separador no final.

Veja o exemplo de arquivo anexado: exemplo.lst

Chave de compilação

Compatível com a chave de compilação gerada e utilizada no TDS e TDSCli. Para a utilização da ferramenta Compile, é preciso exportar as informações de uma nova ou já existente chave criando um arquivo com extensão .aut. No Linux, é utilizado o mesmo padrão de criação de chave realizando o controle pelo UUID do disco porem, a chave é criada e criptografada utilizando algoritmo AES 256bits.

[AUTHORIZATION]
ID=FA15-EB7C
GENERATION=12/02/2019
VALIDATION=13/05/2019
PERMISSION=1
KEY=042MQC032QYIQ74A1E7671302

[AUTHORIZATION]
ID=d40f3aa2-d5ae-4a0b-a0f5-a44e29bcd344
GENERATION=20/02/2019
VALIDATION=21/05/2019
PERMISSION=1
KEY=gjvqs3U7vInn/VcX9Hl0Av2is+mLrr4j/BxHMdyR7uPaOcQC7OVtTIWhIMU0/5AkfipUxQukozs121WVNafNyQ==

./appsrvlinux -compile -uuid

Geração de Patch

Recurso para geração de path. Por default, os patchs serão gerados na pasta "cmdgenpatch" dentro do Environment.

Parâmetros

appserver.exe -compile -validatepatch -files=D:\totvs\patch\tttp120.ptm -env=advplc -outreport

appserver.exe -compile -applypatch -files=D:\totvs\patch\tttp120.ptm -env=advplc -applyoldprogram

Revalidação do RPO

Recurso para verificar a integridade o RPO e definir o status do RPO como produtivo (production). Este recurso é de uso exclusivo da TOTVS pois é necessário um token de compilação com status produtivo.

Parâmetros