컴파일 환경 설정

번들은 기본적으로 빌드를 실행하는 데 사용되는 JRE와 1.3 및 1.2로 설정된 소스 및 대상 레벨로 컴파일됩니다.

PDE 빌드는 컴파일 시 사용되는 JRE를 번들당 기준으로 구성할 수 있습니다. 이 기능을 이용하려면 먼저 PDE 빌드에 사용할 수 있는 JRE를 알려주어야 합니다. 빌드 구성 build.properties 파일에서 설치된 JRE 각각을 가리키는 특성을 설정하십시오. org.eclipse.pde.build/templates/headless-build에 제공된 build.properties 템플리트에는 주석을 표시한 환경의 목록이 포함됩니다. JRE 특성의 주석을 해제하고 시동 클래스 경로에 속하는 JAR의 세트로 값을 설정합니다. 예를 들어, 다음 특성을 설정하십시오.

J2SE-1.5=C:/Java/1.5/jre/lib/rt.jar;C:/Java/1.5/jre/lib/jsse.jar

Java 1.5가 필요한 번들을 rt.jar 및 jsse.jar에 대해 컴파일합니다. 특성 이름은 PDE 빌드가 인식하는 환경 이름과 일치해야 합니다.   PDE 빌드는 각 환경의 소스 및 대상 레벨을 자동으로 설정합니다. PDE 빌드가 인식하는 환경과, 연관된 해당 소스/대상 레벨은 다음과 같습니다.

환경
소스
대상
CDC-1.0/Foundation-1.0
1.3
1.1
CDC-1.1/Foundation-1.1
1.3
1.2
OSGi/Minimum-1.0
1.3
1.1
OSGi/Minimum-1.1
1.3
1.2
JRE-1.1
1.1
1.1
J2SE-1.2
1.2
1.1
J2SE-1.3
1.3
1.1
J2SE-1.4
1.3
1.2
J2SE-1.5
1.5
1.5
JavaSE-1.6
1.6
1.6
PersonalJava-1.1
1.1
1.1
PersonalJava-1.2
1.1
1.1
CDC-1.0/PersonalBasis-1.0
1.3
1.1
CDC-1.0/PersonalJava-1.0
1.3
1.1
CDC-1.1/PersonalBasis-1.1
1.3
1.2
CDC-1.1/PersonalJava-1.1
1.3
1.2

번들 환경 선택

번들을 컴파일하는 데 사용되는 환경에 영향을 주는 두 가지 설정이 있습니다. 그 중 하나는 Manifest 헤더 Bundle-RequiredExecutionEnvironment입니다.  이 헤더는 번들을 실행할 수 있는 환경의 목록입니다. 번들은 나열된 모든 환경의 올바른 서브세트에 있는 메소드만 사용해야 합니다. 컴파일 환경은 가능한 런타임 환경과 일치해야 합니다.

두 번째 설정은 번들의 build.properties 파일에 있는 jre.compilation.profile 특성입니다. 이 특성의 값은 Bundle-RequiredExecutionEnvironment 목록이 적절하지 않은 경우 이 번들을 컴파일하기 위해 선호되는 환경이어야 합니다.

이러한 두 설정이 함께 환경 목록 jre.compilation.profile을 먼저 구성한 후 Bundle-RequiredExecutionEnvironment에서 환경을 구성합니다. 이 목록에서 빌드 구성에서 사용할 수 있는 첫 번째 환경(위 섹션 참조)을 사용하여 번들을 컴파일합니다.

예제:
<buildDirectory>/plugins/bundleA/
META-INF/manifest.mf: Bundle-RequiredExecutionEnvironment: CDC-1.0/Foundation-1.0, J2SE-1.3
build.properties:  jre.compilation.profile=J2SE-1.4

<buildConfiguration>/
build.properties:  J2SE-1.3=C:/Java1.3/jre/lib/rt.jar;C:/Java1.3/jre/lib/i18n.jar
J2SE-1.4=C:/Java1.4/jre/lib/rt.jar;C:/Java1.4/jre/lib/jsse.jar

위의 단계에서 고려 대상 환경 목록(순서 지정)은 J2SE-1.4, CDC-1.0/Foundation-1.0, J2SE-1.3입니다. 번들은 CDC/Foundation 및 J2SE-1.3에서 실행할 수 있지만 특정 이유로 인해 J2SE-1.4로 컴파일되어야 합니다. 이 경우, J2SE-1.4는 빌드 구성에 설정되며 환경 목록에 처음에 표시되므로 번들을 컴파일하는 데 사용됩니다. 이 경우 사용되는 소스 및 대상 레벨은 1.3 및 1.2입니다. 대신 빌드 구성이 J2SE-1.4가 아닌 J2SE-1.3만 정의하는 경우, 목록에서 JRE를 사용할 수 있는 환경은 J2SE-1.3뿐이므로 이 환경을 사용하여 번들을 컴파일합니다. 이러한 경우 소스 레벨과 대상 레벨은 1.3 및 1.1입니다.

컴파일 값의 명시적 설정

특정 이유로 인해 위에서 설명한 대로 환경을 사용해도 원하는 설정을 얻을 수 없는 경우, 번들이 필요한 설정을 명시적으로 나열할 수 있습니다. 예를 들어, 번들이 J2SE-1.4에서 assert를 사용하는 경우 소스 및 대상 레벨은 기본 1.3 및 1.2 대신 1.4여야 합니다.

Java 소스 및 대상 레벨을 명시적으로 설정하려면, 번들이 해당 build.properties 파일에 javacSource 및 javacTarget 특성을 설정해야 합니다. 이러한 특성은 환경 설정에서 파생된 값을 대체합니다.

마찬가지로, 번들 build.properties 파일의 bootClasspath 특성을 설정하면 번들이 컴파일되는 JAR 세트를 대체합니다.