java_common

Sorun bildir Kaynağı görüntüle Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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

Üyeler

BootClassPathInfo

Provider java_common.BootClassPathInfo

Açılış sınıf yolu bilgilerini sağlamak için kullanılan sağlayıcı

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=[])

Bir Starlark kuralının uygulanmasından Java kaynak dosyalarını/jar dosyalarını derleyip derlemenin sonuçlarını temsil eden ve bu kural tarafından yayınlanan sağlayıcı grubuna eklenebilen bir sağlayıcı döndürür.

Parametreler

Parametre Açıklama
ctx required
Kural bağlamı.
source_jars Dosya dizisi; varsayılan değer []
Derlenecek jar dosyalarının listesi. source_jars veya source_files parametrelerinden en az biri belirtilmelidir.
source_files sequence/Files; varsayılan olarak []
Derlenecek Java kaynak dosyalarının listesi. source_jars veya source_files parametrelerinden en az biri belirtilmelidir.
output zorunlu
output_source_jar Dosya veya None; varsayılan değer None
Çıkış kaynak jar dosyasıdır. İsteğe bağlı. Ayarlanmadan bırakılırsa varsayılan olarak "{çıkış_jar}-src.jar" değeri kullanılır.
javac_opts Dize dizisi; varsayılan değer []
İstenilen javac seçeneklerinin listesi. İsteğe bağlı.
deps struct dizisi; varsayılan değer []
Bağımlılıkların listesi. İsteğe bağlı.
runtime_deps struct dizisi; varsayılan değer []
Çalışma zamanındaki bağımlılıkların listesi. İsteğe bağlı.
exports struct dizisi; varsayılan değer []
Dışa aktarılanların listesi. İsteğe bağlı.
plugins struct dizisi veya struct dizisi; varsayılan değer []
Eklentilerin listesi. İsteğe bağlı.
exported_plugins struct dizisi veya struct dizisi; varsayılan değer []
Dışa aktarılan eklentilerin listesi. İsteğe bağlı.
native_libraries CcInfo dizisi; varsayılan değer []
CC yerel kitaplık bağımlılıkları bu kitaplık için gereklidir.
annotation_processor_additional_inputs Dosya dizisi; varsayılan değer []
Not ekleme işlemi için Java kaynaklarının yanı sıra Java derleme işleminin alacağı girişlerin listesi.
annotation_processor_additional_outputs Dosya dizisi; varsayılan değer []
Java derleme işleminin, ek açıklama işleminden elde edilen sınıf jar dosyasına ek olarak oluşturacağı çıkışların listesi.
strict_deps varsayılan değer 'ERROR'
Katı bağımlıların nasıl ele alınacağını belirten bir dize. Olası değerler: "OFF", "ERROR", "WARN" ve "DEFAULT". Daha fazla bilgi için /docs/user-manual#flag--strict_java_deps adresine bakın. Varsayılan olarak "ERROR".
java_toolchain required
Bu derleme için kullanılacak JavaToolchainInfo. Zorunlu.
bootclasspath varsayılan değerdir: None
Bu derleme için kullanılacak BootClassPathInfo. Mevcut olduğunda, sağlanan java_toolchain ile ilişkili bootclasspath değerini geçersiz kılar. İsteğe bağlı.
host_javabase Varsayılan değer None
Kullanımdan kaldırıldı. Bu parametrenin desteği sonlandırıldı ve yakında kaldırılacak. Lütfen bu yönteme güvenmeyin. --+incompatible_java_common_parameters ile devre dışı bırakılır. Kodunuzun, kaldırılma olasılığı yüksek olan içerikle uyumlu 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 Dosyaların sequence; varsayılan []
resources Dosya dizisi; varsayılan değer []
resource_jars Dosya dizisi; varsayılan değer []
classpath_resources Dosyaların sequence; varsayılan []
Varsayılan değer False
'tır.
enable_annotation_processing varsayılan değer True
Bu derlemede ek açıklama işlemeyi devre dışı bırakır. Bu durumda, plugins veya deps'in exported_plugins bölümünde sağlanan tüm ek açıklama işleyicileri yoksayılır.
enable_compile_jar_action varsayılan değer True
Başlık derlemeyi 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'ın kullanımını zorlar. Bu, bağımlılığı olmayan ikili dosyalar gibi kitaplık dışı hedefler tarafından kullanılmak üzere tasarlanmıştır.
add_exports Dize dizisi; varsayılan değer []
Bu kitaplığın belirtilen /öğesine erişmesine izin verin. İsteğe bağlı.
add_opens Dize dizisi; varsayılan değer []
Bu kitaplığın, belirtilen / öğesine yansıtmalı olarak erişmesine izin verin. İsteğe bağlı.

