Сценарии Ant обычно генерируются с помощью PDE, но можно их создавать и вручную или из других сценариев.
Задачи Ant используются PDE для генерации различных сценариев компоновки. Ниже перечислены задачи, содержащие инструменты для генерации сценариев компоновки.
Для каждой задачи приведены также ее аргументы.
| elements: |
получаемые элементы. Записи должны быть указаны в формате тип@ИД, как и в файле каталогизации; |
| buildDirectory: |
каталог, в котором будут генерироваться сценарии для получения и сохраняться полученные проекты комплектов и модулей; |
| directory: |
путь к файлу каталогизации; |
| children: |
необязательный, указывает на то, будет ли вызвана генерация сценария для модулей и фрагментов. Значение по умолчанию - true; |
| cvspassfile: |
необязательный, имя файла паролей CVS; |
| fetchTag: |
необязательный, переопределяет тег, заданный в файле каталогизации; |
| configInfo: |
(необязательный), список конфигураций (через амперсанд), указывающий целевую конфигурацию. По умолчанию задана платформо-независимая конфигурация; |
| recursiveGeneration: |
(необязательный), указывает, генерировать ли сценарии получения для вложенных комплектов. По умолчанию задано значение true. |
| elements : |
компонуемые элементы. Запись должна быть указана в формате тип@ИД, как и в файле каталогизации; |
| buildDirectory : |
каталог для расположения компонуемых комплектов и модулей; |
| children : |
необязательный, указывает на то, будет ли вызвана генерация сценария для модулей и фрагментов. Значение по умолчанию - true; |
| recursiveGeneration : |
(необязательный), указывает на то, будет ли вызвана генерация сценария для комплектов. Значение по умолчанию - true; |
| devEntries : |
(необязательный), список каталогов для пути класса при компиляции (через запятую); |
| buildingOSGi : |
(необязательный), указывает цель - 3.x или 2.1. Значение по умолчанию равно true; |
| baseLocation : |
необязательный, указывает на папку с установкой Eclipse, содержащую подкаталоги features/ и plugins/. |
| configInfo : |
(необязательный), список конфигураций (через амперсанд), указывающий целевую конфигурацию. По умолчанию задана платформо-независимая конфигурация; |
| pluginPath : |
необязательный, список расположений (через символ разделителя платформы) для поиска дополнительных модулей |
| archivesFormat : |
(необязательный), список конфигураций (через амперсанд) с ожидаемым форматом вывода для каждой из них. Формат должен отделяться от конфигурации символом тире (-). Допустимые значения: folder (не архивировать), tar (создать архив tar), zip (создать архив zip с помощью программы, доступной на данной платформе), antZip (создать архив zip с помощью встроенной в ant программы). Значение по умолчанию - antZip. |
| product : |
(необязательный), путь к компонуемому продукту RCP (через "/"). В начале строки должен указываться идентификатор модуля, содержащего файл .product. |
| signJars : |
(необязательный), указывает, должны ли генерируемые сценарии подписывать файлы JAR комплектов и модулей. Значение по умолчанию: false. Параметры подписи задаются свойствами ANT sign.alias, sign.keystore и sign.storepass, значения которых передаются задаче signJar, в параметрах alias, keystore и storepass соответственно. Значение по умолчанию равно false. |
| generateJnlp : |
(необязательный), указывает, должен ли файл jnlp генерироваться для всех компонуемых комплектов. |
| outputUpdateJars : |
(необязательный), включает генерацию модулей и комплектов в формате сайта обновления. Значение по умолчанию: false. Заметьте, что файл site.xml при этом не генерируется и не обновляется. |
| forceContextQualifier : |
(необязательный), заменяет данным значением классификатор .qualifier. (См. также Спецификаторы версий) |
| generateFeatureVersionSuffix: | необязательный, включает генерацию суффикса версии комплекта. |
| groupConfiguration
: |
необязательный, включает группировку всех компонуемых конфигураций в один архив. |
| generateVersionsLists : |
необязательный, задает необходимость создания файлов свойств со списком версий компонуемых модулей и комплектов.
|
| featureId : |
ИД для создаваемого комплекта.
|
| buildDirectory: |
каталог, где в подкаталогах /features и /plugins расположены включаемые модули и комплекты.
Создаваемый комплект будет помещен в каталог
/features. |
| baseLocation : |
(необязательный), папка с установленными комплектами и модулями |
| productFile : |
необязательный, файл продукта, на основе которого создается комплект.
|
| verify : |
Указывает, будет ли проверяться доступность модулей и комплектов.
Также определяет, будет ли комплект способен правильно работать с платформо-зависимыми фрагментами и модулями, упакованными как JAR. Если все включаемые в комплект элементы доступны локально, задайте verify равным True. Если элементы загружаются из хранилища, задайте verify равным False, используйте получившийся комплект для извлечения требуемых модулей и фрагментов, а затем повторно создайте комплект контейнера с verify = True. |
| pluginPath : |
необязательный, список расположений (через символ разделителя платформы) для поиска дополнительных модулей |
| configInfo : |
(необязательный), список конфигураций (через амперсанд), указывающий целевую конфигурацию. По умолчанию задана платформо-независимая конфигурация; |
| pluginList : |
необязательный, список ИД модулей для включения в комплект (через запятую). |
| featureList : |
необязательный, список ИД комплектов для включения в комплект (через запятую). |
| fragmentList : |
необязательный, список ИД фрагментов для включения в комплект (через запятую). |
<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"/>
Ранее описанные задачи применимы только во время работы Eclipse. Если выполнять сценарии Ant с помощью задач Eclipse, то сценарии необходимо выполнять с помощью приложения Eclipse Ant Runner. В этом случае командная строка для запуска имеет следующий вид:
java -cp startup.jar org.eclipse.core.launcher.Main -application org.eclipse.ant.core.antRunner -buildfile build.xml
Обратите внимание, что параметры, указанные после приложения, передаются в Ant.