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 é o do formulário type@id, conforme especificado no formato de arquivos do 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, conforme especificado no formato de arquivos do diretório; |
buildDirectory : |
o diretório no qual os recursos e plug-ins a serem construídos estão localizados; |
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 referir-se 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 para 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 |
forceContextQualifier : |
opcional, utiliza o valor
especificado para
substituir o .qualifier por plug-ins e recursos. (Consulte também Qualificadores de Versão) |
generateFeatureVersionSuffix: | opcional, indica se o sufixo da versão do recurso deve ser gerado, ou não. |
groupConfiguration
: |
opcional, indica se todas as
configurações que estão sendo construídas devem ser agrupadas, ou não, em um único archive. |
generateVersionsLists : |
opcional, indica se deve
gerar, ou não, arquivos de propriedades listando as versões de recursos e plug-ins
que foram construídos. |
featureId : |
O ID a ser atribuído ao
Recurso gerado. |
buildDirectory: |
O diretório no qual 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 requeridos, 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. |
featureList : |
opcional, uma lista separada
por vírgula de IDs de recurso a serem incluídos no recurso gerado. |
fragmentList : |
opcional, uma lista separada por
vírgula de IDs de fragmento a serem incluídos no recurso gerado. |
<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 -cp startup.jar org.eclipse.core.launcher.Main -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.