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[,version] conforme o especificado no formato do ficheiro 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 esteja no formato type@id[,version] conforme o especificado no formato do ficheiro de directório; |
| buildDirectory : |
o directório onde se localizam as funções e plug-ins a construir. Os plug-ins e as funções devem localizar-se respectivamente nas pastas plugins e features; |
| 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 features/ e plugins/; |
| 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. O valor predefinido é 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 fazer referência ao id do plug-in de um plug-in que contém 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. O valor predefinido é false (falso); |
| generateJnlp : |
opcional, indica se um ficheiro jnlp deverá ser gerado para todas as funções que estão a ser construídos; |
| outputUpdateJars : |
opcional, gera plug-ins e funções no formato do s¡tio de actualização, quando definido. A predefinição é false. Tenha em atenção que site.xml não é gerado nem actualizado; |
| groupConfiguration
: |
opcional, especifica se agrupa ou não
todas as configurações que estão a ser construídas num único arquivo; |
| generateVersionsLists : |
opcional, especifica se gera ou não
ficheiros de propriedades que listem as versões das funções e dos plug-ins
que foram construídos; |
| filteredDependencyCheck : |
opcional, restringir o conjunto de plug-ins e funções a considerar durante a construção aos que são alcançáveis a partir das funções; |
| filterP2Base : |
opcional, restringir o conjunto de plug-ins e funções a considerar da localização de base (baseLocation) aos que são considerados como a ser instalados por p2; |
| generateFeatureVersionSuffix: | opcional, indica se deve ou não gerar o sufixo de versão da função. Consulte também Qualificadores de Versão; |
| generatedVersionLength : |
opcional, o comprimento do sufixo gerado da versão da função. Por predefinição, o comprimento está definido como 28. Consulte também Qualificadores de Versão; |
| significantVersionDigits : |
opcional, o número de dígitos significativos utilizando ao gerar sufixos de versão da função.
Consulte também Qualificador de Versão; |
| forceContextQualifier : |
opcional, utiliza o valor indicado
para substituir o .qualifier por plug-ins e funções. Consulte também Qualificadores de Versão; |
| featureId : |
O id para atribuir à Função gerada. |
| buildDirectory: |
o directório onde se localizam as funções
e os plug-ins (nos subdirectórios /features e /plugins)
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. (Suporta atributos, ver em baixo) |
| featureList : |
opcional, uma lista de id de
funções separados por vírgulas para incluir na função gerada. (Suporta atributos, ver em baixo) |
| fragmentList : |
opcional, uma lista de id de
fragmentos separados por vírgulas para incluir na função gerada. (Suporta atributos, ver em baixo) |
| buildPropertiesFile : |
opcional, a localização de um ficheiro de propriedades cujo conteúdo deverá ser utilizado como ficheiro build.properties da função gerada. |
| includeLaunchers : |
opcional, se inclui ou não os iniciadores equinox, o valor predefinido é "verdadeiro". |
Os argumentos pluginList, featureList e fragmentList da tarefa eclipse.generateFeature suportam atributos. Estes argumentos assumem a forma:
List = <element-id>[;<attribute>=<value>]* [,<element-id>[;<attribute>=<value>]*]*
Cada para atributo=valor será herdado para o xml gerado correspondente ao elemento fornecido. Exemplo:
featureList = org.eclipse.feature;optional=true
pluginList = org.eclipse.plugin.A;unpack=true
fragmentList=org.eclipse.fragment.a;os=win32,org.eclipse.fragment.b;os=linux;ws=gtk;arch=x86
<feature ...>
...
<includes id="org.eclipse.feature" version="0.0.0" optional="true" />
...
<plugin id="org.eclipse.plugin.A" version="0.0.0" unpack="true" />
<plugin id="org.eclipse.fragment.a" version="0.0.0" os="win32" fragment="true" />
<plugin id="org.eclipse.fragment.b" version="0.0.0" os="linux" ws="gtk" arch="x86" fragment="true" />
...
</feature>
<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 -jar plugins/org.eclipse.equinox.launcher_<version>.jar -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.