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.
elementos : 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 recupera scripts será gerado e no qual os recursos e projetos de plug-in serão verificados;
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 marcação fornecida no arquivo de diretório pelo valor fornecido;
configInfo: opcional, uma lista de configuração separada por um e comercial que indica a configuração destinada. O padrão é definir para ser uma plataforma independente;
recursiveGeneration: opcional, especifica se os scripts buscados devem ser gerados para recursos aninhados ou não. O padrão é configurado como true.
elements : a entrada para ser recuperada a partir do repositório. 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, especifica se a geração de script para recursos contidos deve ser chamada. O padrão é definido como true;
devEntries: opcional, uma lista de diretórios separados por vírgula a ser fornecida para o caminho de classe de compilação;
buildingOSGi: opcional, indica se o destino é 3.x. ou 2.1;
baseLocation: opcional, indica uma pasta que contém recursos e pastas instalados;
configInfo : opcional, uma lista de configuração separada por um e comercial indica a configuração de destino. O padrão é definir para ser uma plataforma independente;
pluginPath : opcional, uma lista de URLs separados por vírgulas apontando para os plug-ins instalados. Se especificado, esta lista deve incluir a lista inteira de plug-ins a serem compilados;
archivesFormat: opcional, uma lista de configurações separadas por um e comercial e o formato de saída esperado para cada uma daquelas. 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 para o local separado por '/' de um produto RCP, 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 é false. 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 é false. Observe que o site.xml não é gerado nem atualizado.
forceContextQualifier: opcional, utiliza o valor fornecido para substituir o .qualifier existente por plug-ins e recursos.
<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.