JavaRuntimeInfo

Provider java_common.JavaRuntimeInfo

Sağlayıcıyı almak için kullanılan ve kullanılan Java çalışma zamanı hakkında bilgi içeren 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.

birleştirmek

struct java_common.merge(providers)

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

Parametreler

Parametre Açıklama
providers sequence of structs; required
Birleştirilecek sağlayıcıların listesi.

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 dosyalarını tek bir kaynak jar dosyasında paketler. Döndürülen değer genellikle

JavaInfo#source_jar

Çıkış_jar veya exit_source_jar parametrelerinden en az biri gereklidir.

Parametreler

Parametre Açıklama
actions required
ctx.actions
output_jar Dosya veya None; varsayılan olarak None
Kullanımdan kaldırıldı. Bu parametrenin desteği sonlandırıldı ve yakında kaldırılacak. Lütfen bu yönteme güvenmeyin. --+incompatible_java_common_parameters ile devre dışı bırakılır. Kodunuzun yakında kaldırılacak olan işlevlerle uyumlu olup olmadığını doğrulamak için bu işareti kullanın.
Desteği sonlandırıldı: Kuralın çıkış jar dosyası. Elde edilen kaynak jar dosyasını adlandırmak için kullanılır. Parametre, output_source_jar parametresini "{output_jar}-src.jar" olarak ayarlar. Bunun yerine doğrudan output_source_jar parametresini kullanın.
output_source_jar Dosya veya None; varsayılan değer None
Çıkış kaynak jar dosyasıdır.
sources Dosya dizisi; varsayılan değer []
Kaynak jar dosyasına paketlenecek Java kaynak dosyalarının listesi.
source_jars Dosya dizisi; varsayılan değer []
Kaynak jar'a paketlenecek kaynak jar'ların listesi.
java_toolchain zorunlu
ijar aracını bulmak için kullanılan bir JavaToolchainInfo.
host_javabase Varsayılan değer None
Kullanımdan kaldırıldı. Bu parametrenin desteği sonlandırıldı ve yakında kaldırılacak. Lütfen bu yönteme güvenmeyin. --+incompatible_java_common_parameters ile devre dışı bırakılır. Kodunuzun, kaldırılma olasılığı yüksek olan içerikle uyumlu 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)

run_ijar

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

Bir kavanozun üzerinde ijar'ı çalıştırarak yöntem gövdelerini çıkarır. Bu, yalnızca yöntem uygulamalarında yapılan basit değişikliklerden oluşan yeniden derlemeler sırasında bağımlı jar dosyalarının yeniden derlenmesini azaltmaya yardımcı olur. Döndürülen değer genellikle JavaInfo#compile_jar işlevine iletilir.

Parametreler

Parametre Açıklama
actions required
ctx.actions
jar required
ijar'ın çalışacağı jar.
target_label Etiket veya None; varsayılan değer None
Kavanoza damgalanacak hedef etiket. add_dep desteği için kullanılır. Genellikle, kavanozu geçerli kuralın etiketiyle damgalamak için ctx.label değerini geçirirsiniz.
java_toolchain zorunlu
ijar aracını bulmak için kullanılan bir JavaToolchainInfo.

stamp_jar

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

add_dep desteği için bir kavanoza hedef etiket ekler. Döndürülen değer genellikle JavaInfo#compile_jar parametresine iletilir. Mümkün olduğunda run_ijar kullanmayı tercih edin.

Parametreler

Parametre Açıklama
actions required
ctx.actions
jar required
stamp_jar'ın çalışacağı jar.
target_label required
Kavanozun üzerine bası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 iletirsiniz.
java_toolchain zorunlu
stamp_jar aracını bulmak için kullanılan bir JavaToolchainInfo.