Ant 스크립트는 일반적으로 PDE(Plug-in Development Environment)를 사용하여 생성되나,
수동으로 생성하거나 다른 스크립트에서 생성할 수도 있습니다.
실제로 PDE는 Ant 태스크를 노출하여 다양한 빌드 스크립트를 생성합니다. 빌드
스크립트 생성 기능은 다음과 같은 태스크에 상주합니다. 인수는 또한 각 태스크에 나열되어 있습니다.
| elements: |
페치할 항목. 예상되는 형식은 디렉토리 파일 형식에서 지정된 type@id[,version] 양식입니다. |
| buildDirectory: |
페치 스크립트가 생성되고 기능 및 플러그인 프로젝트가 체크아웃되는 디렉토리 |
| directory: |
디렉토리 파일에 대한 경로 |
| children: |
선택사항. 포함된 플러그인 및 단편에 해당하는 스크립트 생성이 호출될지 여부를 지정합니다. 기본은 true로 설정되었습니다. |
| cvspassfile: |
선택사항. CVS 비밀번호 파일의 이름 |
| fetchTag: |
선택사항. 디렉토리 파일에 제공된 태그를 주어진 값으로 대체합니다. |
| configInfo: |
선택사항. 앰퍼샌드로 구분된 구성 목록으로, 대상이 지정된 구성을 표시합니다. 기본값은 플랫폼 독립형으로 설정됩니다. |
| recursiveGeneration: |
선택사항. 중첩된 기능에 대해 페치 스크립트를 생성해야 하는지 여부를 지정합니다. 기본값은 true로 설정됩니다. |
| elements : |
빌드할 항목. 예상되는 항목의 양식은 디렉토리 파일 형식에 지정된 type@id[,version]입니다. |
| buildDirectory : |
빌드할 기능 및 플러그인이 위치하는 디렉토리. 플러그인 및 기능은 각각 plugins와 features 폴더에 있어야 합니다. |
| children : |
선택사항. 포함된 플러그인 및 단편에 해당하는 스크립트 생성이 호출될지 여부를 지정합니다. 기본은 true로 설정되었습니다. |
| recursiveGeneration : |
선택사항. 포함된 기능에 대한 스크립트 생성이 호출될지 여부를 지정합니다. 기본은 true로 설정되었습니다. |
| devEntries : |
선택사항. 컴파일 클래스 경로에 제공될 쉼표로 구분된 디렉토리 목록 |
| buildingOSGi : |
선택사항. 대상이 3.x 또는 2.1인지 여부를 표시합니다. 기본값은 true입니다. |
| baseLocation : |
선택사항. features/ 및 plugins/ 서브디렉토리와 함께 대상 Eclipse 설치를 포함하는 폴더를 표시합니다. |
| configInfo : |
선택사항. 앰퍼샌드로 구분된 구성 목록은 대상 지정된 구성을 표시합니다. 기본값은 플랫폼 독립형으로 설정됩니다. |
| pluginPath : |
선택사항. 추가 플러그인을 찾을 위치의 플랫폼 파일 구분 기호로 구분된 목록 |
| archivesFormat : |
선택사항. 앰퍼샌드로 구분된 구성 목록으로, 각 구성의 예상 출력 형식입니다. 형식은 구성과 대시(-)로 구분됩니다. 지원되는 값은 folder, tar, zip, antZip입니다. 각각 아카이브 안함, tar을 사용하여 아카이브 작성, 플랫폼에서 사용 가능한 info zip 버전 사용, Ant Zip 사용을 의미합니다. 기본값은 antZip입니다. |
| product : |
선택사항. '/'로 구분되는 경로로, 빌드할 RCP 제품의 위치입니다. 경로의 첫 번째 세그먼트는 .product 파일을 포함하는 플러그인의 플러그인 ID를 참조해야 합니다. |
| signJars : |
선택사항. 생성된 스크립트가 기능 및 플러그인의 jar에 대해 서명해야 하는지 여부를 표시합니다. 기본값은 false입니다. 서명 태스크에 대한 매개변수는 sign.alias, sign.keystore 및 sign.storepass Ant 특성에 의해 제어됩니다. 각각은 Ant signJar 태스크에서 alias, keystore 및 storepass 매개변수로 전달됩니다. 기본값은 false입니다. |
| generateJnlp : |
선택사항. 빌드하는 모든 기능에 대해 jnlp 파일을 생성해야 하는지 여부를 표시합니다. |
| outputUpdateJars : |
선택사항. 설정 시 업데이트 사이트에서 플러그인 및 기능을 생성합니다. 기본값은 false입니다. site.xml은 생성되지도 않고 업데이트되지도 않는다는 점에 주의하십시오. |
| groupConfiguration
: |
선택사항.
빌드되는 모든 구성을 단일 아카이브로 그룹화할지 여부 |
| generateVersionsLists : |
선택사항.
빌드된 기능 및 플러그인의 버전을 나열하는
특성 파일을 생성하는지 여부 |
| filteredDependencyCheck : |
선택사항. 빌드 중 고려할 플러그인 및 기능 세트를
기능에서 연결할 수 있는 것으로 제한합니다. |
| filterP2Base : |
선택사항. baseLocation에서 고려할 플러그인
및 기능 세트를 p2에서 설치를 고려하는 것으로 제한합니다. |
| generateFeatureVersionSuffix: | 선택사항. 기능 버전 접미부를 생성할지 여부. . 버전 규정자도 참조하십시오. |
| generatedVersionLength : |
선택사항, 생성된 기능 버전 접미부의 길이. 기본값은 28로 설정되어 있습니다. . 버전 규정자도 참조하십시오. |
| significantVersionDigits : |
선택사항. 기능 버전 접미부를 생성할 때 사용하는 숫자의 자릿수.
버전 규정자도 참조하십시오. |
| forceContextQualifier : |
선택사항. 주어진 값을 사용하여 플러그인 및 기능에 의해 .qualifier를
대체합니다. 버전 규정자도 참조하십시오. |
| featureId : |
생성된
기능에 부여될 ID |
| buildDirectory: |
포함할 기능
및 플러그인이 있는 /features 및 /plugins 서브디렉토리의
상위 디렉토리. 생성된 기능은
/features 서브디렉토리에 배치됩니다. |
| baseLocation : |
선택사항. 설치된 기능 및 플러그인이 들어 있는 폴더를 표시합니다. |
| productFile : |
선택사항.
생성된 기능의 기반이 될 제품 파일 |
| verify : |
제공된 플러그인
및 기능을 사용할 수 있는지 확인하기 위해 분석기를 사용할지
여부. 또한 해당 기능이 JAR로 처리될 플랫폼
특정 단편 및 플러그인을 올바르게 처리할 수 있는지
여부를 판별합니다. 기능에 포함될 모든
요소를 로컬로 사용할 수 있는 경우 verify를
True로 설정해야 합니다. 요소를 저장소에서 페치해야
하는 경우 verify를 False로 설정하고 결과 기능을
사용하여 필요한 플러그인 및 기능을 페치한 후
verify = True를 사용하여 컨테이너 기능을 다시 생성하십시오. |
| pluginPath : |
선택사항. 추가 플러그인을 찾을 위치의 플랫폼 파일 구분 기호로 구분된 목록 |
| configInfo : |
선택사항. 앰퍼샌드로 구분된 구성 목록은 대상 지정된 구성을 표시합니다. 기본값은 플랫폼 독립형으로 설정됩니다. |
| pluginList : |
선택사항. 생성된 기능에 포함할 쉼표로 구분된 플러그인 ID 목록(속성 지원, 아래 참조) |
| featureList : |
선택사항. 생성된 기능에 포함할 쉼표로 구분된 기능 ID 목록(속성 지원, 아래 참조) |
| fragmentList : |
선택사항. 생성된 기능에 포함할 쉼표로 구분된 단편 ID 목록(속성 지원, 아래 참조) |
| buildPropertiesFile : |
선택사항. 컨텐츠를 생성된 기능의 build.properties로 사용해야 하는 특성 파일의 위치. |
| includeLaunchers : |
선택사항. equinox 실행기 포함 여부. 기본값은 "true". |
eclipse.generateFeature 태스크의 pluginList, featureList 및 fragmentList 인수는 모두 속성을 지원합니다. 이러한 인수의 형식은 모두 다음과 같습니다.
List = <element-id>[;<attribute>=<value>]* [,<element-id>[;<attribute>=<value>]*]*
각 attribute=value 쌍은 지정된 요소에 해당하는 생성된 xml로 삽입됩니다. 예제:
featureList = org.eclipse.feature;optional=true
pluginList = org.eclipse.plugin.A;unpack=true
fragmentList=org.eclipse.fragment.a;os=win32,org.eclipse.fragment.b;os=linux;ws=gtk;arch=x86
<feature ...>
...
<includes id="org.eclipse.feature" version="0.0.0" optional="true" />
...
<plugin id="org.eclipse.plugin.A" version="0.0.0" unpack="true" />
<plugin id="org.eclipse.fragment.a" version="0.0.0" os="win32" fragment="true" />
<plugin id="org.eclipse.fragment.b" version="0.0.0" os="linux" ws="gtk" arch="x86" fragment="true" />
...
</feature>
<eclipse.fetch elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
directory="directory.txt"
configInfo="win32,win32,x86 & linux, motif, x86"
/>
<eclipse.buildScript elements="bundle@org.eclipse.osgi"
buildDirectory="c:\toBuild"
archivesFormat="macosx, carbon, ppc - tar"/>
Eclipse가 실행 중인 경우에만 이전에 설명한 태스크가 작동합니다. Eclipse 태스크를 사용하는 실행 중인 Ant 스크립트의 특정 시나리오에서, Eclipse Ant 실행 애플리케이션을 사용하여 스크립트를 실행해야 합니다. 이러한 특정한 경우에 적합한 명령행은 다음과 같습니다.
java -jar plugins/org.eclipse.equinox.launcher_<version>.jar -application org.eclipse.ant.core.antRunner -buildfile build.xml
애플리케이션 다음에 표시되는 매개변수는 Ant로 전달되는 매개변수임에 유의하십시오.