컴파일러 옵션
PDE/빌드는 개별 플러그인의 컴파일러를 제어하는 다수의 옵션을 지원합니다. 소스와 대상 레벨 및 bootclasspath와 관련한 설정은
"컴파일 환경 설정"을 참조하십시오.
경고 및 오류
PDE/빌드를 이용하여 build.properties 파일에 사용자 정의 컴파일 경고와 오류를 지정할 수 있습니다. 이러한 오류 및 경고는
javacWarnings.<library> 및 javacErrors.<library> 옵션을 사용하여 라이브러리 단위로 설정할 수
있습니다(하나의 플러그인이 여러 개의 Jar 라이브러리를 포함할 수 있음).
이러한 특성의 값은
배치 컴파일러 사용 페이지(Java 개발 사용자 안내서)의 "-warn:..." 섹션에 지정됩니다.
예제:
javacErrors.. = forbidden,discouraged,
javacWarnings.library.jar = deprecation,nullDereference
프로젝트 환경 설정의 경고 및 오류
이제 PDE/빌드 중에도 JDT 프로젝트 환경 설정을 사용할 수 있습니다. PDE/빌드 자체는 환경 설정 파일을 읽을 수 없지만 이러한 파일을 읽을 수 있는 JDT 컴파일러에
전달할 수는 있습니다.
이를 사용하기 위해서는 플러그인이 build.properties 파일에 javacProjectSettings 특성을 지정해야 합니다. 값은 다음과 같아야 합니다.
- javacProjectSettings=true: 기본 .settings/org.eclipse.jdt.core.prefs 환경 설정 파일에 지정된 프로젝트 설정을 사용합니다.
- javacProjectSettings=path/to/jdt.prefs: 지정된 환경 설정 파일을 사용합니다.
일부 프로젝트의 경우 작업공간에서 releng 빌드와 다른 경고와 오류 설정을 사용하고자 할 수 있습니다.
이 경우 "javacWarnings.<library>" 특성에 비해 더 간편한 방법으로 오류와 경고 설정을 지정할 수 있습니다.
파일 인코딩
PDE/빌드는 라이브러리, 폴더 또는 파일 단위로 사용자 정의 파일 인코딩을 승인할 수 있습니다.
- javacDefaultEncoding.<library>
- 특정 라이브러리를 컴파일할 때 사용할 기본 인코딩을 설정합니다.
- javacCustomEncodings.<library> - 특정 라이브러리를 컴파일할 때 사용할
경로 및 인코딩의 쉼표로 구분된 목록. 폴더를 지정하면 해당 폴더에 포함된 모든 내용에 대해 인코딩이 사용됩니다. 파일을 지정하면
해당 파일에 대해서만 인코딩이 사용됩니다. 예제:
javacCustomEncodings.library.jar = src/org/foo[US-ASCII], src/org/foo/bar.java[ISO-8859-1]
사용자 정의 컴파일러 인수
번들의 build.properties 파일에 있는 compilerArg 특성을 사용하여 번들 단위로 사용자 정의 컴파일러 인수를 지정할 수 있습니다. 이 특성은 빌더 구성의
compilerArg 특성과 유사하지만, 전체 플러그인이 아니라 단일 플러그인에만 영향을 준다는 점에서 차이가 있습니다.
특정 인수는 사용되는 컴파일러에 따라 달라집니다. JDT 컴파일러 인수는 여기에 나열됩니다.
컴파일러 옵션 우선순위
다른 컴파일러 옵션을 지정하는 방법은 여러 가지가 있습니다. 일반적으로 옵션 우선순위는 다음과 같습니다.
- javacDefaultEncoding.<library>가 사용자 정의 -encoding 명령행 옵션에 우선합니다.
- 일반 옵션의 경우 컴파일러 명령행에서 이후에 표시되는 옵션이 이전에 지정된 옵션을 대체합니다. 옵션은 다음과 같은 순서로 JDT에 제공됩니다.
- 빌더 구성의 compilerArg 특성. (모든 번들에 영향을 줌).
- 이 플러그인에 있는 build.properties의 compilerArg 특성
- javacProjectSettings를 사용하여 지정한 컴파일러 환경 설정 파일
- 파일 인코딩, javacWarnings, javacErrors 및 액세스 규칙을 포함하는 생성된 컴파일러 인수 파일(javaCompiler.<library>.args)
사용자 정의 컴파일러 사용
번들이 compilerAdapter 특성을 설정하여 사용자 정의 컴파일러를 사용할 수 있습니다. Ant 환경에서 지정된 컴파일러 어댑터가 사용 가능해야 합니다.
기본적으로 사용되는 JDT 컴파일러 어댑터는 org.eclipse.jdt.core.JDTCompilerAdapter입니다. 대체 컴파일러를 지정하는 한 가지 이유는 Aspect J 또는 Groovy 번들 때문입니다.
사용자 정의 컴파일러 어댑터를 지정하는 번들은 다음의 일부 특성도 지정해야 합니다.
- sourceFileExtensions: 소스로 간주해야 하는 확장기능 목록. (예: *.java, *.aj, *.groovy).
- compilerAdapter.useLog: "-log" 인수를 컴파일러에 전달해야 하는지의 여부
- compilerAdapter.useArgFile: 생성된 javaCompiler.<library>.args 인수 파일의 전달 여부(액세스 규칙, 파일 인코딩 및 경고/오류 레벨 포함).