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.