java_common

Starlark'ta Java derleme desteği için yardımcı programlar.

Üyeler

BootClassPathInfo

Provider java_common.BootClassPathInfo

Bootclasspath bilgilerini sağlamak için kullanılan sağlayıcı

compile

JavaInfo 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, host_javabase=None, sourcepath=[], resources=[], resource_jars=[], classpath_resources=[], neverlink=False, enable_annotation_processing=True, enable_compile_jar_action=True, add_exports=[], add_opens=[])

Bir Starlark kuralının uygulamasından Java kaynak dosyalarını/jar'larını derler, derlemenin sonuçlarını temsil eden bir sağlayıcı döndürür ve bu kuralın yayınladığı sağlayıcı grubuna eklenebilir.

Parametreler

Parametre Açıklama
ctx gerekli
Kural bağlamı.
source_jars sequence of Files; default = []
Derlenecek jar'ların listesi. source_jars veya source_files öğelerinden en az biri belirtilmelidir.
source_files sequence of Files; default = []
Derlenecek Java kaynak dosyalarının listesi. source_jars veya source_files öğelerinden en az biri belirtilmelidir.
output zorunlu
output_source_jar File; or None; default = None
Çıkış kaynağı jar. İsteğe bağlı. Ayarlanmazsa varsayılan olarak "{output_jar}-src.jar" olur.
javac_opts sequence of strings; default = []
İstenen javac seçeneklerinin listesi. İsteğe bağlı.
deps sequence of JavaInfos; default = []
Bağımlılıkların listesi. İsteğe bağlı.
runtime_deps sequence of JavaInfos; default = []
Çalışma zamanı bağımlılıklarının listesi. İsteğe bağlı.
exports sequence of JavaInfos; default = []
Dışa aktarmaların listesi. İsteğe bağlı.
plugins sequence of JavaPluginInfos; or sequence of JavaInfos; default = []
Eklenti listesi. İsteğe bağlı.
exported_plugins sequence of JavaPluginInfos; or sequence of JavaInfos; default = []
Dışa aktarılan eklentilerin listesi. İsteğe bağlı.
native_libraries sequence of CcInfos; default = []
Bu kitaplık için gereken CC yerel kitaplık bağımlılıklarını.
annotation_processor_additional_inputs sequence of Files; default = []
Ek açıklama işleme için Java kaynaklarına ek olarak Java derleme işleminin alacağı girişlerin listesi.
annotation_processor_additional_outputs sequence of Files; default = []
Ek açıklama işlemedeki class jar dosyasına ek olarak Java derleme işleminin çıkaracağı çıkışların listesi.
strict_deps default = 'ERROR'
Katı kaldırmaların nasıl ele alınacağını belirten bir dize. Olası değerler: "OFF", "ERROR", "WARN" ve "DEFAULT". Daha fazla ayrıntı için /docs/user-manual#flag--strict_java_deps adresine bakın. Varsayılan olarak "ERROR".
java_toolchain gerekli
Bu derleme için kullanılacak bir JavaToolchainInfo. Zorunlu.
host_javabase default = Yok
Kullanımdan kaldırıldı. Bu parametre artık kullanılmamaktadır ve yakında kaldırılacaktır. Lütfen bu özelliğe güvenmeyin. --+incompatible_java_common_parameters ile devre dışı bırakılır. Kodunuzun, hemen kaldırılmak üzere uygun olduğunu doğrulamak için bu işareti kullanın.
Kullanımdan kaldırıldı: Bu parametreyi bırakabilirsiniz (host_javabase, java_toolchain ile sağlanır)
sourcepath sequence of Files; varsayılan = []
resources sequence of Files; varsayılan = []
resource_jars sequence of Files; varsayılan = []
classpath_resources sequence of Files; varsayılan = []
varsayılan = Yanlış
enable_annotation_processing default = True
Bu derlemede ek açıklama işlemeyi devre dışı bırakarak eklentilerde veya deps'in Export_plugins öğesinde sağlanan ek açıklama işlemcilerinin yok sayılmasına neden olur.
enable_compile_jar_action default = True
Başlık derlemesini veya ijar oluşturmayı etkinleştirir. Yanlış değerine ayarlanırsa bağımlıların derleme sınıf yollarında tam sınıf jar dosyasının kullanılmasını zorunlu kılar. Bu, bağımlı olmayan ikili programlar gibi kitaplık dışı hedeflerin kullanılması için tasarlanmıştır.
add_exports sequence of strings; default = []
Bu kitaplığın belirtilen /öğesine erişmesine izin ver. İsteğe bağlıdır.
add_opens sequence of strings; default = []
Bu kitaplığın, belirtilen /değerine yansıtıcı olarak erişmesine izin verir. İsteğe bağlıdır.

JavaPluginInfo

Provider java_common.JavaPluginInfo

Java eklentileriyle ilgili bilgileri içeren sağlayıcıyı almak için kullanılan anahtar. Aynı değere JavaPluginInfo ile erişilebilir.
Yeni kodda JavaPluginInfo kullanmayı tercih edin.

JavaRuntimeInfo

Provider java_common.JavaRuntimeInfo

Kullanılan Java çalışma zamanıyla ilgili bilgileri içeren sağlayıcıyı almak için kullanılan anahtar.

