자바_일반

Starlark의 자바 컴파일 지원용 유틸리티입니다.

구성원

BootClassPathInfo
compile
JavaRuntimeInfo
JavaToolchainInfo
병합
pack_sources
run_ijar
stamp_jar

BootClassPathInfo

Provider java_common.BootClassPathInfo

bootclasspath 정보를 제공하는 데 사용되는 제공업체입니다.

compile

struct java_common.compile(ctx, *, source_jars=[], source_files=[], output, output_source_jar=None, javac_opts=[], deps=[], runtime_deps=[], exports=[], plugins=[], exported_plugins=[], native_libraries=[], annotation_processor_additional_inputs=[], annotation_processor_additional_outputs=[], strict_deps='ERROR', java_toolchain, bootclasspath=None, host_javabase=None, sourcepath=[], resources=[], resource_jars=[], classpath_resources=[], neverlink=False, enable_annotation_processing=True, enable_compile_jar_action=True, add_exports=[], add_opens=[])

Starlark 규칙의 구현에서 자바 소스 파일/jar를 컴파일하고 컴파일 결과를 나타내는 제공자를 반환하며 이 규칙에서 내보낸 제공자 집합에 추가할 수 있습니다.

매개변수

매개변수	설명
`ctx`	필수 규칙 컨텍스트입니다.
`source_jars`	File의 시퀀스. 기본값은 `[]` 컴파일할 jar 목록입니다. source_jars 또는 source_file 중 하나 이상을 지정해야 합니다.
`source_files`	File의 시퀀스. 기본값은 `[]` 컴파일할 자바 소스 파일 목록입니다. source_jars 또는 source_file 중 하나 이상을 지정해야 합니다.
`output`	필수
`output_source_jar`	File 또는 `None`. 기본값은 `None`입니다. 출력 소스 jar입니다. 선택사항입니다. 설정하지 않을 경우 기본값은 `{output_jar}-src.jar` 입니다.
`javac_opts`	문자열의 시퀀스. 기본값은 `[]` 원하는 javac 옵션 목록입니다. 선택사항입니다.
`deps`	struct의 sequence이며 기본값은 `[]` 입니다. 종속 항목 목록입니다. 선택사항입니다.
`runtime_deps`	struct의 시퀀스. 기본값은 `[]` 런타임 종속 항목 목록입니다. 선택사항입니다.
`exports`	구조체의 시퀀스. 기본값은 `[]` 내보내기 목록입니다. 선택사항입니다.
`plugins`	구조체의 시퀀스 또는 구조체의 시퀀스. 기본값은 `[]` 플러그인 목록입니다. 선택사항입니다.
`exported_plugins`	구조체의 시퀀스 또는 구조체의 시퀀스. 기본값은 `[]` 내보낸 플러그인 목록입니다. 선택사항입니다.
`native_libraries`	CcInfo의 시퀀스. 기본값은 이 라이브러리에 필요한 `[]` CC 네이티브 라이브러리 종속 항목입니다.
`annotation_processor_additional_inputs`	File의 시퀀스. 기본값은 `[]`입니다. 주석 처리를 위해 자바 컴파일 작업이 자바 소스 외에 추가로 수행할 입력 목록입니다.
`annotation_processor_additional_outputs`	File의 시퀀스. 기본값은 `[]`입니다. 주석 처리에서 jar 클래스 외에 자바 컴파일 작업이 출력할 출력 목록입니다.
`strict_deps`	기본값은 `'ERROR'`입니다. 엄격한 deps를 처리하는 방법을 지정하는 문자열입니다. 가능한 값은 'OFF', 'ERROR', 'WARN', 'DEFAULT'입니다. 자세한 내용은 /docs/user-manual#flag--strict_java_deps를 참조하세요. 기본값은 'ERROR'입니다.
`java_toolchain`	필수입니다. 이 컴파일에 사용할 JavaToolchainInfo입니다. 필수입니다.
`bootclasspath`	기본값은 `None`입니다. 이 컴파일에 사용할 BootClassPathInfo입니다. 있는 경우 제공된 java_toolchain과 연결된 bootclasspath를 재정의합니다. 선택사항입니다.
`host_javabase`	기본값은 `None`입니다. 지원 중단됨. 이 매개변수는 지원 중단되었으며 곧 삭제됩니다. 의존하지 마세요. `--+incompatible_java_common_parameters`를 통해 사용 중지됩니다. 이 플래그를 사용하여 코드가 임박한 삭제와 호환되는지 확인합니다. 지원 중단됨: 이 매개변수를 삭제할 수 있습니다 (host_javabase는 java_toolchain와 함께 제공됨).
`sourcepath`	File의 시퀀스. 기본값은 `[]` 입니다.
`resources`	File의 시퀀스. 기본값은 `[]` 입니다.
`resource_jars`	File의 시퀀스. 기본값은 `[]` 입니다.
`classpath_resources`	File의 시퀀스. 기본값은 `[]` 입니다.
`neverlink`	기본값은 `False` 입니다.
`enable_annotation_processing`	기본값은 `True`입니다. 이 컴파일에서 주석 처리를 사용 중지하여 플러그인 또는 deps의 export_plugins에 제공된 주석 프로세서를 무시합니다.
`enable_compile_jar_action`	기본값은 `True`입니다. 헤더 컴파일 또는 ijar 생성을 사용 설정합니다. False로 설정하면 종속 항목의 컴파일 클래스 경로에서 전체 클래스 jar를 강제로 사용합니다. 이는 종속 항목이 없는 바이너리와 같은 비 라이브러리 타겟에서 사용하기 위한 것입니다.
`add_exports`	문자열의 시퀀스. 기본값은 `[]` 이 라이브러리가 지정된 /에 액세스하도록 허용합니다. 선택사항입니다.
`add_opens`	문자열의 시퀀스. 기본값은 `[]` 이 라이브러리가 지정된 /에 반영할 수 있도록 허용합니다. 선택사항입니다.

