Корневые файлы - это файлы, которые должны быть включены в пакет установки Eclipse, но не являются компонентами или модулями. Примерами могут служить исполняемые файлы Eclipse и файлы ini, а также файлы лицензий.
Корневые файлы передаются в компоновку компонентами, в которых содержатся соответствующие корневые свойства.
root |
Список файлов или папок через запятую, подлежащих включению во все конфигурации, компоновка которых выполняется. Относительные пути указываются относительно вмещающего компонента. Для указания файла используется "file:", для указания полного пути используется "absolute:". Примеры:
Каждая запись, отделенная запятой, представляет собой набор файлов ant. Если запись относится к папке, эта папка является параметром "dir" для данного набора файлов, а "**" служит параметром "includes" - включение. Если запись относится к файлу, то значением параметра "dir" является каталог, в котором расположен этот файл, и файл указан в параметре "includes". Для всех относительных файлов свойство ${baseDir} используется в каталоге. Это свойство ${baseDir} является корневым каталогом компонента, и в нем будет расположен сгенерированный файл build.xml. |
root.<config> |
Следует указать список файлов или папок, подлежащих включению в данную конфигурацию. Конфигурации, указанные здесь, должны соответствовать конфигурациям, заданным в свойстве configs для компоновки.
Относительные пути указываются относительно вмещающего компонента. Те же префиксы "file:" и "absolute:", используемые в свойстве "root", применяются и для этого свойства. Примеры:
|
root.folder.<subfolder> root.<config>.folder.<subfolder> |
Это свойство аналогично свойствам "root" и "root.<config>", за исключением того, что вместо копирования в корневой каталог установочного каталога eclipse, файлы и папки копируются в указанную вложенную папку.
Относительные пути указываются относительно вмещающего компонента. Те же префиксы "file:" и "absolute:", используемые в свойстве "root", применяются и для этого свойства. Примеры:
|
root.permissions.<rights> root.<config>.permissions.<rights> |
Необходимо указать список файлов, над которыми будет выполняться задача ant chmod. Значение этого свойства передается в задачу ant chmod в виде параметра "includes". Это означает, что допускается использование шаблонов подстановки ant. Примеры:
Часть <rights> (права) этого свойства фактически передается в задачу ant chmod в виде параметра "perm". Если окончательным форматом архива для данной конфигурации является antTar, то формат <rights> также передается в набор файлов ant tarfileset в виде параметра "filemode". Аналогично, для формата antZip - набор файлов zipfileset. Хотя задача ant chmod поддерживает разрешения, подобные "og-rwx" (когда пользователи, не являющиеся владельцами, не могут обращаться к файлам), наборы файлов tar и zip поддерживают только восьмеричные строки из 3 цифр. |
root.link root.<config>.link |
Попарный список файлов и папок (через запятую), для которых нужно создать символические ссылки. Первая запись в паре - это целевой объект, а вторая - это имя ссылки. Пример:
В результате задача ant exec выполняет команду "ln -sf". При указанном значении "targetA, nameA, targetB, nameB, targetC, nameC", будет выполнен набор команд "ln" в папке, где собраны корневые файлы eclipse: ln -sf targetA nameA ln -sf targetB nameB ln -sf targetC nameC |
При использовании файла .product на основе компонентов, корневые файлы можно добавлять к продукту, просто указав перечисленные выше свойствакорневых файлов в любом из включенных компонентов.
Можно включать компонент исключительно с целью передачи корневых файлов. Если в таком компоненте "корневых файлов" не задано свойство"bin.includes" в файле build.properties, то он не будет включен в окончательный результат компоновке, а переданные корневые файлы - будут.
Если файл .product основан на модулях, а не на компонентах, корневые файлы все же можно добавлять в компоновку. В компоновке продукта PDE/Компоновкой автоматически генерируется компонент контейнера, который включает в себя все модули, указанные в файле .product (см. задачу eclipse.generateFeature). Добавить корневые файлы в эту компоновку продукта можно двумя способами:
${buildDirectory}/features/org.foo.rootfile.feature/rootfiles/*
/build.properties : root = rootfiles
${buildDirectory}/build.properties: featureList = org.foo.rootfile.feature
${buildDirectory}/build.properties: generatedBuildProperties = ${buildDirectory}/root.properties
${buildDirectory/root.properties: root = absolute:${buildDirectory}/rootfiles
${buildDirectory}/rootfiles/*