소스 번들은 헤더에 있는 Eclipse-SourceBundle 헤더의 존재로 확인됩니다. 이 헤더의 양식은 다음과 같습니다.
Eclipse-SourceBundle: <bundle-id>;version=<version>;roots:="root1, root2"
bundle-id 및 version은 포함된 소스 코드가 해당하는 번들을 나타냅니다. roots는 실제로 소스 코드를 포함하는 소스 번들 내에 있는 폴더를 나타냅니다. 루트 지시문이 지정되지 않은 경우, "." 값이 추정됩니다.
클래스 파일 라이브러리는 예상되는 방식으로 소스 위치에 맵핑됩니다. 플러그인의 루트는 소스 번들의 루트에 맵핑됩니다. 이는 jar로 묶인 플러그인에 대한 기본 케이스입니다. 플러그인에 추가 라이브러리 "foo/lib.jar"가 있는 경우, 소스가 소스 번들의 해당 "foo/libsrc/" 폴더에 있을 것으로 예상됩니다.
org.eclipse.pde.core.jar org.eclipse.pde.core.source.jar - org/**/*.class - org/**/*.java - ant_tasks/pde-ant.jar - ant_tasks/pde-antsrc/org/**/*.java
Eclipse-SourceBundle: org.eclipse.pde.core;version="3.4.0.N20071128-0010";roots:="ant_tasks/pde-antsrc,."
org.eclipse.pde.build/ org.eclipse.pde.build.source.jar - pdebuild.jar - pdebuildsrc/org/**/*.java - lib/pdebuild-ant.jar - lib/pdebuild-antsrc/org/**/*.java
Eclipse-SourceBundle: org.eclipse.pde.build;version="3.4.0.N20071128-0010";roots:="pdebuildsrc,lib/pdebuild-antsrc"
PDE/빌드 시, UI없는 빌드에서만 개별 소스 번들을 자동으로 생성할 수 있습니다. 개별 소스 번들 생성은 다음을 지정하여 수행할 수 있습니다.
individualSourceBundles=true
이는 빌드 구성의 최상위 레벨 build.properties 파일에 지정되어야 하며 해당 빌드를 위해 모든 소스 생성을 제어합니다. 기존 소스 플러그인 및 기능에 대한 세부사항은 소스 기능 및 플러그인 생성을 참조하십시오. 이 페이지의 나머지에서는 기존 소스 생성에 익숙하다고 가정합니다.
generate.feature@<source feature id> = <feature id> [, feature@<feature id>]* [, plugin@<plugin id>]* [, exclude@<plugin id>]*
개별 소스 번들 생성 시, 이 특성은 전과 같은 상태에 있으며 동일한 속성(예: version, unpack, optional 등)을 지원합니다. 차이는 결과 소스 기능으로 나타납니다. 그 전에, 소스 기능에는 빌드된 각 플랫폼에 대한 소스의 단편 + 하나의 소스 플러그인이 포함되어야 합니다. 새 형식에서는, 소스 기능에 원래 기능에 나열된 각 플러그인/단편에 대한 소스 번들이 포함됩니다.
plugin@ syntax를 통해 소스 기능에 포함된 플러그인은 해당 소스 번들을 가져오지 않습니다. 이는 doc 플러그인을 소스 기능에 추가하는 데 유용합니다.
개별 소스 생성에 대한 exclude@ 항목은 새롭습니다. 원래 기능에 포함된 일부 플러그인(예: 원시 코드만 포함된 doc 플러그인 또는 단편)에는 소스가 없을 수도 있으며 생성된 소스 기능에서 제외되어야 합니다. exclude@ 항목에서는 version 속성을 지원합니다.
예제:generate.feature@org.eclipse.jdt.source=org.eclipse.jdt, plugin@org.eclipse.jdt.doc.isv;unpack="false",exclude@org.eclipse.jdt.doc.user
이전 형식에서는, generate.plugin 특성이 주어진 기능의 컨텐츠를 기반으로 한 소스 플러그인을 생성합니다. 이는 다음과 같이 개별 소스 번들 생성 시 주어진 플러그인을 기반으로 하도록 변경됩니다.
generate.plugin@<source plug-in id>=<plug-in id>
generate.plugin 특성은 기능에 의해 사용되어 소스 기능 없이 소스를 포함했습니다(배후에서 전체 소스 기능이 생성된 경우라도). 개별 소스 번들 생성 시, 기능에는 각 플러그인에 대한 해당 generate.plugin 특성과 함께 각 플러그인에 대한 *.source 번들이 포함되어야 합니다.
예제: sdk.examples 기능이 다음과 같이 표시하는 데 사용되었습니다.
<feature id="org.eclipse.sdk.examples" ... > .... <plugin id="org.eclipse.sdk.examples.source" version="0.0.0"/> <plugin id="org.eclipse.sdk.examples.source.win32.win32.x86" version="0.0.0"/> </feature>
generate.plugin@org.eclipse.sdk.examples.source=org.eclipse.sdk.examples
이는 다음과 같이 변경됩니다.
<feature id="org.eclipse.sdk.examples" ...> ... <plugin id="org.eclipse.compare.examples.source" version="0.0.0"/> <plugin id="org.eclipse.debug.examples.core.source" version="0.0.0"/> <plugin id="org.eclipse.swt.examples.source" version="0.0.0"/> </feature>
generate.plugin@org.eclipse.compare.examples.source=org.eclipse.compare.examples generate.plugin@org.eclipse.debug.examples.core.source=org.eclipse.debug.examples.core generate.plugin@org.eclipse.swt.examples.source=org.eclipse.swt.examples
소스 번들에 실제로 소스가 없기 때문에, 특정 플러그인에 소스 번들이 필요 없을 수도 있습니다. 이는 원시 라이브러리만 포함된 플랫폼의 단편에 대해 발생할 수 있습니다. 이 경우, generate.feature에 위와 같이 요약된 대로 번들이 기능에 의해 제외될 수 있습니다.
또는 번들이 고유의 build.properties 파일에, 번들에 대해 생성되어야 하는 소스 번들이 없도록 명시적으로 지정할 수 있습니다.
generateSourceBundle=false
원래 번들의 post.gather.source 사용자 정의 콜백을 사용하여 항상 사용자 정의 컨텐츠를 생성된 소스 번들에 추가할 수 있습니다(기능 및 플러그인 사용자 정의 빌드 단계 참조).
이를 수행할 때, 생성된 소스 번들이 Eclipse-SourceBundle 헤더의 올바른 루트 지시문을 갖도록 플러그인의 build.properties 파일에 "src.additionalRoots" 특성을 설정하십시오.
예제:
org.junit4 :
build.properties
src.includes = about.html,junitsrc.zip
src.additionalRoots=junitsrc
customBuildCallbacks=customBuildCallbacks.xml
customBuildCallbacks.xml
<target name="post.gather.sources" >
<mkdir dir="${target.folder}/junitsrc"/>
<unzip src="${target.folder}/junitsrc.zip" dest="${target.folder}/junitsrc" overwrite="false"/>
<delete file="${destination.temp.folder}/junitsrc.zip" />
</target>
이전에는, 생성된 소스 플러그인이 생성된 소스 기능에 대한 브랜딩 플러그인으로 제공되었습니다. 브랜딩 파일(about.properties, eclipse32.gif 등)이 원래 기능의 sourceTemplatePlugin 디렉토리를 사용하여 제공되었습니다.
개별 소스 번들 생성 시 소스 기능에 대한 브랜딩 플러그인이 원래 브랜딩 플러그인에 해당하는 소스 번들이 됩니다. 이는 원래 브랜딩 플러그인의 src.includes 특성을 사용하여 소스 기능의 브랜딩 플러그인에 대한 브랜딩 파일을 컨트리뷰션할 수 있음을 의미합니다.
또한 소스를 생성하는 기능에 대한 sourceTemplatePlugin 폴더에서도 브랜딩 플러그인에 파일을 컨트리뷰션합니다.
이전에는, 원래 기능의 sourceTemplatePlugin 디렉토리 컨텐츠가 소스 플러그인으로 복사되었습니다. 이는 이제 개별 소스 번들 생성 시 브랜딩 소스 번들에 대해서만 해당됩니다(위의 내용 참조).
기타 모든 소스 번들의 경우, sourceTemplateBundle 디렉토리의 컨텐츠가 복사됩니다.