이 태스크에서는 제공된 API 사용 스캔을 수행하여 제공된 후보 제품 릴리스에서 다시 분석하도록 시도한 후 분석되지 않은 참조를 보고합니다.
Ant 태스크의 이름은 apitooling.apimigration입니다. 사용하려면
jar 파일 apitooling-ant.jar가 Ant 클래스 경로에 있어야 합니다.
<apitooling.apimigration
candidate="..."
usescan="..."
scopepattern="..."
referencepattern="..."
excludelist="..."
includelist="..."
report="..."
debug="..."
/>
| 속성 | 설명 | 필수 |
| candidate |
이 속성은 마이그레이션 후보로 사용할 제품을 지정합니다. .zip, .jar, .tgz, .tar.gz 파일이거나, Eclipse 설치 폴더에 해당하는 디렉토리일 수 있습니다. 이것은 Eclipse 실행 파일을 찾을 수 있는 디렉토리입니다. |
예 |
| usescan |
이 속성은 마이그레이션 후보와 비교할 제품 사용 스캔을 지정합니다. usescan은 사용 스캔의 루트에 대한 절대 경로를 통해 지정됩니다. |
예 |
| scopepattern |
이 속성은 제품 위치에서 참조를 검색할 소스 요소 범위를 빌드하는 데 사용되는 정규식 패턴을 지정합니다.
패턴은 여기에 정의된 대로 잘 형식화된 정규식이어야 합니다. |
아니오 |
| referencepattern |
제품 위치에서 참조를 검색할 대상 요소 범위를 빌드하는 데 사용되는 정규식 패턴을 설정합니다.
패턴은 여기에 정의된 대로 잘 형식화된 정규식이어야 합니다. |
아니오 |
| excludelist |
제외 목록 위치를 설정합니다.
제외 목록 위치는 분석에서 제외할 번들을 나열하는 텍스트 파일을 지정합니다. 기본적으로, 프로파일의 모든 번들이 분석됩니다. 포함 및 제외 목록 속성을 사용하여 번들을 선택적으로 포함 및 제외할 수 있습니다. 포함 목록은 번들 세트가 분석되도록 하고(생략 시 모든 번들이 포함됨), 그런 다음 제외 목록이 적용됩니다. 파일의 각 행은 다음 중 하나를 지정합니다.
절대 경로를 사용하여 위치가 지정됩니다. 다음은 제외 목록 예제입니다. # EXCLUDED BUNDLES R:org\.eclipse\..*\.doc\..* ... |
아니오 |
| includelist |
포함 목록 위치를 설정합니다. 포함 목록 위치는 분석에 포함할 번들을 나열하는 텍스트 파일을 지정합니다. 기본적으로, 프로파일의 모든 번들이 분석됩니다. 포함 및 제외 목록 속성을 사용하여 번들을 선택적으로 포함 및 제외할 수 있습니다. 포함 목록은 번들 세트가 분석되도록 하고(생략 시 모든 번들이 포함됨), 그런 다음 제외 목록이 적용됩니다. 파일의 각 행은 다음 중 하나를 지정합니다.
절대 경로를 사용하여 위치가 지정됩니다. 다음은 포함 목록 예제입니다. # INCLUDED BUNDLES R:org\.eclipse\..* ... |
아니오 |
| 보고서 |
보고서가 생성될 출력 위치를 설정합니다.
태스크가 완료되면, 계층 구조를 사용하는 이 디렉토리에서 보고서가 사용 가능합니다. 참조하는 다른 번들이 있는 각 컴포넌트마다 서브폴더가 작성됩니다. 각 서브폴더는 "[bundlename].xml"이라는 파일을 포함합니다. 이 폴더 내에는 폴더를 포함하는 번들을 참조하는 각 번들마다 다른 서브폴더("[referencing bundle name].xml")가 있습니다. 참조 번들 폴더 내에는 해당 유형의 유형, 메소드 또는 필드 참조를 포함하는 세 개의 서브 폴더(API, PRIVATE 또는 OTHER) 중 하나가 있습니다 다른 두 개의 특수 파일 "not_searched.xml" 및 "no_apidescription.xml"은 보고서 디렉토리로 쓰여지며 사용 정보가 검색되지 않는 기준선의 번들과 .api_description 파일이 없는 번들에 대한 정보를 각각 포함합니다. 절대 경로를 사용하여 위치가 지정됩니다. 예제:
root
|
+-- "not_searched.xml"
+-- "no_apidescription.xml"
+-- bundle name with usage
|
+--referencing bundle name
|
+-- [API or PRIVATE or OTHER]
|
+--[type_ or method_ or field_]references.xml
|
예 |
| 디버그 |
디버그 값을 설정합니다.
가능한 값: true, false기본값은 false입니다. |
아니오 |
<apitooling.apimigration
candidate="/eclipse/sdk3.5"
usescan="/eclipse/scans/sdk3.4"
scopepattern=".*"
referencepattern="org\.eclipse.*"
excludelist="D:\exclude_list_external.txt"
report="/eclipse/apimigration/xml"
debug="true"
/>
이는 /eclipse/apimigration/xml 폴더 내에서 *.xml 파일을 작성하는 태스크를 실행합니다.
해당 태스크로 정규식 해당 ID가 org\.eclipse.* 정규식에서 정의한 org.eclipse로 시작되는
후보 제품에 반하여 정규식 .*에서 정의한 usescan 위치의 모든 참조를
다시 분석합니다. D:\exclude_list_external.txt에 있는 제외 목록 파일을 사용하여 보고할 문제점 수를 줄입니다.
디버그가 사용 가능한 경우, 일부 디버그 추적이 Ant 콘솔에 표시됩니다.
API 정지 Ant 태스크
파일 생성 Ant 태스크
분석 보고서 변환 Ant 태스크
API 정지 보고서 변환 Ant 태스크
API 비지원 Ant 태스크
API 비지원 보고서 변환 Ant 태스크
API 사용 보고서 변환 Ant 태스크
API 사용 마이그레이션 보고서 변환 Ant 태스크