규칙
- <ph type="x-smartling-placeholder"></ph> java_binary
- <ph type="x-smartling-placeholder"></ph> java_import
- <ph type="x-smartling-placeholder"></ph> java_library
- <ph type="x-smartling-placeholder"></ph> java_lite_proto_library
- <ph type="x-smartling-placeholder"></ph> java_proto_library
- <ph type="x-smartling-placeholder"></ph> java_test
- <ph type="x-smartling-placeholder"></ph> java_package_configuration
- <ph type="x-smartling-placeholder"></ph> java_plugin
- <ph type="x-smartling-placeholder"></ph> java_runtime
- <ph type="x-smartling-placeholder"></ph> java_toolchain
java_binary
<ph type="x-smartling-placeholder"></ph> 규칙 소스 보기java_binary(name, deps, srcs, data, resources, args, classpath_resources, compatible_with, create_executable, deploy_env, deploy_manifest_lines, deprecation, distribs, env, exec_compatible_with, exec_properties, features, javacopts, jvm_flags, launcher, licenses, main_class, output_licenses, plugins, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, stamp, tags, target_compatible_with, testonly, toolchains, use_launcher, use_testrunner, visibility)
Java 보관 파일('jar 파일')과 규칙과 동일한 이름의 래퍼 셸 스크립트를 빌드합니다.
래퍼 셸 스크립트는 무엇보다도 각 포드에 대한 jar 파일을 포함하는 클래스 경로를 사용합니다.
바이너리가 종속된 라이브러리를 사용합니다 래퍼 셸 스크립트를 실행할 때 비어 있지 않은 모든 코드는
JAVABIN
환경 변수가 다음을 통해 지정된 버전보다 우선합니다.
Bazel의 --java_runtime_version
플래그
래퍼 스크립트는 여러 고유한 플래그를 허용합니다. 다음을 참고하세요.
//src/main/java/com/google/devtools/build/lib/bazel/rules/java/java_stub_template.txt
를 참조하세요.
암시적 출력 타겟
name.jar
: 클래스 파일 및 기타 항목이 포함된 Java 보관 파일 리소스를 배포합니다name-src.jar
: 소스('소스')가 포함된 보관 파일 jar')를 입력합니다.name_deploy.jar
: 배포에 적합한 Java 보관 파일 (단, 명시적으로 요청될 경우 빌드됩니다.규칙에 맞는
<name>_deploy.jar
대상 빌드 는java -jar
명령어 또는 래퍼 스크립트의--singlejar
사용 옵션을 선택합니다. 래퍼 스크립트를 사용하는 것이java -jar
보다 선호되는 이유는 다음과 같습니다. 또한 JVM 플래그 및 네이티브 라이브러리를 로드합니다.배포 jar에는 클래스 로더가 찾을 수 있는 모든 클래스가 포함되어 있습니다. 바이너리의 래퍼 스크립트에서 클래스 경로를 처음부터 끝까지 검색했습니다. 또한 종속 항목에 필요한 네이티브 라이브러리가 포함되어 있습니다. 이러한 항목은 자동으로 로드되고 런타임 시 JVM에 접근할 수 있습니다
타겟에서 런처를 지정하는 경우 속성을 사용하면 일반 JAR 파일이 아니라 _deploy.jar가 네이티브 바이너리입니다. 여기에는 런처와 모두 정적 바이너리로 연결되어 있습니다. 실제 jar 파일의 바이트는 해당 네이티브 바이너리에 추가되어, Java 코드 및 실행 파일이 있습니다. 생성된 jar 파일을 직접 실행할 수 있습니다. 네이티브 바이너리를 실행하는 것처럼 말입니다.
name_deploy-src.jar
: 소스가 포함된 보관 파일 타겟의 임시 폐쇄로부터 수집된 데이터 이러한 항목은 jar에 일치하는 소스 jar가 없는 경우를 제외하고deploy.jar
입니다.
deps
속성은 다음 항목이 없는 java_binary
규칙에서 허용되지 않습니다.
srcs
이러한 규칙은
main_class
제공:
runtime_deps
를 탭합니다.
다음 코드 스니펫은 일반적인 실수를 보여줍니다.
java_binary( name = "DontDoThis", srcs = [ ...,"GeneratedJavaFile.java"
, # a generated .java file ], deps = [":generating_rule",
], # rule that generates that file )
대신 다음 단계를 따르세요.
java_binary( name = "DoThisInstead", srcs = [ ..., ":generating_rule", ], )
인수
속성 | |
---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. 파일의 기본 진입점인 소스 파일의 이름을 애플리케이션 (확장자 제외)을 선택합니다. 예를 들어 진입점이 Main.java 인 경우 이름은 Main 일 수 있습니다.
|
deps
|
라벨 목록 기본값은 deps 에 대한 일반적인 댓글을 확인하세요.
일반적인 속성
대부분의 빌드 규칙에 대해 자세히 알아보세요.
|
srcs
|
라벨 목록 기본값은
규칙: 규칙 (일반적으로
이 인수는
|
resources
|
라벨 목록 기본값은
리소스가 지정되면 일반적인
컴파일을 통해 생성된 리소스는 소스 파일 또는 생성된 파일일 수 있습니다. |
classpath_resources
|
라벨 목록 기본값은
자바 트리의 루트에 있어야 하는 리소스 목록입니다. 이 속성의
유일한 목적은 리소스가 필요한 서드 파티 라이브러리를 지원하는 것입니다.
클래스 경로에서 정확히 |
create_executable
|
부울; 구성 불가 기본값은 java_single_jar 을 사용하세요.
|
deploy_env
|
라벨 목록 기본값은 java_binary 대상 목록
이 바이너리를 위한 환경입니다
다른 개발자가 로드할 플러그인을 빌드할 때 이 속성을 설정합니다.
java_binary 이 속성을 설정하면 이 바이너리에서 공유하는 런타임 클래스 경로 (및 jar 배포)를 바이너리 및 deploy_env 에 지정된 타겟.
|
deploy_manifest_lines
|
문자열 목록 기본값은 META-INF/manifest.mf 파일에 추가할 행 목록입니다.
*_deploy.jar 타겟. 이 속성의 내용은 주제가 아닙니다.
"Makevariable"로 대체되었습니다.
|
javacopts
|
문자열 목록 기본값은 이러한 컴파일러 옵션은 전역 컴파일러 옵션 다음에 javac로 전달됩니다. |
jvm_flags
|
문자열 목록 기본값은 Java 바이너리의 래퍼 스크립트에 CLASSPATH 정의가 포함됨
(종속된 모든 jar를 찾기 위해) 올바른 Java 인터프리터를 호출합니다.
래퍼 스크립트에 의해 생성된 명령줄에는
기본 클래스 다음에 이 속성은 |
launcher
|
라벨 기본값은 bin/java 프로그램이 JDK에 포함되어 있습니다.
타겟은 cc_binary 이어야 합니다. 다음과 같은 모든 cc_binary
는
<ph type="x-smartling-placeholder"></ph>
Java Invocation API를 이 속성의 값으로 지정할 수 있습니다.
기본적으로 Bazel은 일반 JDK 런처 (bin/java 또는 java.exe)를 사용합니다. 관련 네이티브 (C++, SWIG, JNI) 종속 항목은 다르게 빌드됩니다. JDK 런처를 사용하는지 다른 런처를 사용하는지에 따라 다음 명령어를 실행합니다.
기본 JDK 런처 이외의 런처를 사용하는 경우
|
main_class
|
String; 기본값은 main() 메서드가 있는 클래스 이름입니다.
규칙에서 이 옵션을 사용하는 경우에는 srcs=[...] 목록이 필요하지 않습니다.
따라서 이 특성을 사용하면 이미 실행 중인 Java 라이브러리로부터
하나 이상의 main() 메서드를 포함합니다.
이 속성의 값은 소스 파일이 아니라 클래스 이름입니다. 클래스는
런타임 시 사용 가능: |
plugins
|
라벨 목록 기본값은 java_plugin 이(가) 실행됩니다.
빌드됩니다 라이브러리는 또한 종속 항목으로부터 플러그인을 상속할 수 있습니다.
exported_plugins 리소스
이 규칙의 결과 jar에 포함됩니다.
|
resource_jars
|
라벨 목록 기본값은 |
resource_strip_prefix
|
String; 기본값은
지정된 경우 이 경로 접두어는 |
runtime_deps
|
라벨 목록 기본값은 deps 와 마찬가지로 런타임 클래스 경로에 표시되지만
컴파일 시간 클래스 경로가 아닌 이들을 사용합니다. 런타임에만 필요한 종속 항목은
확인하시기 바랍니다. 종속 항목 분석 툴은
runtime_deps 및 deps
|
stamp
|
정수; 기본값은
스탬프 처리된 바이너리는 종속 항목이 변경되지 않는 한 다시 빌드되지 않습니다. |
use_launcher
|
부울; 기본값은 이 속성을 false로 설정하면
launcher 속성 및 관련
|
use_testrunner
|
부울; 기본값은 com.google.testing.junit.runner.BazelTestRunner ) 클래스를
기본 진입점을 만들고 테스트 클래스를 제공합니다.
bazel.test_suite 값으로 테스트 실행기에 추가
system 속성입니다.
이를 사용하여 기본
테스트 실행기를 사용하여
규칙 java_test 개,
java_binary 규칙에는 사용하지 않습니다. 가능성 낮음
이렇게 하는 것이 좋습니다 1회용: AllTest
다른 규칙에서 호출하는 규칙 (데이터베이스를 설정하기 위해)
테스트 실행 전)가 있는지 확인합니다. AllTest
규칙을 java_binary 로 선언해야 하지만
여전히 테스트 실행기를 주 진입점으로 사용합니다.
테스트 실행기 클래스의 이름은 main_class 속성으로 재정의할 수 있습니다.
|
java_import
<ph type="x-smartling-placeholder"></ph> 규칙 소스 보기java_import(name, deps, data, compatible_with, constraints, deprecation, distribs, exec_compatible_with, exec_properties, exports, features, jars, licenses, neverlink, proguard_specs, restricted_to, runtime_deps, srcjar, tags, target_compatible_with, testonly, visibility)
이 규칙을 사용하면 사전 컴파일된 .jar
파일을 다음과 같이 사용할 수 있습니다.
java_library
및
규칙 java_binary
개
예
java_import( name = "maven_model", jars = [ "maven_model/maven-aether-provider-3.2.3.jar", "maven_model/maven-model-3.2.3.jar", "maven_model/maven-model-builder-3.2.3.jar", ], )
인수
속성 | |
---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. |
deps
|
라벨 목록 기본값은 |
constraints
|
문자열 목록 구성 불가 기본값은 |
exports
|
라벨 목록 기본값은 |
jars
|
라벨 목록 필수 이 타겟에 종속되는 Java 타겟에 제공된 JAR 파일 목록입니다. |
neverlink
|
부울; 기본값은 tools.jar 에서 실행 중인 모든 앱의 경우
사용할 수 있습니다
|
proguard_specs
|
라벨 목록 기본값은 android_binary 타겟에 추가됩니다.
여기에 포함된 파일에는 멱등적 규칙, 즉 -dontnote, -dontwarn,
-keep으로 시작하는 규칙을 가정합니다. 다른 옵션은
android_binary 의 proguard_specs를 사용하여 자동 논리가 아닌 병합을 보장해야 합니다.
|
runtime_deps
|
라벨 목록 기본값은 |
srcjar
|
라벨 기본값은 |
java_library
<ph type="x-smartling-placeholder"></ph> 규칙 소스 보기java_library(name, deps, srcs, data, resources, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, exported_plugins, exports, features, javacopts, licenses, neverlink, plugins, proguard_specs, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, tags, target_compatible_with, testonly, visibility)
이 규칙은 소스를 .jar
파일로 컴파일하고 연결합니다.
암시적 출력 타겟
libname.jar
: 클래스 파일이 포함된 Java 보관 파일libname-src.jar
: 소스('소스')가 포함된 보관 파일 jar')를 입력합니다.
인수
속성 | |
---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. |
deps
|
라벨 목록 기본값은 deps 에 대한 일반적인 댓글을 확인하세요.
일반적인 속성
대부분의 빌드 규칙에 대해 자세히 알아보세요.
반대로 |
srcs
|
라벨 목록 기본값은
규칙: 규칙 (일반적으로
이 인수는
|
data
|
라벨 목록 기본값은 data 에 대한 일반적인 댓글을 확인하세요.
일반적인 속성
대부분의 빌드 규칙에 대해 자세히 알아보세요.
|
resources
|
라벨 목록 기본값은
리소스가 지정되면 일반적인
컴파일을 통해 생성된 리소스는 소스 파일 또는 생성된 파일일 수 있습니다. |
exported_plugins
|
라벨 목록 기본값은 java_plugin 목록 (예: 주석)
프로세서)가 포함되어 있습니다.
지정된 |
exports
|
라벨 목록 기본값은
여기에 규칙을 나열하면 상위 규칙에서 이를 명시적으로 사용할 수 있게 됩니다.
이 규칙에 따라 처리했습니다. 하지만 내보내지 않은 일반
요약: 종속 항목이 있는 경우 규칙 X가 Y의 코드에 액세스할 수 있습니다.
A는 B에 종속되고 B는 C에 종속된다고 가정합니다. 이 경우에는
C는 A의 전이적 종속 항목이므로 C의 소스를 변경하고 A를 다시 빌드하면
모든 것을 올바르게 다시 빌드합니다. 그러나 A는 C의 클래스를 사용할 수 없습니다. 허용
즉, A가 내보낸 라이브러리의 클로저는 모든 직접 상위 규칙에서 사용할 수 있습니다. 천천히 다른 예: A는 B에 종속되고 B는 C와 D에 종속되며 C도 내보내지만 D는 내보내지 않습니다. 이제 A는 C에는 액세스할 수 있지만 D에는 액세스할 수 없습니다. 이제 C와 D가 일부 라이브러리를 내보내면 C'는 및 D' 각각 A는 C'에만 액세스할 수 있고 D'는 제외하세요.
중요: 내보낸 규칙은 일반적인 종속 항목이 아닙니다. 이전 예를 계속 살펴보면,
B가 C를 내보내고 C도 사용하려는 경우 자체
|
javacopts
|
문자열 목록 기본값은 이러한 컴파일러 옵션은 전역 컴파일러 옵션 다음에 javac로 전달됩니다. |
neverlink
|
부울; 기본값은 tools.jar 를 예로 들 수 있습니다.
표준 JDK에서 실행됩니다.
런타임 라이브러리가 컴파일 라이브러리와 다른 경우 런타임 라이브러리가 컴파일되도록 해야 합니다. JLS가 컴파일러를 인라인으로 금지하는 위치에서만 다르고 JLS의 모든 향후 버전)에 적용됩니다. |
plugins
|
라벨 목록 기본값은 java_plugin 이(가) 실행됩니다.
빌드됩니다 라이브러리는 또한 종속 항목으로부터 플러그인을 상속할 수 있습니다.
exported_plugins 리소스
이 규칙의 결과 jar에 포함됩니다.
|
proguard_specs
|
라벨 목록 기본값은 android_binary 타겟에 추가됩니다.
여기에 포함된 파일에는 멱등적 규칙, 즉 -dontnote, -dontwarn,
-keep으로 시작하는 규칙을 가정합니다. 다른 옵션은
android_binary 의 proguard_specs를 사용하여 자동 논리가 아닌 병합을 보장해야 합니다.
|
resource_jars
|
라벨 목록 기본값은 |
resource_strip_prefix
|
String; 기본값은
지정된 경우 이 경로 접두어는 |
runtime_deps
|
라벨 목록 기본값은 deps 와 마찬가지로 런타임 클래스 경로에 표시되지만
컴파일 시간 클래스 경로가 아닌 이들을 사용합니다. 런타임에만 필요한 종속 항목은
확인하시기 바랍니다. 종속 항목 분석 툴은
runtime_deps 및 deps
|
java_lite_proto_library
<ph type="x-smartling-placeholder"></ph> 규칙 소스 보기java_lite_proto_library(name, deps, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
java_lite_proto_library
는 .proto
파일에서 Java 코드를 생성합니다.
deps
은(는) proto_library
규칙을 가리켜야 합니다.
예:
java_library( name = "lib", deps = [":foo"], ) java_lite_proto_library( name = "foo", deps = [":bar"], ) proto_library( name = "bar", )
인수
속성 | |
---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. |
deps
|
라벨 목록 기본값은 proto_library 목록
코드를 생성할 수 있습니다.
|
java_proto_library
<ph type="x-smartling-placeholder"></ph> 규칙 소스 보기java_proto_library(name, deps, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)
java_proto_library
는 .proto
파일에서 Java 코드를 생성합니다.
deps
은(는) proto_library
규칙을 가리켜야 합니다.
예:
java_library( name = "lib", deps = [":foo_java_proto"], ) java_proto_library( name = "foo_java_proto", deps = [":foo_proto"], ) proto_library( name = "foo_proto", )
인수
속성 | |
---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. |
deps
|
라벨 목록 기본값은 proto_library 목록
코드를 생성할 수 있습니다.
|
java_test
<ph type="x-smartling-placeholder"></ph> 규칙 소스 보기java_test(name, deps, srcs, data, resources, args, classpath_resources, compatible_with, create_executable, deploy_manifest_lines, deprecation, distribs, env, env_inherit, exec_compatible_with, exec_properties, features, flaky, javacopts, jvm_flags, launcher, licenses, local, main_class, plugins, resource_jars, resource_strip_prefix, restricted_to, runtime_deps, shard_count, size, stamp, tags, target_compatible_with, test_class, testonly, timeout, toolchains, use_launcher, use_testrunner, visibility)
java_test()
규칙은 자바 테스트를 컴파일합니다. 테스트는 애플리케이션의
테스트할 수 있습니다 컴파일되는 메인 클래스 대신 테스트 실행기의 기본 메서드가 호출됩니다.
암시적 출력 타겟
name.jar
: Java 보관 파일입니다.name_deploy.jar
: 적합한 Java 보관 파일 kube-APIserver입니다 (명시적으로 요청된 경우에만 빌드됩니다.) 자세한 내용은 다음의name_deploy.jar
출력 java_binary를 참조하세요.
java_binary() 인수에 대한 섹션을 참조하세요. 이 규칙 또한 공통적인 속성을 모두 지원합니다. 모든 테스트 규칙 (*_test)에 적용됩니다.
예
java_library( name = "tests", srcs = glob(["*.java"]), deps = [ "//java/com/foo/base:testResources", "//java/com/foo/testing/util", ], ) java_test( name = "AllTests", size = "small", runtime_deps = [ ":tests", "//util/mysql", ], )
인수
속성 | |
---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. |
deps
|
라벨 목록 기본값은 deps 에 대한 일반적인 댓글을 확인하세요.
일반적인 속성
대부분의 빌드 규칙에 대해 자세히 알아보세요.
|
srcs
|
라벨 목록 기본값은
규칙: 규칙 (일반적으로
이 인수는
|
resources
|
라벨 목록 기본값은
리소스가 지정되면 일반적인
컴파일을 통해 생성된 리소스는 소스 파일 또는 생성된 파일일 수 있습니다. |
classpath_resources
|
라벨 목록 기본값은
자바 트리의 루트에 있어야 하는 리소스 목록입니다. 이 속성의
유일한 목적은 리소스가 필요한 서드 파티 라이브러리를 지원하는 것입니다.
클래스 경로에서 정확히 |
create_executable
|
부울; 구성 불가 기본값은 java_single_jar 을 사용하세요.
|
deploy_manifest_lines
|
문자열 목록 기본값은 META-INF/manifest.mf 파일에 추가할 행 목록입니다.
*_deploy.jar 타겟. 이 속성의 내용은 주제가 아닙니다.
"Makevariable"로 대체되었습니다.
|
javacopts
|
문자열 목록 기본값은 이러한 컴파일러 옵션은 전역 컴파일러 옵션 다음에 javac로 전달됩니다. |
jvm_flags
|
문자열 목록 기본값은 Java 바이너리의 래퍼 스크립트에 CLASSPATH 정의가 포함됨
(종속된 모든 jar를 찾기 위해) 올바른 Java 인터프리터를 호출합니다.
래퍼 스크립트에 의해 생성된 명령줄에는
기본 클래스 다음에 이 속성은 |
launcher
|
라벨 기본값은 bin/java 프로그램이 JDK에 포함되어 있습니다.
타겟은 cc_binary 이어야 합니다. 다음과 같은 모든 cc_binary
는
<ph type="x-smartling-placeholder"></ph>
Java Invocation API를 이 속성의 값으로 지정할 수 있습니다.
기본적으로 Bazel은 일반 JDK 런처 (bin/java 또는 java.exe)를 사용합니다. 관련 네이티브 (C++, SWIG, JNI) 종속 항목은 다르게 빌드됩니다. JDK 런처를 사용하는지 다른 런처를 사용하는지에 따라 다음 명령어를 실행합니다.
기본 JDK 런처 이외의 런처를 사용하는 경우
|
main_class
|
String; 기본값은 main() 메서드가 있는 클래스 이름입니다.
규칙에서 이 옵션을 사용하는 경우에는 srcs=[...] 목록이 필요하지 않습니다.
따라서 이 특성을 사용하면 이미 실행 중인 Java 라이브러리로부터
하나 이상의 main() 메서드를 포함합니다.
이 속성의 값은 소스 파일이 아니라 클래스 이름입니다. 클래스는
런타임 시 사용 가능: |
plugins
|
라벨 목록 기본값은 java_plugin 이(가) 실행됩니다.
빌드됩니다 라이브러리는 또한 종속 항목으로부터 플러그인을 상속할 수 있습니다.
exported_plugins 리소스
이 규칙의 결과 jar에 포함됩니다.
|
resource_jars
|
라벨 목록 기본값은 |
resource_strip_prefix
|
String; 기본값은
지정된 경우 이 경로 접두어는 |
runtime_deps
|
라벨 목록 기본값은 deps 와 마찬가지로 런타임 클래스 경로에 표시되지만
컴파일 시간 클래스 경로가 아닌 이들을 사용합니다. 런타임에만 필요한 종속 항목은
확인하시기 바랍니다. 종속 항목 분석 툴은
runtime_deps 및 deps
|
stamp
|
정수; 기본값은
스탬프 처리된 바이너리는 종속 항목이 변경되지 않는 한 다시 빌드되지 않습니다. |
test_class
|
String; 기본값은
기본적으로 이 인수가 정의되지 않으면 레거시 모드가 사용되고
테스트 인수가 대신 사용됩니다.
이 속성은 실행할 Java 클래스의 이름을 지정합니다.
확인할 수 있습니다 이 설정은 매우 드뭅니다. 이 인수를 생략하면
대상의
JUnit3의 경우 테스트 클래스는 다음 서브클래스 중 하나여야 합니다.
이 속성을 사용하면 여러 |
use_launcher
|
부울; 기본값은 이 속성을 false로 설정하면
launcher 속성 및 관련
|
use_testrunner
|
부울; 기본값은 com.google.testing.junit.runner.BazelTestRunner ) 클래스를
기본 진입점을 만들고 테스트 클래스를 제공합니다.
bazel.test_suite 값으로 테스트 실행기에 추가
system 속성입니다.
이를 사용하여 기본
테스트 실행기를 사용하여
규칙 java_test 개,
java_binary 규칙에는 사용하지 않습니다. 가능성 낮음
이렇게 하는 것이 좋습니다 1회용: AllTest
다른 규칙에서 호출하는 규칙 (데이터베이스를 설정하기 위해)
테스트 실행 전)가 있는지 확인합니다. AllTest
규칙을 java_binary 로 선언해야 하지만
여전히 테스트 실행기를 주 진입점으로 사용합니다.
테스트 실행기 클래스의 이름은 main_class 속성으로 재정의할 수 있습니다.
|
java_package_configuration
<ph type="x-smartling-placeholder"></ph> 규칙 소스 보기java_package_configuration(name, data, compatible_with, deprecation, distribs, features, javacopts, licenses, packages, restricted_to, tags, target_compatible_with, testonly, visibility)
패키지 집합에 적용할 구성입니다.
구성을 추가할 수 있는
java_toolchain.javacopts
예:
java_package_configuration( name = "my_configuration", packages = [":my_packages"], javacopts = ["-Werror"], ) package_group( name = "my_packages", packages = [ "//com/my/project/...", "-//com/my/project/testing/...", ], ) java_toolchain( ..., package_configuration = [ ":my_configuration", ] )
인수
속성 | |
---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. |
data
|
라벨 목록 기본값은 |
javacopts
|
문자열 목록 기본값은 |
packages
|
라벨 목록 기본값은 package_group 집합
구성을 적용해야 합니다
|
java_plugin
<ph type="x-smartling-placeholder"></ph> 규칙 소스 보기java_plugin(name, deps, srcs, data, resources, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, generates_api, javacopts, licenses, neverlink, output_licenses, plugins, processor_class, proguard_specs, resource_jars, resource_strip_prefix, restricted_to, tags, target_compatible_with, testonly, visibility)
java_plugin
은 Bazel에서 실행하는 Java 컴파일러용 플러그인을 정의합니다. 현재
지원되는 종류의 플러그인만 주석 프로세서입니다. java_library
또는
java_binary
규칙은 plugins
를 통해 플러그인을 실행하여 플러그인을 실행할 수 있습니다.
속성의 값을 제공합니다. java_library
는 또한 다음과 같은 라이브러리로 플러그인을 자동으로 내보낼 수 있습니다.
이를 사용하여
exported_plugins
입니다.
암시적 출력 타겟
libname.jar
: Java 보관 파일입니다.
인수는 다음을 제외하면 java_library
와 동일합니다.
(processor_class
인수의 추가를 위해)
인수
속성 | |
---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. |
deps
|
라벨 목록 기본값은 deps 에 대한 일반적인 댓글을 확인하세요.
일반적인 속성
대부분의 빌드 규칙에 대해 자세히 알아보세요.
반대로 |
srcs
|
라벨 목록 기본값은
규칙: 규칙 (일반적으로
이 인수는
|
data
|
라벨 목록 기본값은 data 에 대한 일반적인 댓글을 확인하세요.
일반적인 속성
대부분의 빌드 규칙에 대해 자세히 알아보세요.
|
resources
|
라벨 목록 기본값은
리소스가 지정되면 일반적인
컴파일을 통해 생성된 리소스는 소스 파일 또는 생성된 파일일 수 있습니다. |
generates_api
|
부울; 기본값은 규칙이 API 생성 주석 프로세서를 사용하는 경우 다른 규칙은 생성된 코드를 참조하기 위해서는 컴파일 작업은 규칙을 생성한 후에 예약됩니다. 이 속성은 Bazel이 스케줄링 제약 조건을 적용할 때 --java_header_compile이 사용 설정됩니다. 경고: 이 속성은 빌드에 영향을 미칩니다. 필요한 경우에만 사용하세요 |
javacopts
|
문자열 목록 기본값은 이러한 컴파일러 옵션은 전역 컴파일러 옵션 다음에 javac로 전달됩니다. |
neverlink
|
부울; 기본값은 tools.jar 를 예로 들 수 있습니다.
표준 JDK에서 실행됩니다.
런타임 라이브러리가 컴파일 라이브러리와 다른 경우 런타임 라이브러리가 컴파일되도록 해야 합니다. JLS가 컴파일러를 인라인으로 금지하는 위치에서만 다르고 JLS의 모든 향후 버전)에 적용됩니다. |
output_licenses
|
라이선스 유형 기본값은 common attributes
참조
|
plugins
|
라벨 목록 기본값은 java_plugin 이(가) 실행됩니다.
빌드됩니다 라이브러리는 또한 종속 항목으로부터 플러그인을 상속할 수 있습니다.
exported_plugins 리소스
이 규칙의 결과 jar에 포함됩니다.
|
processor_class
|
String; 기본값은 |
proguard_specs
|
라벨 목록 기본값은 android_binary 타겟에 추가됩니다.
여기에 포함된 파일에는 멱등적 규칙, 즉 -dontnote, -dontwarn,
-keep으로 시작하는 규칙을 가정합니다. 다른 옵션은
android_binary 의 proguard_specs를 사용하여 자동 논리가 아닌 병합을 보장해야 합니다.
|
resource_jars
|
라벨 목록 기본값은 |
resource_strip_prefix
|
String; 기본값은
지정된 경우 이 경로 접두어는 |
java_runtime
<ph type="x-smartling-placeholder"></ph> 규칙 소스 보기java_runtime(name, srcs, compatible_with, default_cds, deprecation, distribs, features, hermetic_srcs, java, java_home, lib_ct_sym, lib_modules, licenses, restricted_to, tags, target_compatible_with, testonly, version, visibility)
Java 런타임의 구성을 지정합니다.
예:
java_runtime( name = "jdk-9-ea+153", srcs = glob(["jdk9-ea+153/**"]), java_home = "jdk9-ea+153", )
인수
속성 | |
---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. |
srcs
|
라벨 목록 기본값은 |
default_cds
|
라벨 기본값은 java_runtime 의 기본 CDS 보관 파일입니다. 밀폐 시
타겟이 java_binary 타겟에 사용 설정되어 있고 타겟이
자체 CDS 보관 파일을 제공하도록
classlist 속성
java_runtime 기본 CDS는 밀폐 배포 JAR에 패키징됩니다.
|
hermetic_srcs
|
라벨 목록 기본값은 |
java
|
라벨 기본값은 |
java_home
|
String; 기본값은 srcs 속성과 java 속성이 비어 있어야 합니다.
|
lib_ct_sym
|
라벨 기본값은 --release 로 컴파일하는 데 필요한 lib/ct.sym 파일 지정하지 않고
srcs 에 경로가
/lib/ct.sym 파일을 사용하면 해당 파일이 사용됩니다.
|
lib_modules
|
라벨 기본값은 |
version
|
정수; 기본값은 Runtime.version().feature()
|
java_toolchain
<ph type="x-smartling-placeholder"></ph> 규칙 소스 보기java_toolchain(name, android_lint_data, android_lint_jvm_opts, android_lint_opts, android_lint_package_configuration, android_lint_runner, bootclasspath, compatible_with, deprecation, deps_checker, distribs, features, forcibly_disable_header_compilation, genclass, header_compiler, header_compiler_direct, ijar, jacocorunner, java_runtime, javabuilder, javabuilder_data, javabuilder_jvm_opts, javac_supports_multiplex_workers, javac_supports_worker_multiplex_sandboxing, javac_supports_workers, javacopts, jvm_opts, licenses, oneversion, oneversion_allowlist_for_tests, oneversion_whitelist, package_configuration, proguard_allowlister, resourcejar, restricted_to, singlejar, source_version, tags, target_compatible_with, target_version, testonly, timezone_data, tools, turbine_data, turbine_jvm_opts, visibility, xlint)
Java 컴파일러의 구성을 지정합니다. 사용할 도구 모음은 --java_툴체인 인수 일반적으로 이러한 종류의 규칙은 Java 컴파일러를 조정해야 합니다
예
간단한 예는 다음과 같습니다.
java_toolchain( name = "toolchain", source_version = "7", target_version = "7", bootclasspath = ["//tools/jdk:bootclasspath"], xlint = [ "classfile", "divzero", "empty", "options", "path" ], javacopts = [ "-g" ], javabuilder = ":JavaBuilder_deploy.jar", )
인수
속성 | |
---|---|
name |
이름 필수 이 대상의 고유한 이름입니다. |
android_lint_data
|
라벨 목록 기본값은 |
android_lint_jvm_opts
|
문자열 목록 기본값은 |
android_lint_opts
|
문자열 목록 기본값은 |
android_lint_package_configuration
|
라벨 목록 기본값은 |
android_lint_runner
|
라벨 기본값은 |
bootclasspath
|
라벨 목록 기본값은 |
deps_checker
|
라벨 목록 기본값은 |
forcibly_disable_header_compilation
|
부울; 기본값은 |
genclass
|
라벨 목록 필수 GenClass 배포 jar의 라벨입니다. |
header_compiler
|
라벨 목록 기본값은 |
header_compiler_direct
|
라벨 목록 기본값은 이 도구는 주석 처리를 지원하지 않습니다. |
ijar
|
라벨 목록 필수 ijar 실행 파일의 라벨. |
jacocorunner
|
라벨 기본값은 |
java_runtime
|
라벨 필수 이 도구 모음과 함께 사용할 java_runtime입니다. 기본값은 java_runtime입니다. 실행할 수도 있습니다 |
javabuilder
|
라벨 목록 필수 JavaBuilder 배포 jar의 라벨입니다. |
javabuilder_data
|
라벨 목록 기본값은 |
javabuilder_jvm_opts
|
문자열 목록 기본값은 |
javac_supports_multiplex_workers
|
부울; 기본값은 |
javac_supports_worker_multiplex_sandboxing
|
부울; 기본값은 |
javac_supports_workers
|
부울; 기본값은 |
javacopts
|
문자열 목록 기본값은 |
jvm_opts
|
문자열 목록 기본값은 |
oneversion
|
라벨 기본값은 |
oneversion_allowlist_for_tests
|
라벨 기본값은 |
oneversion_whitelist
|
라벨 기본값은 |
package_configuration
|
라벨 목록 기본값은 |
proguard_allowlister
|
라벨 기본값은 |
resourcejar
|
라벨 목록 기본값은 |
singlejar
|
라벨 목록 필수 SingleJar 배포 jar의 라벨입니다. |
source_version
|
String; 기본값은 |
target_version
|
String; 기본값은 |
timezone_data
|
라벨 기본값은 |
tools
|
라벨 목록 기본값은 |
turbine_data
|
라벨 목록 기본값은 |
turbine_jvm_opts
|
문자열 목록 기본값은 |
xlint
|
문자열 목록 기본값은 |