이 태스크는 기준선에 상대적인 API 프로파일의 전체 비교를 실행합니다.
Ant 태스크의 이름은 apitooling.compare입니다. 사용하려면 jar 파일 apitooling-ant.jar이 Ant 클래스 경로에 있어야 합니다.
<apitooling.compare baseline="..." profile="..." report="..." excludelist="..." includelist="..." components="..." visibility="..." debug="..." />
| 속성 | 설명 | 필수 |
| 기준선 | 이 속성은 참조 기준선의 위치를 지정합니다.
.zip, .jar, .tgz, .tar.gz 파일이거나, Eclipse 설치 폴더에 해당하는 디렉토리일 수 있습니다. 이것은 Eclipse 실행 파일을 찾을 수 있는 디렉토리입니다. 절대 경로를 사용하여 위치가 지정됩니다. |
예 |
| 프로파일 | 이 속성은 참조 기준선에 대해 비교하려는 현재 제품이나 프로파일의 위치를 지정합니다.
.zip, .jar, .tgz, .tar.gz 파일이거나, Eclipse 설치 폴더에 해당하는 디렉토리일 수 있습니다. 이것은 Eclipse 실행 파일을 찾을 수 있는 디렉토리입니다. 절대 경로를 사용하여 위치가 지정됩니다. |
예 |
| 보고서 | 보고서를 생성할 출력 위치를 설정합니다.
태스크가 완료되면, 이 디렉토리에서 "compare.xml" 보고서가 사용 가능합니다. 절대 경로를 사용하여 위치가 지정됩니다. |
예 |
| excludelist | 제외 목록 위치를 설정합니다.
제외 목록 위치는 분석에서 제외할 번들을 나열하는 텍스트 파일을 지정합니다. 기본적으로, 프로파일의 모든 번들이 분석됩니다. 포함 및 제외 목록 속성을 사용하여 번들을 선택적으로 포함 및 제외할 수 있습니다. 포함 목록은 번들 세트가 분석되도록 하고(생략 시 모든 번들이 포함됨), 그런 다음 제외 목록이 적용됩니다. 파일의 각 행은 다음 중 하나를 지정합니다.
절대 경로를 사용하여 위치가 지정됩니다. 다음은 제외 목록 예제입니다. # DOC BUNDLES org.eclipse.jdt.doc.isv org.eclipse.jdt.doc.user org.eclipse.pde.doc.user org.eclipse.platform.doc.isv org.eclipse.platform.doc.user # NON-ECLIPSE BUNDLES com.ibm.icu com.jcraft.jsch javax.servlet javax.servlet.jsp # Exclude all pde bundles R:org\.eclipse\.pde\..* ...제외 목록은 행이 "R:"로 시작하는 경우 정규식을 포함할 수 있습니다. |
아니오 |
| includelist | 포함 목록 위치를 설정합니다.
포함 목록 위치는 분석에 포함할 번들을 나열하는 텍스트 파일을 지정합니다. 기본적으로, 프로파일의 모든 번들이 분석됩니다. 포함 및 제외 목록 속성을 사용하여 번들을 선택적으로 포함 및 제외할 수 있습니다. 포함 목록은 번들 세트가 분석되도록 하고(생략 시 모든 번들이 포함됨), 그런 다음 제외 목록이 적용됩니다. 파일의 각 행은 다음 중 하나를 지정합니다.
절대 경로를 사용하여 위치가 지정됩니다. 다음은 포함 목록 예제입니다. # DOC BUNDLES org.eclipse.jdt.doc.isv org.eclipse.jdt.doc.user org.eclipse.pde.doc.user org.eclipse.platform.doc.isv org.eclipse.platform.doc.user # NON-ECLIPSE BUNDLES com.ibm.icu com.jcraft.jsch javax.servlet javax.servlet.jsp # Exclude all pde bundles R:org\.eclipse\.pde\..* ... |
아니오 |
| 디버그 | 디버그 값을 설정합니다.
가능한 값: true, false
기본값은 false입니다. |
아니오 |
| components | 컴포넌트의 목록 위치를 설정합니다.
컴포넌트 목록에는 비교되어야 하는 모든 컴포넌트 이름이 포함됩니다. 생략하면 제공된 기준선의 모든 컴포넌트가 비교됩니다. 절대 경로를 사용하여 위치가 지정됩니다. 컴포넌트의 목록 파일 형식은 다음과 같습니다. # DOC BUNDLES org.eclipse.jdt.doc.isv org.eclipse.jdt.doc.user org.eclipse.pde.doc.user org.eclipse.platform.doc.isv org.eclipse.platform.doc.user # Include all pde bundles R:org\.eclipse\.pde\..* ...컴포넌트 목록은 행이 "R:"로 시작하는 경우 정규식을 포함할 수 있습니다. |
아니오 |
| visibility | 가시성 값을 설정합니다.
가능한 값: API, ALL
기본값은 API입니다.
|
아니오 |
<apitooling.compare baseline="D:\eclipse\3.4.1\eclipse" profile="D:\eclipse-SDK-I20081118-0800-linux-gtk.tar.gz" report="D:\reports\xml" excludelist="D:\exclude_list_external.txt" debug="true" />
이는 D:\reports\xml 폴더 내에서 compare.xml 파일을 작성하는 태스크를 실행합니다.
제외 목록을 사용하여 보고할 문제점 수를 줄입니다.
디버그가 사용 가능하므로, 일부 디버그 추적이 Ant 콘솔에 표시됩니다.

API 정지 Ant 태스크
파일 생성 Ant 태스크
API 사용 Ant 태스크
분석 보고서 변환 Ant 태스크
API 정지 보고서 변환 Ant 태스크
API 사용 보고서 변환 Ant 태스크
API 비지원 보고서 변환 Ant 태스크