이 태스크는 기준선에 상대적으로 프로파일에서 API 사용 스캔을 분석합니다. 프로파일에서 현재 누락된 유형, 메소드 및 필드에 대한 참조를 보고합니다.
Ant 태스크의 이름은 apitooling.apiusescanproblems입니다. 사용하려면 jar 파일 apitooling-ant.jar이 Ant 클래스 경로에 있어야 합니다.
<apitooling.apiusescanproblems profile="..." report="..." apiusescans="..." excludelist="..." includelist="..." preferences="..." debug="..." />
| 속성 | 설명 | 필수 |
| 프로파일 | 이 속성은 API 사용 스캔을 분석하려는 현재 제품 또는 프로파일의 위치를 지정합니다.
.zip, .jar, .tgz, .tar.gz 파일이거나, Eclipse 설치 폴더에 해당하는 디렉토리일 수 있습니다. 이것은 Eclipse 실행 파일을 찾을 수 있는 디렉토리입니다. 절대 경로를 사용하여 위치가 지정됩니다. |
예 |
| 보고서 | 보고서가 생성될 출력 위치를 설정합니다.
태스크가 완료되면, 이 디렉토리에서 보고서가 사용 가능합니다. 보고되는 문제점이 있는 각 컴포넌트마다 서브폴더가 작성됩니다. 각 서브폴더는 "report.xml"이라는 파일을 포함합니다. 절대 경로를 사용하여 위치가 지정됩니다. |
예 |
| apiusescans | 이 속성은 프로파일에 대해 확인하려는 API 사용 스캔의 쉼표로 구분된 위치 목록을 지정합니다.
.zip 파일이거나, API 사용 스캔 보고서에 해당하는 디렉토리일 수 있습니다. 이는 사용 스캔에서 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 R:javax\..* ... |
아니오 |
| includelist | 포함 목록 위치를 설정합니다.
포함 목록 위치는 분석에 포함할 번들을 나열하는 텍스트 파일을 지정합니다. 기본적으로, 프로파일의 모든 번들이 분석됩니다. 포함 및 제외 목록 속성을 사용하여 번들을 선택적으로 포함 및 제외할 수 있습니다. 포함 목록은 번들 세트가 분석되도록 하고(생략 시 모든 번들이 포함됨), 그런 다음 제외 목록이 적용됩니다. 파일의 각 행은 다음 중 하나를 지정합니다.
절대 경로를 사용하여 위치가 지정됩니다. 다음은 포함 목록 예제입니다. # DOC BUNDLES org.eclipse.jdt.doc.isv org.eclipse.jdt.doc.user org.eclipse.pde.doc.user R:org.eclipse.platform.doc.* # NON-ECLIPSE BUNDLES com.ibm.icu com.jcraft.jsch R:javax\..* ... |
아니오 |
| 환경 설정 | 태스크의 환경 설정을 설정합니다.
문제점 심각도를 구성하기 위해 환경 설정이 사용됩니다. 문제점 심각도의 세 가지 가능한 값은 무시, 경고 또는 오류입니다. 발견된 문제점 세트는 API 도구에서 해당하는 문제점 환경 설정 키로 정의됩니다. 절대 경로를 사용하여 위치가 지정됩니다. 제공된 위치가 없는 경우, 환경 설정은 설정되지 않습니다. '#'로 시작하는 행은 무시됩니다. 환경 설정 파일의 형식은 다음과 같습니다. #Thu Nov 20 17:35:06 EST 2008 API_USE_SCAN_TYPE_SEVERITY=Error API_USE_SCAN_METHOD_SEVERITY=Error API_USE_SCAN_FIELD_SEVERITY=Error키는 org.eclipse.pde.api.tools.internal.provisional.problems.IApiProblemTypes에서 찾을 수 있습니다. |
아니오 |
| 디버그 | 디버그 값을 설정합니다.
가능한 값: true, false
기본값은 false입니다. |
아니오 |
<apitooling.apiusescanproblems profile="D:\eclipse\3.7\eclipse" report="D:\reports\xml" apiusescans="D:\APIUseScan\ProductOne,D:\APIUseScan\ProductTwo" excludelist="D:\exclude_list_external.txt" preferences="D:\tests_api\org.eclipse.pde.api.tools.prefs" debug="true" />
이것은 D:\reports\xml 폴더 내에서 report.xml 파일을 작성하는 태스크를 실행합니다.
사용 스캔의 유형, 메소드 및 필드가
D:\eclipse\3.7\eclipse에 있는 프로파일에서 분석되며, 누락된 것은 보고됩니다.
D:\exclude_list_external.txt 파일에서 제외 목록을 사용하여 문제점을 보고할 번들 수를 줄입니다.
D:\tests_api\org.eclipse.pde.api.tools.prefs에서 지정한 대로 문제점 심각도가 생성됩니다.
디버그가 사용 가능하므로, 일부 디버그 추적이 Ant 콘솔에 표시됩니다.

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