Os scripts Ant são normalmente gerados com o PDE (Plug-in Development Environment - Ambiente de Desenvolvimento de Plug-ins), mas também é possível gerá-los manualmente ou a partir de outros scripts.
É certo que o PDE expõe tarefas Ant para gerar os diversos scripts de construção.
As conveniências para gerar scripts de construção residem nas seguintes
tarefas. Também estão listados os argumentos para cada tarefa.
| elements: |
a entrada que será obtida. O formato esperado é type@id, conforme especificado no formato de ficheiros de directório; |
| buildDirectory: |
o directório para onde serão gerados os scripts de bisca e para onde será dada saída de projectos de funções e de plug-ins; |
| directory: |
o caminho para um ficheiro de directório; |
| children: |
opcional, especifica se a geração de scripts para plug-ins e fragmentos contidos deverá ser invocada. A predefinição é true; |
| cvspassfile: |
opcional, nome de um ficheiro de palavras-passe CVS; |
| fetchTag: |
opcional, substitui o controlo facultado no ficheiro de directório pelo valor indicado; |
| configInfo: |
opcional, uma lista de configuração separada por caracteres de e comerciais que indica a configuração destino. A predefinição é independente de plataformas; |
| recursiveGeneration: |
opcional, especifica se devem ou não ser gerados scripts de busca deverão ou não ser gerados para funções imbricadas. A predefinição é true. |
| elements : |
a entrada a ser construída. Espera-se que a entrada tenha o formato type@id, conforme especificado no formato de ficheiros de directório; |
| buildDirectory : |
o directório onde se encontram as funções e os plug-ins a construir; |
| children : |
opcional, especifica se a geração de scripts para plug-ins e fragmentos contidos deverá ser invocada. A predefinição é true; |
| recursiveGeneration : |
opcional, especifica se a geração de scripts para funções contidas deverá ser invocada. A predefinição é true; |
| devEntries : |
opcional, uma lista de directórios separados por vírgulas a indicar ao caminho de classes de compilação; |
| buildingOSGi : |
opcional, indica se o destino é 3.x. ou 2.1.
A predefinição é true; |
| baseLocation : |
opcional, indica uma pasta que contém uma instalação de destino do eclipse com subdirectórios funções/ e plug-ins/. |
| configInfo : |
opcional, uma lista de configuração separada por caracteres de e comerciais que indica a configuração destino. A predefinição é independente de plataformas; |
| pluginPath : |
opcional, uma lista de localizações separada por um separador de ficheiros de plataforma a partir da qual se pode localizar plug-ins adicionais |
| archivesFormat : |
opcional, uma lista de configuração separada por caracteres de e comerciais e o formato de saída de dados esperado para cada uma delas. O formato é separado por um traço (-) da configuração. Os valores suportados são: folder,tar, zip, antZip, que significam respectivamente não arquivar, utilizar tar para criar o arquivo, utilizar a versão do zip de informações disponível na plataforma, utilizar zip Ant. A predefinição é antZip. |
| product : |
opcional, caminho separado por "/" para a localização de um produto RCP que estiver a ser construído. O primeiro segmento do caminho deve remeter para o ID de plug-in de um plug-in que contenha o ficheiro .product. |
| signJars : |
opcional, indica se os scripts gerados devem assinar JARs para funções e plug-ins. A predefinição é false. Os parâmetros para a tarefa de assinatura são controlados pelas seguintes propriedades de Ant: sign.alias, sign.keystore e sign.storepass respectivamente a ser transmitidas aos parâmetros alias, keystore e storepass a partir da tarefa signJar Ant. A predefinição é false. |
| generateJnlp : |
opcional, indica se deve ser gerado um ficheiro jnlp para todas as funções a construir. |
| outputUpdateJars : |
opcional, gera plug-ins e funções no formato do s¡tio de actualização, quando definido. A predefinição é false. Repare que o ficheiro site.xml não é gerado nem actualizado. |
| forceContextQualifier : |
opcional, utiliza o valor indicado
para substituir o .qualifier por plug-ins e funções. (Consulte também os Qualificadores de Versão |
| generateFeatureVersionSuffix: | opcional, indica se deve ou não gerar o sufixo de versão da função. |
|
groupConfiguration : |
opcional, indica se deve ou não
agrupar todas as configurações a ser construídas num único arquivo. |
| generateVersionsLists : |
opcional, indica se deve ou não
gerar ficheiros de propriedade que enumerem as versões das funções e dos plug-ins construídos. |
| featureId : |
O id para atribuir à Função gerada. |
| buildDirectory: |
o directório em que se encontram as funções e
plug-ins (em subdirectórios /funções e /plug-ins) a incluir. A função
gerada será colocada no subdirectório / funções. |
| baseLocation : |
opcional, indica uma pasta que
contém as funções e os plug-ins instalados |
| productFile : |
opcional, um ficheiro de
produto no qual se deve basear a função gerada. |
| verify : |
Se deve ou não utilizar o
processador para verificar se os plug-ins e as funções facultadas estão disponíveis.
Determina também se a função conseguirá ou não lidar correctamente com
fragmentos específicos da plataforma e os plug-ins que serão compactado em formato JAR. Se
todos os elementos a serem incluídos na função estiverem disponíveis
localmente, então a verificação deverá ser definida como True. Se for
necessário buscar elementos num repositório, definia a verificação como False,
utilize a função resultante para buscar as funções e os plug-ins requeridos e
gere novamente a função de contentor utilizando verificação = True. |
| pluginPath : |
opcional, uma lista de localizações separada por um separador de ficheiros de plataforma a partir da qual se pode localizar plug-ins adicionais |
| configInfo : |
opcional, uma lista de configuração separada por caracteres de e comerciais que indica a configuração destino. A predefinição é independente de plataformas; |
| pluginList : |
opcional, uma lista de id de
plug-ins separados por vírgulas para incluir na função gerada. |
| featureList : |
opcional, uma lista de id de
funções separados por vírgulas para incluir na função gerada. |
| fragmentList : |
opcional, uma lista de id de
fragmentos separados por vírgulas para incluir na função gerada. |
<eclipse.fetch elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
directory="directory.txt"
configInfo="win32,win32,x86 & linux, motif, x86"
/>
<eclipse.buildScript elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
archivesFormat="macosx, carbon, ppc - tar"/>
As tarefas anteriormente descritas só funcionam se o Eclipse estiver em execução. No cenário propriamente dito de execução de scripts Ant com tarefas Eclipse, os scripts devem ser executados através da aplicação Eclipse Ant Runner. A linha de comandos para este caso particular é a seguinte:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
Repare que os parâmetros que aparecem após a aplicação são os parâmetros que são transmitidos ao Ant.