저장소에서 페치

PDE 빌드의 하부 구조는 빌드 프로세스의 파트로 저장소에서 미리 빌드된 플러그인 및 소스 코드를 페치하는 단계를 제공합니다(eclipse.fetch 태스크 및 페치를 제어하는 특성 참조). 가능한 페치 방법은 PDE 빌드가 자동으로 소스를 페치하거나 소스 코드를 수동으로 페치하는 것입니다.

자동화의 첫 번째 단계, 맵 파일

빌드 하부 구조는 빌드해야 하는 기능 또는 플러그인의 ID를 사용하여 포함된 모든 기능 및 플러그인을 저장소에서 페치할 수 있습니다.

PDE는 필요한 대상을 찾기 위해 맵 파일을 사용합니다. 맵 파일은 기능 및 플러그인 ID를 저장소의 태그 및 위치로 맵핑하는 Java 특성 파일입니다. 맵 파일의 형식은 열려 있으나 키 부분은 PDE 빌드로 고정되어 있습니다.

<elementType>@<elementID>[,<elementVersion>] = <repo specific content>

여기서 elementType은 bundle, feature, plugin 또는 fragment 중 하나이며, elementId와 elementVersion은 요소의 특성을 부여합니다.

CVS용 맵 파일 항목

CVS에서 컨텐츠를 페치할 맵 파일 항목의 형식은 다음과 같습니다.
<key> = CVS, [,args]
여기서 args는 아래에서 설명하는 키/값 쌍의 쉼표로 구분되는 목록입니다. 예제:
plugin@com.ibm.icu,3.6.1=CVS,tag=v200704191630,cvsRoot=:pserver:anonymous@dev.eclipse.org:/cvsroot/tools,path=org.eclipse.orbit/com.ibm.icu/bin,prebuilt=true

이전 스타일 맵 항목
Eclipse 3.2 이전 버전에서 CVS의 맵 파일 형식은 다음과 같았습니다.
<elementType>@<elementID> = CVS, <TAG>, <CVSROOT>[,<PASSWORD>[,<PATH>[,<CVSPASSFILE>]]]
선택적 인수를 지정하지 않은 경우 다음 인수를 구분하려면 여전히 쉼표가 필요합니다. 이 형식은 지원되지 않는 형식으로 간주되며 키/값 형식이 선호됩니다.

Ant GET용 맵 파일 항목

Ant GET이 지원하는 URL에서 컨텐츠를 페치할 맵 파일 항목의 형식은 다음과 같습니다.

<key> = GET, <url> [,args]
여기서 url은 데이터를 검색할 URL이며 args는 아래에서 설명하는 키/값 쌍의 쉼표로 구분되는 목록입니다. 예제:
plugin@com.ibm.icu,3.4.5=GET,http://download.eclipse.org/tools/orbit/downloads/drops/S200705301823/bundles/com.ibm.icu_3.4.5.jar, unpack=true

p2 페치용 맵 파일 항목

사용자가 p2 저장소에서 아티팩트를 페치할 수 있도록 하는 새 확장자가 PDE/빌드에 추가되었습니다. 이제 빌드 입력을 위한 맵 파일에 항목을 추가할 수 있으며 PDE/빌드는 아티팩트를 검색해서 빌드에 포함시킵니다. 맵 파일 항목은 설치 단위(IU)의 버전 및 ID와 IU를 찾을 수 있는 저장소의 URI를 포함시켜야 합니다. 메타데이터 및 아티팩트 저장소는 함께 위치하는 것으로 가정됩니다.

p2를 통해 컨텐츠를 페치하기 위한 맵 파일 항목의 형식은 다음과 같습니다.

<elementType>@<elementID> = p2IU, id=<id>, version=<version>, repository=<repository>
p2와의 빌드 페치

Helios 릴리스에서, 기능 jar를 나타내는 설치 가능 단위를 지정하여 p2와 함께 기능을 페치할 수 있습니다. 기능에 맞는 p2 메타데이터의 구조에 대한 세부사항은 기능 메타데이터 페이지를 참조하십시오.

예제:
plugin@my.bundle.id,1.0.0=p2IU,id=my.bundle.id,version=1.0.0,repository=http://example.eclipse.org/repo
feature@my.feature.id = p2IU,id=my.feature.id.feature.jar, version=1.0.0,repository=http://example.eclipse.org/repo

기타 저장소를 위한 맵 파일 항목

PDE 빌드는 다른 저장소의 페치 스크립트 생성기를 플러그인할 수 있는 확장점을 제공합니다. Eclipse 설치에 다른 저장소 유형에 대한 스크립트 생성기 확장을 제공하는 번들이 포함된 경우, 맵 파일 항목에 해당 저장소를 지정하고 확장 제공자가 지정한 형식에 첨부하여 그 저장소를 사용할 수 있습니다.

CVS 소스 페치를 위한 설정

CVS에서 소스 페치를 설정하려면 다음을 수행해야 합니다.

CVS에서 맵 파일 가져오기

맵 파일은 일반적으로 저장소에 저장됩니다. PDE 빌드는 맵 파일을 CVS 저장소에서 가져오는 기본 하부 구조를 제공합니다. 이 기능을 사용하려면 구성 디렉토리의 구성 build.properties에서 다음 특성을 변경하십시오. CVS에서 맵 파일 페치는 빌드의 빌드 전 단계에서 수행됩니다. 빌드하는 기능에 포함된 모든 기능 및 플러그인을 페치하는 스크립트는 빌드의 페치 단계에서 생성되고 실행됩니다. 

다른 저장소에서 자동 페치

저장소에서 맵 파일을 자동으로 페치하는 경우, org.eclipse.pde.build/templates/headless-build의 customTarget.xml 파일을 구성 디렉토리에 복사해야 합니다. 대상 getMapFiles는 맵 파일을 페치하는 데 사용되므로 저장소에서 페치하도록 수정해야 합니다.

수동으로 소스 코드 가져오기

customTargets.xml 파일의 preSetup 또는 postSetup 대상에서 호출할 수 있는 플러그인 및 기능을 검색하도록 사용자 정의 페치 대상을 작성할 수 있습니다.  기능 및 플러그인은 각각 ${buildDirectory}/features 및 ${buildDirectory}/plugins로 페치되어야 합니다.