API 정지 Ant 태스크

목적

이 태스크는 API 기준선에 상대적으로 추가, 수정 또는 제거된 API를 식별합니다. 이 태스크는 API 정지 이후에 API 변경사항이 없음을 검증하기 위한 것입니다.

사용법

설명

Ant 태스크의 이름은 apitooling.apifreeze입니다. 사용하려면 jar 파일 apitooling-ant.jar이 Ant 클래스 경로에 있어야 합니다.

<apitooling.apifreeze
	baseline="..."
	profile="..."
	report="..."
	excludelist="..."
	includelist="..."
	debug="..."
		eefile="..."
/>

매개변수

속성 설명 필수
기준선 이 속성은 참조 기준선의 위치를 지정합니다.

.zip, .jar, .tgz, .tar.gz 파일이거나, Eclipse 설치 폴더에 해당하는 디렉토리일 수 있습니다. 이것은 Eclipse 실행 파일을 찾을 수 있는 디렉토리입니다.

절대 경로를 사용하여 위치가 지정됩니다.
예
프로파일 이 속성은 참조 기준선에 대해 비교하려는 현재 제품이나 프로파일의 위치를 지정합니다.

.zip, .jar, .tgz, .tar.gz 파일이거나, Eclipse 설치 폴더에 해당하는 디렉토리일 수 있습니다. 이것은 Eclipse 실행 파일을 찾을 수 있는 디렉토리입니다.

절대 경로를 사용하여 위치가 지정됩니다.
예
보고서 생성되는 보고서 파일의 이름을 설정합니다.

절대 경로를 사용하여 지정되어야 합니다.
디렉토리가 아닌 파일 위치여야 합니다.
예
excludelist 제외 목록 위치를 설정합니다.

제외 목록 위치는 분석에서 제외할 번들을 나열하는 텍스트 파일을 지정합니다. 기본적으로, 프로파일의 모든 번들이 분석됩니다. 포함 및 제외 목록 속성을 사용하여 번들을 선택적으로 포함 및 제외할 수 있습니다. 또한 이 태스크는 포함 및 제외 목록의 멤버 나열을 지원합니다. 포함 목록은 번들 및 멤버의 세트가 분석되도록 하고(생략 시 모든 번들과 멤버가 포함됨), 그런 다음 제외 목록이 적용됩니다. 파일의 각 행은 다음 중 하나를 지정합니다.
  • 특정 번들 이름
  • 특정 멤버 이름
  • 번들 또는 멤버 이름에 대해 일치 여부를 확인하는 정규식("R:"로 시작하는 행)
  • 주석('#'으로 시작하는 행)

절대 경로를 사용하여 위치가 지정됩니다.
다음은 제외 목록 예제입니다.
# ECLIPSE MEMBERS
org.eclipse.jface.databinding_1.2.0:org.eclipse.jface.databinding.viewers.ObservableListContentProvider#getElements(Ljava/lang/Object;)[Ljava/lang/Object;
# ECLIPSE BUNDLES
org.eclipse.ui.workbench_3.4.0:org.eclipse.ui.ISharedImages#IMG_DEC_FIELD_ERROR
org.eclipse.ui.workbench_3.4.0:org.eclipse.ui.ISharedImages#IMG_DEC_FIELD_WARNING
org.eclipse.ui.workbench_3.4.0:org.eclipse.ui.ISharedImages#IMG_ELCL_COLLAPSEALL
# NON-ECLIPSE BUNDLES
com.ibm.icu
R:javax\..*
...
아니오
includelist 포함 목록 위치를 설정합니다.

포함 목록 위치는 분석에 포함할 번들을 나열하는 텍스트 파일을 지정합니다. 기본적으로, 프로파일의 모든 번들이 분석됩니다. 포함 및 제외 목록 속성을 사용하여 번들을 선택적으로 포함 및 제외할 수 있습니다. 또한 이 태스크는 포함 및 제외 목록의 멤버 나열을 지원합니다. 포함 목록은 번들 및 멤버의 세트가 분석되도록 하고(생략 시 모든 번들과 멤버가 포함됨), 그런 다음 제외 목록이 적용됩니다. 파일의 각 행은 다음 중 하나를 지정합니다.
  • 특정 번들 이름
  • 특정 멤버 이름
  • 번들 또는 멤버 이름에 대해 일치 여부를 확인하는 정규식("R:"로 시작하는 행)
  • 주석('#'으로 시작하는 행)

절대 경로를 사용하여 위치가 지정됩니다.
다음은 포함 목록 예제입니다.
# ECLIPSE MEMBERS
org.eclipse.jface.databinding_1.2.0:org.eclipse.jface.databinding.viewers.ObservableListContentProvider#getElements(Ljava/lang/Object;)[Ljava/lang/Object;
# ECLIPSE BUNDLES
org.eclipse.ui.workbench_3.4.0:org.eclipse.ui.ISharedImages#IMG_DEC_FIELD_ERROR
org.eclipse.ui.workbench_3.4.0:org.eclipse.ui.ISharedImages#IMG_DEC_FIELD_WARNING
org.eclipse.ui.workbench_3.4.0:org.eclipse.ui.ISharedImages#IMG_ELCL_COLLAPSEALL
# NON-ECLIPSE BUNDLES
com.ibm.icu
R:javax\..*
...
아니오
디버그 디버그 값을 설정합니다.

가능한 값: true, false
기본값은 false입니다.
아니오
eefile 사용할 실행 환경 파일을 설정합니다.

기본값으로, JavaSE-1.6 실행 환경에 해당하는 실행 환경 파일이 사용됩니다.

파일의 형식은 이 wiki 페이지에서 설명됩니다.

절대 경로를 사용하여 파일이 지정됩니다.
아니오

예제

	<apitooling.apifreeze
		baseline="D:\eclipse\3.4.1\eclipse"
		profile="D:\eclipse-SDK-I20081118-0800-linux-gtk.tar.gz"
		report="D:\report\report.xml"
		excludelist="D:\exclude_list.txt"
		debug="true"
	/>

이것은 D:\reports\xml 폴더 내에서 report.xml을 작성하는 태스크를 실행합니다. 제외 목록 D:\exclude_list_external.txt를 사용하여 보고할 문제점 수를 줄입니다.

디버그가 사용 가능하므로, 일부 디버그 추적이 Ant 콘솔에 표시됩니다.

관련 참조

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