일괄처리 컴파일러 사용

일괄처리 컴파일러 찾기

일괄처리 컴파일러 클래스는 JDT 코어 플러그인에 있습니다. 클래스 이름은 org.eclipse.jdt.compiler.batch.BatchCompiler입니다. plugins/org.eclipse.jdt.core_<version>.jar로 패키지됩니다. 3.2부터 별도 다운로드로 사용할 수도 있습니다. 파일 이름은 ecj.jar입니다. 대응하는 소스도 사용 가능합니다. 이를 가져오려면 다운로드 페이지로 이동하여 JDT 코어 일괄처리 컴파일러 섹션을 검색하십시오. 이 jar에는 일괄처리 컴파일러와 javac ant 어댑터가 포함되어 있습니다.

3.3 이후로 이 jar에는 jsr199(컴파일러 API) 지원과 jsr269(어노테이션 처리) 지원도 포함됩니다. 어노테이션 처리 지원을 사용하려면 1.6 VM이 필수입니다.

따라서 Eclipse 외부의 Ant 빌드 내에서 독립형 애플리케이션으로 사용할 수 있습니다.

일괄처리 컴파일러 실행

사용 가능한 옵션

권장 옵션에는 주황색 배경이 있습니다.

일부 옵션을 여러 번 설정할 경우 일괄처리 컴파일러가 이를 왼쪽에서 오른쪽으로 이용합니다. 경고 옵션(-warn:....)에 '+' 또는 '-'를 사용하지 않으면 이전에 지정된 경고 세트를 겹쳐씁니다. 따라서 사용자는 -warn 옵션을 사용하기 전에 해당 옵션이 제공되었는지 확인해야 합니다.

일부는 -err: 옵션에서 적용됩니다.

이름 사용법
클래스 경로 옵션
-bootclasspath <dir 1>;<dir 2>;...;<dir P> 컴파일러에서 사용되는 클래스 파일을 부트스트랩하는 데 사용되는 디렉토리 또는 jar 파일 목록입니다. 기본적으로, 실행 중인 VM 라이브러리가 사용됩니다. 항목은 플랫폼 경로 구분자로 구분됩니다.
각 디렉토리 또는 파일은 '['와 ']' 사이에 유형 액세스 규칙을 지정할 수 있습니다.

bootclasspath가 지정되지 않으면 컴파일러가 다음 시스템 특성 sun.boot.class.path, vm.boot.class.path 또는 org.apache.harmony.boot.class.path를 각각 이 순서대로 사용하여 bootclasspath를 추정합니다.

