개별 소스 번들

Eclipse의 소스 번들에 대한 기존 양식은 주어진 기능에 포함된 모든 플러그인에 대한 src.zip을 포함하는 폴더였습니다. 3.4에서는 Eclipse가 개별 소스 번들과 함께 제공됩니다. 각 번들에는, 해당 번들의 소스를 포함하는 jar인 관련 소스 번들이 있습니다. 이렇게 되면 소스 전달이 보다 유연해지며, 일부 플랫폼에서 발생할 수 있는 경로 길이의 문제가 줄어듭니다.

Eclipse-SourceBundle

소스 번들은 헤더에 있는 Eclipse-SourceBundle 헤더의 존재로 확인됩니다. 이 헤더의 양식은 다음과 같습니다.

Eclipse-SourceBundle: <bundle-id>;version=<version>;roots:="root1, root2"

bundle-id 및 version은 포함된 소스 코드가 해당하는 번들을 나타냅니다. roots는 실제로 소스 코드를 포함하는 소스 번들 내에 있는 폴더를 나타냅니다. 루트 지시문이 지정되지 않은 경우, "." 값이 추정됩니다.

클래스 파일 라이브러리는 예상되는 방식으로 소스 위치에 맵핑됩니다. 플러그인의 루트는 소스 번들의 루트에 맵핑됩니다. 이는 jar로 묶인 플러그인에 대한 기본 케이스입니다. 플러그인에 추가 라이브러리 "foo/lib.jar"가 있는 경우, 소스가 소스 번들의 해당 "foo/libsrc/" 폴더에 있을 것으로 예상됩니다.

개별 소스 번들 생성

PDE/빌드 시, UI없는 빌드에서만 개별 소스 번들을 자동으로 생성할 수 있습니다. 개별 소스 번들 생성은 다음을 지정하여 수행할 수 있습니다.

individualSourceBundles=true

이는 빌드 구성의 최상위 레벨 build.properties 파일에 지정되어야 하며 해당 빌드를 위해 모든 소스 생성을 제어합니다. 기존 소스 플러그인 및 기능에 대한 세부사항은 소스 기능 및 플러그인 생성을 참조하십시오. 이 페이지의 나머지에서는 기존 소스 생성에 익숙하다고 가정합니다.

generate.feature

기능의 build.properties 파일에서는, generate.feature 특성이 pde.build에 소스 기능 생성을 알립니다.
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 특성이 주어진 기능의 컨텐츠를 기반으로 한 소스 플러그인을 생성합니다. 이는 다음과 같이 개별 소스 번들 생성 시 주어진 플러그인을 기반으로 하도록 변경됩니다.

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

generateSourceBundle

소스 번들에 실제로 소스가 없기 때문에, 특정 플러그인에 소스 번들이 필요 없을 수도 있습니다. 이는 원시 라이브러리만 포함된 플랫폼의 단편에 대해 발생할 수 있습니다. 이 경우, 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

이전에는, 원래 기능의 sourceTemplatePlugin 디렉토리 컨텐츠가 소스 플러그인으로 복사되었습니다. 이는 이제 개별 소스 번들 생성 시 브랜딩 소스 번들에 대해서만 해당됩니다(위의 내용 참조).

기타 모든 소스 번들의 경우, sourceTemplateBundle 디렉토리의 컨텐츠가 복사됩니다.