Os scripts Ant são normalmente gerados utilizando o PDE (Plug-in Development Environment), mas também é possível gerá-los
manualmente ou a partir de outros scripts.
Na realidade, o PDE expõe as tarefas Ant para gerar os diversos scripts de construção.
Os recursos de geração de scripts de construção
residem nas tarefas a seguir. Os argumentos também são listados para cada tarefa.
| elements: |
a entrada que será buscada. O formato esperado é type@id[,version], conforme especificado no formato do arquivo de diretório; |
| buildDirectory: |
o diretório no qual os scripts de busca serão gerados e no qual será efetuado o registro de saída dos recursos e projetos de plug-in; |
| directory: |
o caminho para um arquivo de diretório; |
| children: |
opcional, especifica se a geração de script para plug-ins e fragmentos contidos deve ser chamada. O padrão é definido como true; |
| cvspassfile: |
opcional, o nome de um arquivo de senha CVS; |
| fetchTag: |
opcional, substitui a tag fornecida no arquivo de diretório pelo valor especificado; |
| configInfo: |
opcional, uma lista separada por e comercial (símbolo &) de configurações, indicando a configuração destinada. O padrão é definir para ser uma plataforma independente; |
| recursiveGeneration: |
opcional, especifique se os scripts de busca devem ser gerados, ou não, para recursos aninhados. O padrão é configurado como true. |
| elements : |
a entrada a ser construída. A entrada deve estar no formato type@id[,version], conforme especificado no formato do arquivo de diretório; |
| buildDirectory : |
o diretório em que os recursos e plug-ins a serem construídos estão localizados. Os plug-ins e recursos devem estar localizados, respectivamente, nas pastas plug-ins e recursos; |
| children : |
opcional, especifica se a geração de script para plug-ins e fragmentos contidos deve ser chamada. O padrão é definido como true; |
| recursiveGeneration : |
opcional, especificado se a geração de script para os recursos contidos deve ser chamada. O padrão é definido como true; |
| devEntries : |
opcional, uma lista separada por vírgula de diretórios a serem especificados para o caminho de classe de compilação; |
| buildingOSGi : |
opcional, indica se o
destino é 3.x.
ou 2.1. O padrão é true; |
| baseLocation : |
opcional, indica uma pasta que contém uma instalação do eclipse de destino com os subdiretórios features/ e plugins/; |
| configInfo : |
opcional, uma lista separada por e comercial (símbolo &) de configurações indica a configuração destinada. O padrão é definir para ser uma plataforma independente; |
| pluginPath : |
opcional, uma lista separada por separadores de arquivo de plataforma dos locais a partir dos quais serão localizados plug-ins adicionais; |
| archivesFormat : |
opcional, uma lista separada por e comercial (símbolo &) de configurações e o formato de saída esperado para cada uma delas. O formato é separado por um traço (-) da configuração. Os valores suportados são: pasta, tar, zip, antZip, respectivamente significando não arquivar, utilize tar para criar o archive, utilize a versão de info zip disponível na plataforma, utilize ant zip. O valor padrão é antZip; |
| product : |
opcional, caminho separado por '/' para o local de um produto RCP que está sendo construído. O primeiro segmento do caminho deve se referir ao id do plug-in de um plug-in que contém o arquivo .product; |
| signJars : |
opcional, indica se os scripts gerados devem assinar jars para recursos e plug-ins. O valor padrão é falso. Os parâmetros para a tarefa de assinatura são controlados pelas seguintes propriedades ant: sign.alias, sign.keystore e sign.storepass respectivamente, sendo transmitidos para o alias, armazenamento de chave e parâmetros storepass a partir do ant Tarefa signJar. O valor padrão é false; |
| generateJnlp : |
opcional, indica se um arquivo jnlp deve ser gerado por todos os recursos que estão sendo construídos; |
| outputUpdateJars : |
opcional, gera plug-ins e recursos no formato do site de atualização quando configurado. O valor padrão é falso. Observe que o site.xml não é gerado nem atualizado; |
| groupConfiguration
: |
opcional, indica se deve ou não agrupar todas as
configurações que estão sendo construídas em um único arquivo; |
| generateVersionsLists : |
opcional, indica se deve ou não gerar arquivos de
propriedades, listando as versões de recursos e plug-ins que foram construídos; |
| filteredDependencyCheck : |
opcional, restringe o conjunto de plug-ins e recursos
a serem considerados durante a construção àqueles acessíveis a partir dos recursos; |
| filterP2Base : |
opcional, restringe o conjunto de plug-ins e recursos
a serem considerados a partir de baseLocation àqueles considerados instalados por p2; |
| generateFeatureVersionSuffix: | opcional, indica se o sufixo da versão do recurso deve ou não ser gerado. Consulte também Qualificadores de Versão; |
| generatedVersionLength : |
opcional, o comprimento do sufixo da versão de recurso gerada. Por padrão, ele é definido como 28. Consulte também Qualificadores de Versão; |
| significantVersionDigits : |
opcional, o número de dígitos significativos utilizados ao gerar sufixos de versão de recurso.
Consulte também Qualificadores de Versão; |
| forceContextQualifier : |
opcional, utiliza o valor
especificado para substituir o .qualifier por plug-ins e recursos. Consulte também Qualificadores de Versão; |
| featureId : |
O ID a ser atribuído ao
Recurso gerado. |
| buildDirectory: |
o diretório em que os recursos e
plug-ins (nos subdiretórios /features e /plugins) a serem
incluídos estão localizados. O recurso gerado será colocado no
subdiretório /features. |
| baseLocation : |
opcional, indica uma pasta
que contém recursos e plug-ins instalados |
| productFile : |
opcional, um arquivo do produto
no qual o recurso gerado se baseará. |
| verify : |
Indica se deve utilizar, ou não,
o resolvedor para verificar se os plug-ins e recursos fornecidos
estão disponíveis. Isso também determina se o recurso estará apto,
ou não, a manipular corretamente os fragmentos e plug-ins específicos da
plataforma que estarão em JAR. Se todos os elementos a serem incluídos
no recurso estiverem disponíveis localmente, então verify deverá ser configurado
como True. Se os elementos precisarem ser buscados de um repositório,
configure verify como False, utilize o recurso resultante para buscar os
plug-ins e recursos necessários, em seguida, gere novamente o recurso de contêiner utilizando
verify = True. |
| pluginPath : |
opcional, uma lista separada por separadores de arquivo de plataforma dos locais a partir dos quais serão localizados plug-ins adicionais |
| configInfo : |
opcional, uma lista separada por e comercial (símbolo &) de configurações indica a configuração destinada. O padrão é definir para ser uma plataforma independente; |
| pluginList : |
opcional, uma lista separada por
vírgula de IDs de plug-in a serem incluídos no recurso gerado. (Suporta atributos, consulte abaixo) |
| featureList : |
opcional, uma lista separada
por vírgula de IDs de recurso a serem incluídos no recurso gerado. (Suporta atributos, consulte abaixo) |
| fragmentList : |
opcional, uma lista separada por
vírgula de IDs de fragmento a serem incluídos no recurso gerado. (Suporta atributos, consulte abaixo) |
| buildPropertiesFile : |
opcional, o local de um arquivo de propriedades cujo conteúdo deve ser utilizado como build.properties do recurso gerado. |
| includeLaunchers : |
opcional, indica se deve, ou não, incluir os ativadores equinox, o valor padrão é "true". |
Todos os argumentos pluginList, featureList e fragmentList da tarefa eclipse.generateFeature suportam atributos. Todos esses argumentos assumem o formato:
List = <element-id>[;<attribute>=<value>]* [,<element-id>[;<attribute>=<value>]*]*
Cada par attribute=value será inserido no 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 descritas anteriormente funcionam apenas se o Eclipse estiver em execução. No cenário específico de execução de scripts Ant utilizando tarefas do Eclipse, os scripts devem ser executados utilizando o aplicativo Eclipse Ant Runner. A linha de comandos para esse caso específico é a seguinte:
java -jar plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile build.xml
Observe que os parâmetros que aparecem após o aplicativo são os parâmetros que são transmitidos para o Ant.