Начиная с версии 3.4, в состав Eclipse входят комплекты с исходным кодом, обеспечивающие более гибкую разработку исходного кода. Дополнительная информация приведена в разделе "Индивидуальные комплекты с исходным кодом". Обычные модули исходного кода на основе папок по-прежнему можно создавать в соответствии с приведенными ниже инструкциями.
Рассмотрим следующий комплект SDK:
features/
org.foo.sdk/
feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />
build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp
org.foo.rcp/
feature.xml: <plugin id="org.foo.BundleA" />
<plugin id="org.foo.BundleB" />
<plugin id="org.foo.BundleB.win32" fragment="true" os="win32" />
SDK обычно включает и комплект, и его исходный код. Обратите внимание на свойство generate.feature в файле build.properties комплекта. Это свойство позволяет сгенерировать комплект "org.foo.rcp.source" на основе содержимого комплекта "org.foo.rcp". PDE создаст комплект org.foo.rcp.source, модуль с исходным кодом и фрагменты, содержащие исходный код, зависящий от платформы:
features/
org.foo.rcp.source/
feature.xml: <plugin id="org.foo.rcp.source"/>
<plugin id="org.foo.rcp.source.win32" fragment="true" os="win32" />
plugins/
org.foo.rcp.source/src/
org.foo.BundleA/src.zip
org.foo.BundleB/src.zip
org.foo.rcp.source.win32/src/
org.foo.BundleB.win32/src.zip
Свойство generate.feature задается в следующем формате:
generate.feature@<source feature id> = <feature id> [, feature@<feature id>[;attribute=value]*]* [, plugin@<plugin id>[;attribute=value]*]*
Параметр plugin@ позволяет добавить в комплект с исходным кодом дополнительные модули, не включенные в базовый комплект. Это могут быть модули документации. Параметр feature@ может применяться совместно с шаблоном для вложенных комплектов с исходным кодом (см. ниже).
Базовый комплект может содержать файлы шаблонов, позволяющие включать в комплект с исходным кодом дополнительные элементы:
features/
org.foo.rcp/
sourceTemplateFeature/<файлы для включения в комплект с исходным кодом>
sourceTemplatePlugin/<файлы для включения в модуль с исходным кодом>
sourceTemplateFragment/<файлы для включения в фрагменты, зависящие от платформы>
Все файлы, расположенные в этих папках sourceTemplate, будут включены в соответствующий модуль или комплект. Обратите внимание, что файлы из этих каталогов заменяют файлы, созданные при компоновке. Это может быть полезно для создания пользовательского feature.xml, если при компоновке невозможно выполнить какие-то особые требования для вашего комплекта с исходным кодом.
Файл
sourceTemplateFeature/build.properties содержит свойство generate.feature и позволяет создавать вложенные комплекты с исходным кодом. Файл
feature.xml в корне должен включать вложенные комплекты с исходным кодом. Для этого используется параметр
feature@ или шаблон feature.xml:
features/
org.foo.sdk/
sourceTemplateFeature/
build.properties: generate.feature@org.foo.nested.source = org.foo.nested
feature.xml: <includes id="org.foo.rcp" />
<includes id="org.foo.rcp.source" />
build.properties: generate.feature@org.foo.rcp.source = org.foo.rcp, feature@org.foo.nested.source
org.foo.rcp/...
org.foo.nested/...
Также возможно сгенерировать отдельный модуль с исходным кодом на основе комплекта, чтобы не генерировать весь комплект. Для этого существует свойство
generate.plugin@<ИД-модуля-с-исходным-кодом>=<ИД-комплекта>
Обратите внимание, что такие старые модули исходного кода (один модуль, содержащий исходный код для всех модулей компонента) должны устанавливаться в папках. Таким образом, в файле feature.xml необходимо задать атрибут unpack="true".
Пример:features/
org.foo.sdk/
feature.xml: <plugin id="org.foo.rcp" />
<plugin id="org.foo.sdk.source" unpack="true" />
build.properties: generate.plugin@org.foo.sdk.source = org.foo.sdk