Histórico da Página

...

Este arquivo, contém definições e targets, que serão utilizados como apoio no processo de automação de das tarefas. Neste, há exemplo de como compilar e gerar pacotes de atualização. Os demais comandos disponibilizados pelo TDSCli, seguirão a mesma estrutura básica.

Acione o TDS, adicione-o no projeto (pasta raiz) que terá as tarefas automatizadas (pode ser cópia física ou uma ligação) e  abra-o.

Na visão "Outline", efetue um duplo-click no "target TDScompile". Repare que há uma série de marcações ARG <arg> que é responsável em passar os argumentos de execução para o TDSCli.
Ajuste-os conforme o seu ambiente (servidor, porta e outros). Repita o processo para o "target TDSbuildPatch".Compilando e gerando

Preparando o arquivo Ant para compilar e gerar pacote de atualização de um projeto

Baixe o arquivo de exemplo de construção de projeto, adicione-o ao projeto (na pasta raiz) e abra-o. Este arquivo contém os passos necessários para compilar e gerar pacotes de atualização para dois ambientes.

Na visão "Outline", temos diversos elementos, entre eles algumas definições e "targets". O processo de construção, começa pelo "target Main". Efetue um duplo-click sobre ele , para posicionar a ediçãoo editor.

O atributo "depends", indica a ordem de execução dos demais "targets". O primeiro a ser executado é o " target prepare" (vá até ele) e veja que este "target" remove e cria a pasta "output" na pasta raiz do projeto. Esta pasta receberá os pacotes de atualização gerados e os arquivos de ocorrências (logs) dos processos de compilação e geração do pacote. Ao terminar a execução deste target, o executor Ant vai para o próximo "target"da lista.

O "target compileAll", chama o "target compile" para cada um dos ambientes desejados, que foi informado o nome dele, através da marcação param. O "target" chamado, seleciona todos os arquivos da pasta "pasta ${basedir}/src". A marcação "marcação patternset", busca a lista de extensões no arquivo de apoio (repare que na estrutura o elemento "source.advpl" é importado do arquivo de apoio. Uma vez selecionado os arquivos que satisfaçam a seleção (incluindo das sub-pastas), é efetuado um tratamento de conversão de caminho (patch) e em seguida chama o "target TDScompile" (este encontra-se no arquivo de apoio), passando os parâmetros "program" e "environment", que conterão respectivamente, respectivamente os arquivos a compilar serem compilados e em qual ambiente. Este processo será repetido para o outro ambiente.

Após compilar os programas nos dois ambientes, o "target compileAll" é finalizado e retorna ao "target main" e prossegue , passando a execução chamando para o próximo "target", no caso , "buildAll". O processo acima se repete, porém chama chamando o "target buildPatch", informando o ambiente de origem através do parâmetro "environment", e este por sua vez, chama o " target TDSbuildPath" (do arquivo de apoio), passando os parâmetros "program", "environment" e "output", que são respectivamente a lista de programas que serão gravados no pacote de atualização, qual o ambiente de origem e onde serão gravados.será gravado o pacote de atualização.

Reveja o parâmetro environment nos targets compileAll e buildAll, ajustando-o conforme seu ambiente. Se quiser, pode remover ou adicionar novas chamadas (marcação <antcall>) para outros ambientes.

Executando o arquivo Ant

Selecione o arquivo buildProject.xmlPara executar o arquivo Ant, selecione o arquivo "buildProject.xml", acione o menu de contexto, opção "Run As", opção "Ant Build" , e acompanhe a execução pela visão "Console" através das mensagens emitidas pelo executor Ant e aguarde o término do processamento. Selecione Console. Após o término, selecione o projeto e acione F5 (refresh).

Abra a pasta "output" e verá os arquivos de ocorrências (logs) e os pacotes de atualização gerados.

...