JavaToolchainInfo

Provider java_common.JavaToolchainInfo

Kullanılan Java araç zinciriyle ilgili bilgileri içeren sağlayıcıyı almak için kullanılan anahtar.

make_non_strict

JavaInfo java_common.make_non_strict(java_info)

Doğrudan jar (jar) kısmı belirtilen Java sağlayıcısının hem doğrudan hem de dolaylı kavanozlarının birleşimi olan yeni bir Java sağlayıcısı döndürür.

Parametreler

Parametre Açıklama
java_info gerekli
Java bilgisi.

birleştirmek

JavaInfo java_common.merge(providers, *, merge_java_outputs=True, merge_source_jars=True)

Belirtilen sağlayıcıları tek bir JavaInfo'da birleştirir.

Parametreler

Parametre Açıklama
providers sequence of JavaInfos; zorunlu
Birleştirilecek sağlayıcıların listesi.
merge_java_outputs varsayılan = Doğru
merge_source_jars varsayılan = Doğru

pack_sources

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

Kaynakları ve kaynak jar'ları tek bir kaynak jar dosyasında toplar. Döndürülen değer genellikle

JavaInfo#source_jar

.Çıkış_jar veya çıktı_kaynak_jar parametrelerinden en az biri gereklidir.

Parametreler

Parametre Açıklama
actions gerekli
ctx.actions
output_jar File; or None; varsayılan = Yok
Kullanımdan kaldırıldı. Bu parametre artık kullanılmamaktadır ve yakında kaldırılacaktır. Lütfen bu özelliğe güvenmeyin. --+incompatible_java_common_parameters ile devre dışı bırakılır. Kodunuzun, hemen kaldırılmak üzere uygun olduğunu doğrulamak için bu işareti kullanın.
Kullanımdan kaldırıldı: Kuralın çıkış bölümü. Ortaya çıkan kaynak jar dosyasını adlandırmak için kullanılır. Parametre, exit_source_jar parametresini "{output_jar}-src.jar" olarak ayarlıyor.Bunun yerine doğrudan exit_source_jar parametresini kullanın.
output_source_jar File; or None; default = None
Çıkış kaynağı jar.
sources sequence of Files; default = []
Kaynak jar dosyasına paketlenecek Java kaynak dosyalarının listesi.
source_jars sequence of Files; default = []
Kaynak kavanoza paketlenecek kaynak jar'ların listesi.
java_toolchain gerekli
ijar aracını bulmak için kullanılacak bir JavaToolchainInfo.
host_javabase default = Yok
Kullanımdan kaldırıldı. Bu parametre artık kullanılmamaktadır ve yakında kaldırılacaktır. Lütfen bu özelliğe güvenmeyin. --+incompatible_java_common_parameters ile devre dışı bırakılır. Kodunuzun, hemen kaldırılmak üzere uygun olduğunu doğrulamak için bu işareti kullanın.
Kullanımdan kaldırıldı: Bu parametreyi bırakabilirsiniz (host_javabase, java_toolchain ile sağlanır)
None cihazı döndürülebilir.

sağlayıcı

Provider java_common.provider

Java bildirilen sağlayıcıyı döndürür.
Aynı değere JavaInfo ile erişilebilir.
Yeni kodda JavaInfo kullanmayı tercih edin.

run_ijar

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

Kavanozda ijar çalıştırır ve yöntem gövdelerinden çıkarır. Bu, yöntem uygulamalarında yalnızca basit değişiklikler içeren yeniden derlemeler sırasında bağımlı jar'ların yeniden oluşturulmasını azaltmaya yardımcı olur. Döndürülen değer genellikle JavaInfo#compile_jar öğesine iletilir.

Parametreler

Parametre Açıklama
actions gerekli
ctx.actions
jar gerekli
ijar'ın çalıştırılacağı jar dosyası.
target_label Label; or None; default = None
Kavanozu damgalamak için kullanılacak hedef etiket. add_dep desteği için kullanılır. Genellikle, kavanozu mevcut kuralın etiketiyle damgalamak için ctx.label değerini geçirirsiniz.
java_toolchain gerekli
ijar aracını bulmak için kullanılacak bir JavaToolchainInfo.

stamp_jar

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

Kavanozu add_dep desteği için hedef etiketiyle damgalar. Döndürülen değer genellikle JavaInfo#compile_jar öğesine iletilir. Mümkün olduğunda run_ijar kullanmayı tercih edin.

Parametreler

Parametre Açıklama
actions gerekli
ctx.actions
jar gerekli
stamp_jar'ın çalıştırılacağı jar dosyası.
target_label gerekli
Kavanozu damgalamak için kullanılacak hedef etiket. add_dep desteği için kullanılır. Genellikle, kavanozu mevcut kuralın etiketiyle damgalamak için ctx.label değerini geçirirsiniz.
java_toolchain gerekli
stamp_jar aracını bulmak için kullanılacak bir JavaToolchainInfo.

to_java_binary_info

JavaInfo java_common.to_java_binary_info(java_info)

Belirtilen JavaInfo'nun bir kopyasını, bir java_binary tarafından döndürülen minimum bilgilerle döndürür

Parametreler

Parametre Açıklama
java_info gerekli
Geliştirilecek JavaInfo.