Сценарии 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.