. Starlark'ta Java derleme desteği için yardımcı programlar.
Üyeler
- BootClassPathInfo
- derleme
- JavaRuntimeInfo
- JavaToolchainInfo
- birleştirme
- pack_sources
- run_ijar
- stamp_jar
BootClassPathInfo
Provider java_common.BootClassPathInfobootclasspath 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ı/jar'ları derler, derlemenin sonuçlarını temsil eden ve bu kuralın yayınladığı sağlayıcı grubuna eklenebilecek bir sağlayıcı döndürür.
Parametreler
Parametre | Açıklama |
---|---|
ctx
|
ctx;
gerekli Kural bağlamı. |
source_jars
|
sequence of Files;
varsayılan değer [] Derlenecek jar'ların listesi. source_jars veya source_files özelliklerinden en az biri belirtilmelidir. |
source_files
|
sequence of Files;
varsayılan değer [] Derlenecek Java kaynak dosyalarının listesi. source_jars veya source_files özelliklerinden en az biri belirtilmelidir. |
output
|
File (Dosya);
gerekli |
output_source_jar
|
File (Dosya); veya None ;
varsayılan değer: None Çıkış kaynağı jar. Ayarlanmadan bırakılırsa varsayılan olarak "{çıkış_jar}-src.jar" değeri kullanılır. |
javac_opts
|
sequence of dize;
varsayılan değer [] İstenen Javac seçeneklerinin listesi. |
deps
|
struct'ın sequence'ı;
varsayılan değer [] Bağımlılıkların listesi. |
runtime_deps
|
struct'ın sequence'ı;
varsayılan değer [] Çalışma zamanı bağımlılıklarının listesi. |
exports
|
struct'ın sequence'ı;
varsayılan değer [] Dışa aktarmaların listesi. |
plugins
|
struct'ın sequence'ı; veya struct'ların dizisi;
varsayılan değer [] Eklenti listesi. |
exported_plugins
|
struct'ın sequence'ı; veya struct'ların dizisi;
varsayılan değer [] Dışa aktarılan eklentilerin listesi. |
native_libraries
|
sequence/CcInfo
varsayılan değer [] Bu kitaplık için gereken yerel kitaplık bağımlılıklarını CC alanına ekleyin. |
annotation_processor_additional_inputs
|
sequence of Files;
varsayılan değer [] Ek açıklama işleme için Java kaynaklarına ek olarak Java derleme işleminin yapacağı girişlerin listesi. |
annotation_processor_additional_outputs
|
sequence of Files;
varsayılan değer [] Ek açıklama işlemede sınıf jar dosyasına ek olarak Java derleme işleminin çıkaracağı çıkışların listesi. |
strict_deps
|
string;
varsayılan değer: 'ERROR' Katı kısıtlamaların nasıl işleneceğini belirten bir dize. Olası değerler: 'OFF', 'ERROR', 'WARN' ve "VARSAYILAN" yer alır. Daha fazla bilgi için --strict_java_deps sayfasını inceleyin. |
java_toolchain
|
Bilgi;
zorunlu Bu derleme için kullanılacak JavaToolchainInfo. Zorunludur. |
bootclasspath
|
varsayılan değer None Bu derleme için kullanılacak BootClassPathInfo. Mevcut olduğunda, sağlanan java_toolchain ile ilişkili bootclasspath parametresini geçersiz kılar. |
host_javabase
|
varsayılan değer None Kullanımdan kaldırıldı. Bu parametrenin desteği sonlandırılmıştır ve yakında kaldırılacaktır. Lütfen bu metrikten yararlanmayın. --incompatible_java_common_parameters ile devre dışı bırakıldı. 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
|
sequence of Files;
varsayılan değer [] |
resources
|
sequence of Files;
varsayılan değer [] |
resource_jars
|
sequence of Files;
varsayılan değer [] |
classpath_resources
|
sequence of Files;
varsayılan değer [] |
neverlink
|
bool;
varsayılan değer: False |
enable_annotation_processing
|
bool;
varsayılan değer: True Bu derlemede ek açıklama işlemeyi devre dışı bırakarak eklentilerde veya dep'lerdeki dışa aktarılmış_eklentilerde sağlanan ek açıklama işlemcilerinin yoksayılmasına neden olur. |
enable_compile_jar_action
|
bool;
varsayılan değer: True Üstbilgi 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ı olmayan ikili programlar gibi kitaplık dışı hedefler tarafından kullanılmak üzere tasarlanmıştır. |
add_exports
|
sequence of dize;
varsayılan değer [] Bu kitaplığın belirtilen |
add_opens
|
sequence of dize;
varsayılan değer [] Bu kitaplığın, belirtilen |
JavaRuntimeInfo
Provider java_common.JavaRuntimeInfoSağ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.JavaToolchainInfoKullanılan Java araç zinciri hakkında bilgi 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'da birleştirir.
Parametreler
Parametre | Açıklama |
---|---|
providers
|
struct'ın sequence'ı;
gerekli 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'ları tek bir kaynak jar dosyasında paketler. Döndürülen değer genellikle
JavaInfo#source_jar
Parametreler
Parametre | Açıklama |
---|---|
actions
|
actions;
gerekli ctx.actions |
output_jar
|
File (Dosya); veya None ;
varsayılan değer: None Kullanımdan kaldırıldı. Bu parametrenin desteği sonlandırılmıştır ve yakında kaldırılacaktır. Lütfen bu metrikten yararlanmayın. --incompatible_java_common_parameters ile devre dışı bırakıldı. 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ı: Kuralın çıkış jar'ı. Sonuçta ortaya çıkan kaynak jar'ı adlandırmak için kullanılır. Parametre, çıkış_source_jar parametresini "{çıkış_jar}-src.jar" olarak ayarlar.Bunun yerine, doğrudan exit_source_jar parametresini kullanın. |
output_source_jar
|
File (Dosya); veya None ;
varsayılan değer: None Çıkış kaynağı jar. |
sources
|
sequence of Files;
varsayılan değer [] Kaynak jar'a paketlenecek Java kaynak dosyalarının listesi. |
source_jars
|
sequence of Files;
varsayılan değer [] Kaynak kavanoza paketlenecek kaynak jar'ların listesi. |
java_toolchain
|
Bilgi;
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ılmıştır ve yakında kaldırılacaktır. Lütfen bu metrikten yararlanmayın. --incompatible_java_common_parameters ile devre dışı bırakıldı. 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 basit değişikliklerden oluşan yeniden derleme işlemleri sırasında bağımlı jar'ların yeniden oluşturulmasının azaltılmasına yardımcı olur. Döndürülen değer genellikle
JavaInfo#compile_jar
işlevine iletilir.
Parametreler
Parametre | Açıklama |
---|---|
actions
|
actions;
gerekli ctx.actions |
jar
|
File (Dosya);
gerekli ijar dosyasının üzerinde çalıştırılacağı kavanoz. |
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
|
Bilgi;
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 etiketi ekler. Döndürülen değer genellikle JavaInfo#compile_jar
işlevine iletilir. Mümkün olduğunda run_ijar
kullanmayı tercih edin.
Parametreler
Parametre | Açıklama |
---|---|
actions
|
actions;
gerekli ctx.actions |
jar
|
File (Dosya);
gerekli stamp_jar öğesinin üzerinde çalıştırılacağı kavanoz. |
target_label
|
Etiket;
gerekli 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
|
Bilgi;
zorunlu stamp_jar aracını bulmak için kullanılan bir JavaToolchainInfo. |