-cp
-classpath <dir 1>;<dir 2>;...;<dir P>
소스 파일을 컴파일하는 데 사용되는 디렉토리 또는 jar 파일 목록입니다. 기본값은 "java.class.path" 특성 값입니다. 항목은 플랫폼 경로 구분자로 구분됩니다.
각 디렉토리 또는 파일은 '['와 ']' 사이에 유형 액세스 규칙을 지정할 수 있습니다. 예를 들어, [-X]는 유형 X에 대한 액세스를 금지하고 [~X]는 유형 X에 대한 액세스를 방해하며 [+p/X:-p/*]는 p 패키지 내 모든 유형에 대한 액세스는 금지하고 p/X에 대한 액세스는 허용합니다.
컴파일러는 jar 파일 Manifest의 Class-Path 절을 반복적으로 따라가며, 참조된 각 jar 파일이 아직 클래스 경로에 없으면 클래스 경로의 끝에 첨부합니다.
-extdirs <dir 1>;<dir 2>;...;<dir P> 확장 zip/jar 파일의 위치를 지정하는 데 사용되는 디렉토리 목록입니다. 항목은 플랫폼 경로 구분자로 구분됩니다.
-endorseddirs <dir 1>;<dir 2>;...;<dir P> 규정화된 zip/jar 파일 위치를 지정하는 데 사용되는 디렉토리 목록입니다. 항목은 플랫폼 경로 구분자로 구분됩니다.
-sourcepath <dir 1>;<dir 2>;...;<dir P> 소스 파일을 지정하는 데 사용되는 디렉토리 목록입니다. 항목은 플랫폼 경로 구분자로 구분됩니다.
각 디렉토리는 '['와 ']' 사이에 유형 액세스 규칙을 지정할 수 있습니다.
-d <dir 1>|none 생성된 .class 파일을 덤프해야 하는 디렉토리를 지정하는 데 사용됩니다. 이 옵션을 생략하면 패키지 디렉토리 구조가 작성되지 않습니다.
.class 파일을 생성하지 않으려면 -d none을 사용하십시오.
-encoding <encoding name> 모든 소스 파일의 기본 인코딩을 지정합니다. 또한 각 입력 소스 파일/폴더 이름에 [<encoding name>] 접미부를 추가하여 파일별로 사용자 정의 인코딩을 지정할 수도 있습니다. 예를 들어, X.java[utf8]에서는 현재 사용자 디렉토리에 있는 컴파일 단위 X.java의 UTF-8 인코딩을 지정합니다.

다중 기본 소스 파일 인코딩이 지정된 경우, 마지막으로 지정된 인코딩이 사용됩니다.

예를 들어 다음과 같습니다.

  • ... -encoding UTF-8 X.java[Cp1252] Y.java[UTF-16] Z.java ....
    모든 소스 파일을 UTF-8 인코딩을 통해 읽습니다(Z.java 포함). X.java는 Cp1252 인코딩을 통해 읽고 Y.java는 UTF-16 인코딩을 통해 읽습니다.
  • ... -encoding UTF-8 -encoding UTF-16 ....
    모든 소스 파일을 UTF-16 인코딩을 통해 읽습니다. UTF-8에 대한 -encoding 옵션은 무시됩니다.
  • ... -encoding Cp1252 /foo/bar/X.java[UTF-16] /foo/bar[UTF-8] ....
    모든 소스 파일을 Cp1252 인코딩을 통해 읽습니다. X.java는 UTF-16 인코딩을 통해 읽을 /foo/bar 디렉토리의 유일한 파일입니다. 해당 디렉토리의 기타 파일에서는 모두 UTF-8 인코딩을 사용합니다.
준수 옵션
-target 1.1 to 1.7 or (5, 5.0, etc) .class 파일 대상 설정을 지정합니다. 가능한 값은 다음과 같습니다.
  • 1.1(주 버전: 45 부 버전: 3)
  • 1.2(주 버전: 46 부 버전: 0)
  • 1.3(주 버전: 47 부 버전: 0)
  • 1.4(주 버전: 48 부 버전: 0)
  • 1.5, 5 or 5.0(주 버전: 49 부 버전: 0)
  • 1.6, 6 or 6.0(주 버전: 50 부 버전: 0)
  • 1.7, 7 or 7.0(주 버전: 51 부 버전: 0)
기본값은 다음과 같습니다.
  • 1.1(-1.3 모드)
  • 1.2(-1.4 모드)
  • 1.5(-1.5 모드)
  • 1.6(-1.6 모드)
  • 1.7(-1.7 모드)

clcd1.1을 사용하여 StackMap 속성을 생성할 수 있습니다.

-1.3 준수 레벨을 1.3으로 설정합니다. 암시적 -source 1.3 -target 1.1.
-1.4 준수 레벨을 1.4(기본값)로 설정합니다. 암시적 -source 1.3 -target 1.2.
-1.5 준수 레벨을 1.5로 설정합니다. 암시적 -source 1.5 -target 1.5.
-1.6 준수 레벨을 1.6으로 설정합니다. 암시적 -source 1.6 -target 1.6.
-1.7 준수 레벨을 1.7로 설정합니다. 암시적 -source 1.7 -target 1.7.
-source 1.1 to 1.7 or (5, 5.0, etc) 이는 컴파일러가 예상하는 소스 레벨을 지정하는 데 사용됩니다.
가능한 값은 다음과 같습니다.
  • 1.3
  • 1.4
  • 1.5, 5 또는 5.0
  • 1.6, 6 또는 6.0
  • 1.7, 7 또는 7.0
기본값은 다음과 같습니다.
  • 1.3(-1.3 모드)
  • 1.3(-1.4 모드)
  • 1.5(-1.5 모드)
  • 1.6(-1.6 모드)
  • 1.7(-1.7 모드)
1.4에서는 assert가 키워드로 간주됩니다. 1.5 및 1.6에서는 enum 및 assert가 키워드로 간주됩니다.
경고 옵션
-?:warn -help:warn 고급 경고 옵션 표시
-warn:... 사용 가능한 경고 세트를 지정합니다.
예제: -warn:unusedLocal,deprecation
-warn:none disable all warnings
-warn:<warning tokens separated by ,> enable exactly the listed warnings
-warn:+<warning tokens separated by ,> enable additional warnings
-warn:-<warning tokens separated by ,> disable specific warnings
아래 열 기본값에서 "+/-" 표시는 옵션이 세분화된 여러 경고 변형을 포함함을 표시합니다. 일부는 기본적으로 사용되며, 일부는 사용되지 않습니다. 즉, "+"로 지정된 옵션을 지정하면 기본값보다 더 많은 경고를 사용할 수 있으며 "-"를 지정하면 기본적으로 사용되는 일부를 사용하지 않습니다.
기본값 토큰 이름 설명
+/- allDeadCode 단순한 if (DEBUG) 검사를 포함한 불필요한 코드
+/- allDeprecation 지원되지 않는 코드 내에서의 폐기
- allJavadoc javadoc가 올바르지 않거나 누락됨
- allOver-ann 누락된 모든 @Override 어노테이션(수퍼클래스 및 수퍼인터페이스)
- all-static-method 모든 메소드가 정적 경고로 선언될 수 있음
+ assertIdentifier assert가 ID로 사용됨
- boxing 오토박싱(autoboxing) 변환
+ charConcat 문자 배열이 명시적으로 문자열로 변환되지 않고 문자열 연결에서 사용되는 경우
+ compareIdentical 동일한 표현식 비교
- conditionAssign 부울 지정 가능성
+ constructorName 생성자 이름이 있는 메소드
+ deadCode trivial if(DEBUG) check를 제외한 불필요한 코드
- dep-ann @Deprecated 어노테이션 누락
+/- deprecation 지원되지 않는 코드 밖의 폐기된 유형 또는 멤버 사용
+ discouraged 올바르지 않은 액세스 규칙과 일치하는 유형 사용
- emptyBlock 문서화되지 않은 빈 블록
+ enumIdentifier enum이 ID로 사용됨
+ enumSwitch 불완전한 열거 스위치
- enumSwitchPedantic 기본 케이스가 존재하는 경우에도 열거 스위치 케이스 누락 보고
- fallthrough 가능한 fall-through 케이스
- fieldHiding 다른 변수를 숨기는 필드
+ finalBound 최종 바인드된 유형 매개변수
+ finally finally 블록이 정상적으로 완료되지 않음
+ forbidden 금지 액세스 규칙과 일치하는 유형 사용
- hashCode equals() 대체 시 hashCode() 메소드 누락
+/- hiding fieldHiding, localHiding, typeHiding 및 maskedCatchBlock에 대한 매크로
- includeAssertNull assert 표현식에서 잘못된 변수에 대해 널 경고를 발생시킵니다.
- indirectStatic Static 멤버에 대한 간접 참조
+ intfAnnotation 어노테이션 유형이 상위 인터페이스로 사용됨
+ intfNonInherited 인터페이스 비상속 메소드 호환성
- intfRedundant 잉여 수퍼인터페이스 찾기
- javadoc 올바르지 않은 javadoc
- localHiding 로컬 변수가 다른 변수를 숨김
+ maskedCatchBlock 숨겨진 catch 블록
- nls 비nls 문자열 리터럴(//$NON-NLS-<n> 태그 없음)
+ noEffectAssign 영향을 주지 않는 지정
+/- null 가능한 누락된 또는 중복 널(null) 검사
- nullAnnot 어노테이션 기반 널 분석을 사용합니다.
원하는 경우 컴파일러에서 해석할 어노테이션 유형을 완전한 이름을 사용하여 각 어노테이션이 지정된 (nullable|nonnull|nonnullbydefault)를 추가하여 지정할 수 있습니다.
아래 -nonNullByDefault도 참조하십시오.
- nullDereference 누락된 널(null) 검사
- over-ann 누락된 @Override 어노테이션(수퍼클래스 전용)
- paramAssign 매개변수 지정
+ pkgDefaultMethod 패키지 기본 메소드 대체 시도
+ raw 매개변수화된 유형 대신 원시 유형 사용
+/- 자원 (잠재적) 닫기 가능 유형의 자원에 대한 안전하지 않은 사용
- semicolon 불필요한 세미콜론 또는 빈 명령문
+ serial serialVersionUID 누락
- specialParamHiding 생성자 또는 setter 매개변수가 다른 필드를 숨김
+/- static-access indirectStatic 및 staticReceiver에 대한 매크로
- static-method 정적 메소드로 가능한 인스턴스 메소드
+ staticReceiver static 필드를 가져오거나 정적 메소드를 호출하는데 비정적 수신기가 사용되는 경우
- 상위 상위 호출을 작성하지 않고 메소드를 대체합니다.
+ suppress @SuppressWarnings 사용
- switchDefault 기본 케이스가 없는 switch 문
- syncOverride 동기화된 메소드 대체 시 동기화된 메소드 누락
- syntheticAccess 내부 클래스에 대한 종합적 액세스 수행 시
- tasks 소스 코드에서 tasks 태그에 대한 지원 사용
+ typeHiding 다른 유형을 숨기는 유형 매개변수
+ unavoidableGenericProblems 원시 API로 인해 피할 수 없는 유형 안전성 문제점 무시
+ unchecked 선택되지 않은 유형 오퍼레이션
- unnecessaryElse 불필요한 else 절
- unqualifiedField 필드에 대한 규정되지 않은 참조
+/- unused unusedAllocation, unusedArgument, unusedImport, unusedLabel, unusedLocal, unusedPrivate, unusedThrown 및 unusedTypeArgs에 대한 매크로
- unusedAllocation 사용되지 않은 오브젝트 할당
- unusedArgument 사용하지 않는 메소드 인수
+ unusedImport 사용하지 않는 가져오기 참조
+ unusedLabel 사용하지 않는 레이블
+ unusedLocal 사용하지 않는 로컬 변수
+ unusedPrivate 사용하지 않는 private 멤버 선언
- unusedThrown 사용하지 않는 발생 예외 선언
+ unusedTypeArgs 메소드 및 생성자에 대한 사용되지 않는 유형 인수
- uselessTypeCheck 불필요한 cast/instanceof 오퍼레이션
+ varargsCast varargs 인수가 필요로 하는 명시적 캐스트
+/- warningToken @SuppressWarnings에서 처리되지 않거나 사용되지 않은 경고 토큰
-nowarn 경고 없음(-warn:none과 동일)
-err:... 오류로 변환되는 사용 가능한 경고 세트를 지정합니다.
예제: -err:unusedLocal,deprecation
unusedLocal 및 거부 경고가 오류로 변환됩니다. 기타 경고는 모두 계속 경고로 보고됩니다.
-err:<warning tokens separated by ,> 나열된 경고를 오류로 정확히 변환
-err:+<warning tokens separated by ,> 추가 경고를 오류로 변환
-err:-<warning tokens separated by ,> 오류로 변환되지 않도록 특정 경고 제거
-deprecation -warn:+deprecation과 동일합니다.
-properties <file> 특성 파일 컨텐츠에 따라 경고/오류 옵션을 설정합니다. 이 옵션은 -nowarn, -err:.. 또는 -warn:.. 옵션과 함께 사용할 수 있지만 명령행에서 마지막으로 설정된 옵션이 사용됩니다.

기존의 Java 프로젝트에서 프로젝트별 설정을 수행하고 .settings/org.eclipse.jdt.core.prefs 파일에 있는 파일을 특성 파일로 사용하거나 org.eclipse.jdt.core.JavaCore 클래스에 정의된 상수를 사용하는 정의된 엔트리/값 쌍인 단순 텍스트 파일을 사용하여 특성 파일 컨텐츠를 생성할 수 있습니다.

...
org.eclipse.jdt.core.compiler.problem.annotationSuperInterface=warning
org.eclipse.jdt.core.compiler.problem.assertIdentifier=warning
org.eclipse.jdt.core.compiler.problem.autoboxing=ignore
...
디버그 옵션
-g[:none|:lines,vars,source] 디버그 속성 레벨을 설정하십시오.
-g 모든 디버그 정보(-g:lines,vars,source와 동일)
-g:none 디버그 정보 없음
-g:[lines,vars,source] 선택적 디버그 정보
-preserveAllLocals 디버그 목적으로 모든 로컬 변수를 보존하도록 컴파일러에 명시적으로 요청합니다. 이 옵션을 생략하면 컴파일러가 사용하지 않는 로컬을 제거합니다.
어노테이션 처리 옵션(1.6 VM 이상이 필요하며 준수가 1.6인 경우에만 사용됨)
-Akey[=value] 어노테이션 프로세서에 전달되는 어노테이션 프로세서 옵션입니다. key는 점으로 구분된 ID로 구성됩니다.
-proc:[only|none] -proc:only가 지정되면 어노테이션 프로세서가 실행되지만 컴파일은 수행되지 않습니다. -proc:none이 지정되면 어노테이션 프로세서가 발견되거나 실행되지 않습니다. 컴파일은 어노테이션 프로세서가 없는 경우와 같이 처리됩니다. 기본적으로, 컴파일러는 classpath에서 어노테이션 프로세서를 찾아야 하므로, 어노테이션 처리가 필요하지 않은 경우 -proc:none을 지정하면 컴파일의 속도가 빨라질 수 있습니다.
-processor <class1[,class2,...]> 실행할 어노테이션 프로세서의 규정된 클래스 이름입니다. 지정된 경우, 일반 프로세서 감지 프로세스를 건너뜁니다.
-processorpath <dir 1>;<dir 2>;...;<dir P> 어노테이션 프로세서를 검색할 디렉토리 또는 jar 파일 목록입니다. 항목은 플랫폼 경로 구분자로 구분됩니다. 지정하지 않을 경우 대신 클래스 경로가 검색됩니다.
-s <dir> 생성된 소스 파일이 작성될 디렉토리입니다.
-XprintProcessorInfo 프로세서가 처리하도록 요청된 어노테이션과 요소에 대한 정보 인쇄
-XprintRounds 어노테이션 처리 순환에 대한 정보 인쇄
-classNames <class1[,class2,...]> 처리해야 하는 2진 유형의 규정된 이름
javac 옵션과의 호환성을 위해 무시되는 옵션
-J<option> 가상 시스템에 옵션 전달
-X<option> 비표준 옵션 지정. -Xemacs는 무시됩니다.
-X 비표준 옵션 인쇄 및 종료
-O 실행 시간 최적화
고급 옵션
@<file> 파일에서 명령행 인수를 읽습니다.
-maxProblems <n> 컴파일 단위당 최대 문제점 수(기본적으로 100개)
-log <filename> 컴파일러의 모든 출력을 덤프할 로그 파일을 지정하십시오. 이 옵션은 일괄처리 컴파일러를 디버그하거나 오류와 경고를 모두 포함하는 파일을 일괄처리 빌드에서 가져오려는 경우 아주 유용합니다. 확장자가 .xml인 경우, 생성된 로그는 xml 파일입니다.
-Xemacs 콘솔 및 일반 텍스트 로그에 오류 및 경고 위치를 제공하려면 emacs 스타일을 사용하십시오. 이 옵션은 XML 로그에 영향을 주지 않습니다. 이 옵션이 활성화된 경우,
2. WARNING in /workspace/X.java
(at line 8)...

다음과 같이 제공됩니다.
/workspace/X.java:8: warning: The method...
-proceedOnError[:Fatal] 오류에도 불구하고 컴파일을 계속하고 문제점 메소드 또는 문제점 유형을 사용하여 클래스 파일 덤프를 계속합니다. 남아 있는 오류가 있는 경우에도 애플리케이션을 실행할 수 있도록 하려는 경우에만 권장합니다.
":Fatal"을 사용하면 모든 선택적 오류가 심각한 것으로 처리되어 오류가 런타임에 도달하는 경우 코드가 중단됩니다. ":Fatal"을 사용하지 않으면 선택적 오류가 적절한 코드 생성을 방해하지 않아 생성된 .class 파일을 실행하는 데 문제점이 발생하지 않습니다.
-verbose 이 옵션을 지정하면 액세스된/처리된 컴파일 단위를 콘솔 또는 로그 파일에 인쇄합니다.
-referenceInfo 연산 참조 정보. 빌더에 연결된 경우에만 유용합니다. 그렇지 않은 경우 참조 정보는 쓸모가 없습니다.
-progress 진행 표시(-log 모드에서만).
-time 속도 정보 표시.
-noExit 컴파일 종료 시 System.exit(n)을 호출하지 않음(오류가 없는 경우 n=0).
-repeat <n> 컴파일 프로세스를 <n>번 반복(성능 분석).
-inlineJSR 인라인 JSR 바이트 코드(대상 >= 1.5인 경우 암시적).
-enableJavadoc javadoc 내 참조 고려.
-missingNullDefault 어노테이션 기반 널 분석을 사용하는 경우(위의 "nullAnnot" 사용) 패키지 또는 유형에 기본 어노테이션이 없을 때마다 이 옵션은 경고를 발행합니다.
도움말 옵션
-? -help 도움말 메시지를 표시합니다.
-v -version 컴파일러의 빌드 번호를 표시합니다. 버그를 보고하는 경우에 아주 유용합니다.
-showversion 컴파일러의 빌드 번호를 표시하고 계속합니다. 버그를 보고하는 경우에 아주 유용합니다.

예제

d:\temp -classpath rt.jar -time -g -d d:/tmp d:\temp 및 서브폴더의 모든 소스 파일을 컴파일합니다. 클래스 경로는 단지 rt.jar입니다. 모든 디버그 속성을 생성하며 생성된 모든 .class 파일은 d:\tmp에 덤프됩니다. 일괄처리 프로세스가 완료되면 컴파일러의 속도가 표시됩니다.
d:\temp\Test.java -classpath d:\temp;rt.jar -g:none Test.java만 컴파일하고 종속 파일이 있는 경우 d:\temp에서 종속 파일을 검색합니다. 클래스 경로는 rt.jar가 수행된 d:\temp입니다. 이는 d:\temp에서 먼저 모든 필수 클래스를 검색한 후 rt.jar에서 검색함을 의미합니다. 디버그 속성을 생성하지 않으며, 생성된 모든 .class 파일은 d:\temp에 덤프됩니다.