JavaRuntimeInfo

Provider java_common.JavaRuntimeInfo

사용 중인 Java 런타임에 대한 정보가 포함된 제공자를 검색하는 데 사용되는 키입니다.

JavaToolchainInfo

Provider java_common.JavaToolchainInfo

사용 중인 자바 도구 모음에 대한 정보가 포함된 제공자를 검색하는 데 사용되는 키입니다.

병합하다

struct java_common.merge(providers)

지정된 제공자를 단일 JavaInfo에 병합합니다.

매개변수

매개변수	설명
`providers`	구조체의 시퀀스. 필수 병합할 제공업체 목록입니다.

pack_sources

File java_common.pack_sources(actions, *, output_jar=None, output_source_jar=None, sources=[], source_jars=[], java_toolchain, host_javabase=None)

소스와 소스 jar를 단일 소스 jar 파일로 패키징합니다. 반환 값은 일반적으로

JavaInfo#source_jar

.output_jar 또는 output_source_jar 매개변수가 하나 이상 필요합니다.

매개변수

매개변수	설명
`actions`	필수 ctx.actions
`output_jar`	File 또는 `None`. 기본값은 `None`입니다. 지원 중단됨. 이 매개변수는 지원 중단되었으며 곧 삭제됩니다. 의존하지 마세요. `--+incompatible_java_common_parameters`를 통해 사용 중지됩니다. 이 플래그를 사용하여 코드가 임박한 삭제와 호환되는지 확인합니다. 지원 중단됨: 규칙의 출력 jar입니다. 결과 소스 jar의 이름을 지정하는 데 사용됩니다. 매개변수는 output_source_jar 매개변수를 `{output_jar}-src.jar`로 설정합니다.대신 output_source_jar 매개변수를 직접 사용합니다.
`output_source_jar`	File 또는 `None`. 기본값은 `None`입니다. 출력 소스 jar입니다.
`sources`	File의 시퀀스. 기본값은 `[]` 소스 jar에 패키징할 자바 소스 파일의 목록입니다.
`source_jars`	File의 시퀀스. 기본값은 `[]` 소스 jar에 패키징할 소스 jar의 목록입니다.
`java_toolchain`	필수 ijar 도구를 찾는 데 사용되는 JavaToolchainInfo입니다.
`host_javabase`	기본값은 `None`입니다. 지원 중단됨. 이 매개변수는 지원 중단되었으며 곧 삭제됩니다. 의존하지 마세요. `--+incompatible_java_common_parameters`를 통해 사용 중지됩니다. 이 플래그를 사용하여 코드가 임박한 삭제와 호환되는지 확인합니다. 지원 중단됨: 이 매개변수를 삭제할 수 있습니다 (host_javabase는 java_toolchain와 함께 제공됨).

run_ijar

File java_common.run_ijar(actions, *, jar, target_label=None, java_toolchain)

jar에서 ijar를 실행하고 메서드 본문에서 제거합니다. 이렇게 하면 메서드 구현의 간단한 변경사항으로만 구성된 재컴파일 중에 종속된 jar의 재빌드를 줄일 수 있습니다. 반환 값은 일반적으로 JavaInfo#compile_jar에 전달됩니다.

매개변수

매개변수	설명
`actions`	필수 ctx.actions
`jar`	필수 ijar를 실행할 jar입니다.
`target_label`	Label 또는 `None`. 기본값은 `None`입니다. jar에 스탬프를 표시할 대상 라벨입니다. `add_dep` 지원에 사용됩니다. 일반적으로 `ctx.label`를 전달하여 현재 규칙의 라벨로 jar에 스탬프를 표시합니다.
`java_toolchain`	필수 ijar 도구를 찾는 데 사용되는 JavaToolchainInfo입니다.

stamp_jar

File java_common.stamp_jar(actions, *, jar, target_label, java_toolchain)

add_dep 지원을 위해 타겟 라벨이 있는 jar에 스탬프를 표시합니다. 반환 값은 일반적으로 JavaInfo#compile_jar에 전달됩니다. 가능하면 run_ijar를 사용하는 것이 좋습니다.

매개변수

매개변수	설명
`actions`	필수 ctx.actions
`jar`	필수 switch_jar를 실행할 jar입니다.
`target_label`	필수 jar에 스탬프를 표시할 대상 라벨입니다. `add_dep` 지원에 사용됩니다. 일반적으로 `ctx.label`를 전달하여 현재 규칙의 라벨로 jar에 스탬프를 표시합니다.
`java_toolchain`	필수 switch_jar 도구를 찾는 데 사용되는 JavaToolchainInfo입니다.