Сценарии 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 при этом не генерируется и не обновляется; |
| groupConfiguration
: |
необязательный, включает группировку всех компонуемых конфигураций в один архив; |
| generateVersionsLists : |
необязательный, задает необходимость создания файлов свойств со списком версий компонуемых модулей и комплектов; |
| filteredDependencyCheck : |
Необязательный. Ограничение набора модулей и комплектов, которые будут задействованы во время компоновки, только теми, которые доступны из комплектов; |
| filterP2Base : |
Необязательный. Ограничение набора модулей и комплектов, которые будут задействованы из baseLocation, только теми, которые будут установлены с помощью p2; |
| generateFeatureVersionSuffix: | необязательный, включает генерацию суффикса версии комплекта. См. также Спецификаторы версий; |
| generatedVersionLength : |
Необязательный. Длина сгенерированного суффикса версии комплекта. Значение по умолчанию равно 28. См. также Спецификаторы версий; |
| significantVersionDigits : |
Необязательный. Количество значащих цифр при генерации суффиксов версий комплектов.
См. также Спецификаторы версий; |
| forceContextQualifier : |
(необязательный), заменяет данным значением классификатор .qualifier. См. также Спецификаторы версий; |
| featureId : |
ИД для создаваемого комплекта. |
| buildDirectory: |
каталог, в котором хранятся включаемые комплекты и модули (в подкаталогах /features и /plugins соответственно). Создаваемый комплект будет помещен в каталог
/features. |
| baseLocation : |
(необязательный), папка с установленными комплектами и модулями |
| productFile : |
необязательный, файл продукта, на основе которого создается комплект. |
| verify : |
Указывает, будет ли проверяться доступность модулей и комплектов. Также определяет, будет ли комплект способен правильно работать с платформо-зависимыми фрагментами и модулями, упакованными как JAR. Если все включаемые в комплект элементы доступны локально, задайте verify равным True. Если элементы загружаются из хранилища, задайте verify равным False, используйте получившийся комплект для извлечения требуемых модулей и фрагментов, а затем повторно создайте комплект контейнера с verify = True. |
| pluginPath : |
необязательный, список расположений (через символ разделителя платформы) для поиска дополнительных модулей |
| configInfo : |
(необязательный), список конфигураций (через амперсанд), указывающий целевую конфигурацию. По умолчанию задана платформо-независимая конфигурация; |
| pluginList : |
необязательный, список ИД модулей для включения в комплект (через запятую). (Поддерживает атрибуты, см. ниже.) |
| featureList : |
необязательный, список ИД комплектов для включения в комплект (через запятую). (Поддерживает атрибуты, см. ниже.) |
| fragmentList : |
необязательный, список ИД фрагментов для включения в комплект (через запятую). (Поддерживает атрибуты, см. ниже.) |
| buildPropertiesFile : |
необязательный, расположение файла свойств, содержимое которого должно использоваться в качестве свойств компоновки сгенерированного комплекта |
| includeLaunchers : |
необязательный, определяет включение программ запуска equinox, значение по умолчанию - "true". |
Все аргументы pluginList, featureList и fragmentList задачи eclipse.generateFeature поддерживают атрибуты. Все эти аргументы принимают форму:
List = <ид-элемента>[;<атрибут>=<значение>]* [,<ид-элемента>[;<атрибут>=<значение>]*]*
Каждая пара атрибут=значение будет вставлена в сгенерированный xml, соответствующий данному элементу. Пример:
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"/>
Ранее описанные задачи применимы только во время работы Eclipse. Если выполнять сценарии Ant с помощью задач Eclipse, то сценарии необходимо выполнять с помощью приложения Eclipse Ant Runner. В этом случае командная строка для запуска имеет следующий вид:
java -jar plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile build.xml
Обратите внимание, что параметры, указанные после приложения, передаются в Ant.