Добавление файлов в корневой каталог компоновки

Корневые файлы - это файлы, которые должны быть включены в пакет установки Eclipse, но не являются компонентами или модулями. Примерами могут служить исполняемые файлы Eclipse и файлы ini, а также файлы лицензий.
Корневые файлы передаются в компоновку компонентами, в которых содержатся соответствующие корневые свойства.

Свойства корневого файла

root
Список файлов или папок через запятую, подлежащих включению во все конфигурации, компоновка которых выполняется.
Относительные пути указываются относительно вмещающего компонента. Для указания файла используется "file:", для указания полного пути используется "absolute:".
Примеры:
  • root=rootfiles: Относительный путь к папке, включая содержимое папки
  • root=file:license.html,licenses: Относительный путь к файлу "license.html" и относительный путь к папке "licenses"
  • root=absolute:/eclipse/rootfiles: Полный путь к папке, включая содержимое папки
  • root=absolute:file:/eclipse/about.html,file:lib/*.so*: Полный путь для включения "about.html", а также относительный путь для включения всех файлов *.so* в папке lib.

Каждая запись, отделенная запятой, представляет собой набор файлов ant. Если запись относится к папке, эта папка является параметром "dir" для данного набора файлов, а "**" служит параметром "includes" - включение. Если запись относится к файлу, то значением параметра "dir" является каталог, в котором расположен этот файл, и файл указан в параметре "includes".

Для всех относительных файлов свойство ${baseDir} используется в каталоге. Это свойство ${baseDir} является корневым каталогом компонента, и в нем будет расположен сгенерированный файл build.xml.

root.<config>
Следует указать список файлов или папок, подлежащих включению в данную конфигурацию. Конфигурации, указанные здесь, должны соответствовать конфигурациям, заданным в свойстве configs для компоновки. Относительные пути указываются относительно вмещающего компонента. Те же префиксы "file:" и "absolute:", используемые в свойстве "root", применяются и для этого свойства.
Примеры:
  • root.win32.win32.x86=rootfiles: Относительный путь к папке, содержимое которой включается в конфигурацию win32.win32.x86.
  • root.linux.gtk.x86=absolute:file:about.html: Полный путь к файлу, включаемому в конфигурацию linux.gtk.x86.
root.folder.<subfolder>

root.<config>.folder.<subfolder>
Это свойство аналогично свойствам "root" и "root.<config>", за исключением того, что вместо копирования в корневой каталог установочного каталога eclipse, файлы и папки копируются в указанную вложенную папку.
Относительные пути указываются относительно вмещающего компонента. Те же префиксы "file:" и "absolute:", используемые в свойстве "root", применяются и для этого свойства.
Примеры:
  • root.folder.docs/html=html_files: Содержимое папки компонента "html_files" копируется в папку docs/html в установочном каталоге eclipse.
  • root.linux.gtk.x86.folder.jre=absolute:/build/jres/linux: Полный путь; содержимое папки /build/jres/linux копируется в папку jre установочного каталога eclipse.
Эти свойства используются PDE/UI, если JRE указан в файле .product для экспорта. PDE/Компоновкой в настоящее время не поддерживается включениеJRE с помощью файла .product, и эти свойства необходимо указывать в компоненте для включения JRE в консольную компоновку продукта.
root.permissions.<rights>

root.<config>.permissions.<rights>
Необходимо указать список файлов, над которыми будет выполняться задача ant chmod. Значение этого свойства передается в задачу ant chmod в виде параметра "includes". Это означает, что допускается использование шаблонов подстановки ant.
Примеры:
  • root.permissions.755=eclipse: Задать исполняемые права доступа для файла 'eclipse'.
  • root.linux.gtk.x86.permissions.755=lib/**: Сделать исполняемыми все файлы в каталоге lib

Часть <rights> (права) этого свойства фактически передается в задачу ant chmod в виде параметра "perm". Если окончательным форматом архива для данной конфигурации является antTar, то формат <rights> также передается в набор файлов ant tarfileset в виде параметра "filemode". Аналогично, для формата antZip - набор файлов zipfileset. Хотя задача ant chmod поддерживает разрешения, подобные "og-rwx" (когда пользователи, не являющиеся владельцами, не могут обращаться к файлам), наборы файлов tar и zip поддерживают только восьмеричные строки из 3 цифр.
root.link

root.<config>.link
Попарный список файлов и папок (через запятую), для которых нужно создать символические ссылки. Первая запись в паре - это целевой объект, а вторая - это имя ссылки.
Пример:
  • root.macosx.carbon.ppc.link=Eclipse.app/Contents/MacOS/eclipse,eclipse: В конфигурации macosx.carbon.ppc создается мягкая ссылка в корневом каталоге "eclipse", указывающая на файл "Eclipse.app/Contents/MacOS/eclipse".

В результате задача 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). Добавить корневые файлы в эту компоновку продукта можно двумя способами: