기능 및 플러그인 사용자 정의 빌드 단계
3.2의 새로운 기능은 기능 또는 플러그인이 사용자 정의 및 대상을 고유 빌드로 컨트리뷰션할 수 있는 기능입니다. 이러한
사용자 정의 단계는 컴파일 후 바이트-코드 수행,
문서화할 도움말 파일 색인화 또는 예비 파일의
번들 복사 등과 같은 작업에 사용할 수 있습니다.
사용자 정의 대상을 사용하려면 기능 또는 플러그인이
해당 build.properties 파일에 customBuildCallbacks
특성을 정의해야 합니다. 이 특성 값은 사용자 정의
대상을 포함하며 기능/플러그인의 루트에 상대적인
xml 파일의 위치입니다.XML 파일이 다른 위치에 있는 경우에는
customBuildCallbacks.buildpath 특성을 사용하여 사용할 디렉토리를 설정하십시오.
지원되는 사용자 정의 대상을 포함하는 customBuildCallbacks.xml 템플리트가
org.eclipse.pde.build/templates/plugins 및 org.eclipse.pde.build/templates/features에 제공됩니다. 이
템플리트는 기능/플러그인에 복사할 수 있으며 필요에 따라 수정할
수 있습니다.
사용자 정의 대상은 subant 태스크를 사용하여 호출됩니다. 기본적으로 failonerror는
false로 설정됩니다. 이 설정을 변경하려면 customBuildCallbacks.failonerror 특성을
true로 설정하십시오. 마찬가지로 inheritall 매개변수의 기본값은 false입니다. 변경하려면
customBuildCallbacks.inheritall 특성을 설정하십시오.
플러그인
생성된 build.xml은 플러그인을 빌드하며 특정 태스크를
수행하는 여러 대상을 포함합니다. PDE 빌드를 사용하면
플러그인이 특정 태스크 전후에 호출될 사용자 정의 사전 및
사후 대상을 제공할 수 있습니다. 이미 정의된 Ant
특성뿐만 아니라 각 사용자 정의 대상에도 여러 특정 특성이
전달될 수 있습니다. 다음 대상은 사용자 정의 콜백을 지원합니다.
- build.jars:
build.jars 대상은 이 번들에 대해 빌드될 각 컴파일
대상을 차례로 호출합니다. 이 번들은 모든
컴파일 대상을 호출하기 전 또는 그 후에 호출되는 pre.build.jars 및 post.build.jars 대상을 지원합니다.
사전 및 사후 대상 모두
build.result.folder
특성이 제공됩니다. 이 특성은
빌드 결과가 복사될 폴더입니다.
- 컴파일 대상:
build.xml은 빌드되는 각 JAR의 컴파일 대상을 정의합니다(예: 번들 자체 또는 library.jar의 @dot). 각 컴파일 대상은 3개의 사용자 정의 콜백을 지원합니다.
- pre.<compilation target>: 소스
파일이 컴파일되기 전에 호출됩니다. 다음 특성과 함께 제공됩니다.
- post.compile.<compilation
target>: 소스가 컴파일된
후 클래스 파일이 JAR 처리되거나 빌드
결과 폴더에 복사되기 전에 호출됩니다.
pre.<compilation
target> 대상과 동일한 특성이 제공됩니다.
- post.<compilation target>:
결과를 빌드 결과 폴더에 복사한 후 컴파일 대상
끝에서 호출됩니다. 다음 특성과 함께 제공됩니다.
- jar.Location: 컴파일
결과를 포함하는 JAR 또는 폴더
- <compilation target>.classpath: 컴파일에
사용된 클래스 경로를 포함하는
Ant 경로 구조에 대한 참조
- build.sources: 이
대상은 각 컴파일 대상의 소스 ZIP을
빌드합니다. pre.build.sources 및 post.build.sources 대상을
지원합니다. 이 대상에는 모두 특성
build.result.folder가 제공됩니다. 이
폴더는 소스 ZIP 파일이 복사될 폴더입니다.
- gather.bin.parts: 이 대상은 빌드 결과(예: 번들에 포함되는 다른 모든 파일 및 JAR)를
최종 대상 디렉토리에 복사합니다. 또한
Manifest 파일에서 버전 규정자가 바뀌는
대상입니다(버전
규정자 참조). pre.gather.bin.parts 및 post.gather.bin.parts 대상을
지원합니다. 다음과 같이 사전 및 사후 대상에 두 특성이 제공됩니다.
- build.result.folder: 빌드
결과가 들어
있는 폴더
- target.folder: 빌드
결과 및 빌드 컨텐츠가
복사되는 대상 폴더
- gather.sources: 이
대상은 번들의 소스 ZIP 파일을 수집합니다. pre.gather.sources 및 post.gather.sources 대상을 지원합니다.
사전 및 사후 대상에 모두
target.folder 특성이 제공됩니다. 이
특성은 소스가 복사되는 폴더입니다.
- gather.logs: 이
대상은 빌드에서 로그 파일을 수집합니다. pre.gather.logs 및 post.gather.logs를 지원합니다.
사전 및 사후 대상에 모두
destination.temp.folder가 제공됩니다. 이
특성은 로그 파일이 복사되는 임시 폴더입니다.
- clean: 이
대상은 정리를 수행하며 pre.clean
및 post.clean 대상을 지원합니다.
사전 및 사후 대상의 특성은 다음과 같습니다.
- plugin.destination: 최종
번들이 복사된
폴더
- build.result.folder: 빌드
결과가 복사된
폴더
- temp.folder: 결과를 최종 대상에 복사하기 전에 스테이징된 임시 폴더
기능
기능에 대해 생성된 build.xml은 gather.bin.parts 대상에
대한 사용자 정의 빌드 콜백만 지원합니다. 이 대상은 포함된 모든 기능 및 플러그인의 gather.bin.parts 대상을
호출합니다. pre.gather.bin.parts 및 post.gather.bin.parts를 지원합니다. 두 대상 모두 다음 특성과 함께 제공됩니다.
- destination.temp.folder: 플러그인을 복사할 디렉토리
- feature.directory: 이
기능의 파일이
복사될 디렉토리