BazelCon 2024 kayıtları başladı.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Java Kuralları

Kurallar

java_binary
java_import
java_library
java_lite_proto_library
java_proto_library
java_test
java_package_configuration
java_plugin
java_runtime
java_toolchain

java_binary

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)

Bir Java arşivi ("jar dosyası") ve kuralla aynı ada sahip bir sarmalayıcı kabuk komut dosyası oluşturur. Sarmalayıcı kabuk komut dosyası, diğer özelliklerinin yanı sıra her öğe için bir jar dosyası içeren ikili programın bağlı olduğu kitaplıktır.

Sarmalayıcı komut dosyası, birkaç benzersiz işareti kabul eder. Referans //src/main/java/com/google/devtools/build/lib/bazel/rules/java/java_stub_template.txt. inceleyebilirsiniz.

Dolaylı çıkış hedefleri

name.jar: Sınıf dosyalarını ve diğer dosyaları içeren bir Java arşivi ve ikili programın doğrudan bağımlılıklarına karşılık gelen kaynaklardır.
name-src.jar: Kaynakları içeren bir arşiv ("kaynak jar").
name_deploy.jar: Dağıtıma uygun bir Java arşivi (yalnızca oluşturulur).
Kuralınız için <name>_deploy.jar hedefi oluşturuluyor , dosyanın java -jar komutuyla veya sarmalayıcı komut dosyasının --singlejar komutuyla seçeneğini belirleyin. java -jar yerine sarmalayıcı komut dosyasının kullanılması tercih edilir çünkü JVM flag'lerini ve seçenekleri de iletir. yerel kitaplıklar yüklemek için kullanılır.

Dağıtma jar dosyası, şu anda çalışan bir sınıf yükleyicinin bulacağı tüm sınıfları sınıf yolunu ikili programın sarmalayıcı komut dosyasından başından sonuna kadar aradı. Aynı zamanda bağımlılıklar için gerekli yerel kitaplıkları içerir. Bunlar otomatik olarak yüklenir JVM'ye aktarırsınız.

Hedefiniz bir başlatıcı belirtiyorsa özelliği ile birlikte çalışırsanız, _deploy.jar normal bir JAR dosyası yerine yerel ikili programdır. Bu, başlatıcıyı ve uygulamanın tüm yerel (C++) bağımlılıklarını içerir: statik bir ikili sisteme bağlanmalıdır. Gerçek jar dosyasının baytları yerel ikili programının sonuna eklenir ve hem yürütülebilir ve Java kodu. Oluşturulan jar dosyasını doğrudan çalıştırabilirsiniz olduğu gibi kullanabilirsiniz.
name_deploy-src.jar: Kaynakları içeren bir arşiv hedefin geçişli olarak kapatılmasından toplanan verileri ölçer. Bunlar şu sınıflarla eşleşecek: Kavanozların eşleşen kaynak jar'ı olmadığı durumlar hariç deploy.jar.

Aşağıdaki değerler içermeyen java_binary kuralında deps özelliğine izin verilmez srcs; böyle bir kural için main_class sağlayan: runtime_deps.

Aşağıdaki kod snippet'inde yaygın bir hata gösterilmektedir:

java_binary(
    name = "DontDoThis",
    srcs = [
        ...,
        "GeneratedJavaFile.java",  # a generated .java file
    ],
    deps = [":generating_rule",],  # rule that generates that file
)

Bunun yerine şunu yapın:

java_binary(
    name = "DoThisInstead",
    srcs = [
        ...,
        ":generating_rule",
    ],
)

Bağımsız değişkenler

Özellikler
`name`	`Name; required` Bu hedef için benzersiz bir ad. Dosyanın ana giriş noktası olan kaynak dosyanın adını (uzantı hariç) seçin. Örneğin, giriş noktanız `Main.java`, adınız `Main` olabilir.
`deps`	`List of labels; optional` Hedefe bağlanacak diğer kitaplıkların listesi. `deps` ile ilgili genel yorumları şu adreste bulabilirsiniz: Genel özellikler çoğu derleme kuralına bakın.
`srcs`	`List of labels; optional` Hedefi oluşturmak için işlenen kaynak dosyaların listesi. Bu özellik neredeyse her zaman gereklidir; aşağıdaki istisnalara bakın. `.java` türündeki kaynak dosyalar derlenir. Oluşturulması durumunda `.java` dosyalarına oluşturma kuralının adının eklenmesi genellikle önerilir buraya yerleştirin. Bu hem okunabilirliği artırmakla kalmaz hem de gelecekteki değişikliklere karşı daha dirençli hale getirir: oluşturan kural gelecekte farklı dosyalara ihtiyacınız varsa tek bir yeri düzeltmeniz gerekir: `outs` oluşturma kuralı. Oluşturma kuralını `deps` içinde listelememelisiniz. çünkü işlemsiz. `.srcjar` türündeki kaynak dosyalar paketten çıkarılır ve derlenir. (Bu, bir genrule dosyasıyla `.java` dosyaları oluşturmanız gerekir.) Kurallar: Kural (genellikle `genrule` veya `filegroup`) oluşturulursa yukarıda listelenen dosyalardan herhangi biri, dosyası olarak da kaydedebilir. Bu bağımsız değişken, `main_class` özelliği, sınıfını kullanmanız veya `runtime_deps` bağımsız değişkenini belirtmeniz gerekir.
`resources`	`List of labels; optional` Java jar'a dahil edilecek veri dosyalarının listesi. Kaynaklar belirtilirse, normal kaynaklarla birlikte kavanozda paketlenir Derleme, `.class` dosya üretti. İçerideki kaynakların konumu proje yapısına göre belirlenir. Bazel ilk olarak Maven'in standart dizin düzenine benzerdir. (bir "src" dizini ve ardından bir "kaynaklar" dizini torunu). Bu durumda bulunduktan sonra Bazel, "Java" adlı en üstteki dizini veya "Javatests" gibi (yani, Örneğin, bir kaynak `<workspace root>/x/java/y/java/z` konumundaysa kaynağın yolu `y/java/z` olur. Bu buluşsal yöntem geçersiz kılınamaz. ancak `resource_strip_prefix` özelliği bir kaynak dosyalar için belirli bir alternatif dizindir. Kaynaklar, kaynak dosyalar veya oluşturulan dosyalar olabilir.
`classpath_resources`	`List of labels; optional` BAŞKA BİR YOL OLMADIĞINDAN BU SEÇENEĞİ KULLANMAYIN) Java ağacının kökünde bulunması gereken kaynakların listesi. Bu özelliğin tek amacı, kaynaklarının kullanımını gerektiren üçüncü taraf kitaplıkları desteklemektir sınıf yolunda tam olarak `"myconfig.xml"` olarak bulundu. Yalnızca şuralarda izin verilir: kullanılmasıdır.
`create_executable`	`Boolean; optional; nonconfigurable; default is True` İkili programın yürütülebilir olup olmadığı. Yürütülemez ikili programlar toplu geçişli çalışma zamanı Java bağımlılıkları bir dağıtım jar'ına bağlıdır, ancak doğrudan yürütülemez. Bu özellik ayarlanırsa sarmalayıcı komut dosyası oluşturulmaz. Bu, yanlış `launcher` veya `main_class` özellikleri için bu değeri 0 olarak ayarlayın. ayarlandı.
`deploy_env`	`List of labels; optional` Dağıtımı temsil eden diğer `java_binary` hedeflerinin listesi ortamına ekleyebilirsiniz. Başka bir site tarafından yüklenecek bir eklenti oluştururken bu özelliği ayarlayın. `java_binary` Bu özelliğin ayarlanması, bu ikili programın çalışma zamanı sınıf yolu (ve dağıtım jar'ı) ikili program ve `deploy_env` politikasında belirtilen hedefler.
`deploy_manifest_lines`	`List of strings; optional` için oluşturulan `META-INF/manifest.mf` dosyasına eklenecek satırların listesi `_deploy.jar` hedef. Bu özelliğin içeriği konu değildir* "Değişken yap" olarak değiştirin.
`javacopts`	`List of strings; optional` Bu kitaplık için ek derleyici seçenekleri. "Değişken yap" değişikliğine tabi ve Bourne kabuk belirteçleme. Bu derleyici seçenekleri, genel derleyici seçeneklerinden sonra javac'a iletilir.
`jvm_flags`	`List of strings; optional` Bu ikili programı çalıştırmak için oluşturulmuş sarmalayıcı komut dosyasına yerleştirilecek işaretlerin listesi. $(location) öğesine tabi ve "Değişken yap" ifadesini değiştirme ve Bourne kabuk belirteçleme. Java ikili programı için sarmalayıcı komut dosyası bir CLASSPATH tanımı içeriyor (bağımlı tüm jar'ları bulmak için) kullanır ve doğru Java yorumlayıcısını çağırır. Sarmalayıcı komut dosyası tarafından oluşturulan komut satırı, ana sınıf ve ardından `"$@"` ile diğerlerini geçin bağımsız değişkenlerini ekleyin. Ancak, ayrıştırma için tasarlanmış bağımsız değişkenler komuttaki sınıf adından önce belirtilmelidir. satırında görünür. `jvm_flags` içeriği sarmalayıcıya eklenir komut dosyasını eklemeniz gerekir. Bu özelliğin `_deploy.jar` üzerinde etkisi olmadığını* unutmayın. çıktı.
`launcher`	`Label; optional` Java programınızı çalıştırmak için kullanılacak Normal `bin/java` programı JDK'ya dahildir. Hedef bir `cc_binary` olmalıdır. Şu özelliklere sahip herhangi bir `cc_binary`: , Bu özellik için bir değer olarak Java Invocation API belirtilebilir. Varsayılan olarak, Bazel normal JDK başlatıcıyı (bin/Java veya java.exe) kullanır. İlgili `--java_launcher` Bazel işareti yalnızca bunları etkiler Şu özelliklere sahip `java_binary` ve `java_test` hedef: `launcher` özelliği belirtilmedi. Yerel (C++, SWIG, JNI) bağımlılıklarınızın farklı şekilde oluşturulacağını unutmayın JDK başlatıcıyı mı yoksa başka bir başlatıcıyı mı kullandığınıza bağlı olarak: Normal JDK başlatıcıyı (varsayılan) kullanıyorsanız yerel bağımlılıklar `{name}_nativedeps.so` adlı paylaşılan bir kitaplık olarak oluşturulur. `{name}`, bu java_binary kuralının `name` özelliğidir. Kullanılmayan kod, bu yapılandırmada bağlayıcı tarafından kaldırılmaz. Başka bir başlatıcı kullanıyorsanız yerel (C++) bağımlılıkları statik olarak `{name}_nativedeps` adlı bir ikili programa bağlanmıştır; burada `{name}` bu java_binary kuralının `name` özelliğidir. Böyle durumlarda bağlayıcı, kullanılmadığını düşündüğü kodları elde edilen ikili programdan kaldırır. Yani, yalnızca JNI aracılığıyla erişilen C++ kodları yalnızca `cc_library` hedefi `alwayslink = 1` değerini belirtiyor. Varsayılan JDK başlatıcı dışında herhangi bir başlatıcıyı kullanırken biçim, `*_deploy.jar` çıkış değişikliğinin sayısı. Temel konuları java_binary dokümanlarına göz atın.
`main_class`	`String; optional` Giriş noktası olarak kullanılacak `main()` yöntemine sahip sınıfın adı. Bir kural bu seçeneği kullanıyorsa `srcs=[...]` listesine ihtiyaç duymaz. Dolayısıyla, bu özellikle, önceden hazırlanmış bir Java kitaplığından yürütülebilir bir dosya bir veya daha fazla `main()` yöntemi içerir. Bu özelliğin değeri bir kaynak dosya değil, sınıf adıdır. Sınıf çalışma zamanında kullanılabilir: bu kural tarafından derlenmiş olabilir (`srcs` kaynağından) veya doğrudan veya geçişli bağımlılıklar tarafından sağlanan (`runtime_deps` veya `deps`). Sınıf kullanılamıyorsa ikili program çalışma zamanında başarısız olur. orada derleme zamanı denetimi yoktur.
`plugins`	`List of labels; optional` Derleme zamanında çalışacak Java derleyici eklentileri. Bu özellikte belirtilen her `java_plugin` bu kuralla birlikte çalıştırılır geliştirildi. Bir kitaplık, `exported_plugins` Kaynaklar oluşturulan dosya, bu kuralın ortaya çıkan jar'ına dahil edilir.
`resource_jars`	`List of labels; optional` Desteği sonlandırıldı: Bunun yerine java_import ve deps veyaworkspace_deps öğelerini kullanın.
`resource_strip_prefix`	`String; optional` Java kaynaklarından çıkarılacak yol ön eki. Belirtilirse bu yol öneki `resources` içindeki her dosyadan çıkarılır. özelliğini gönderin. Bu, kaynak dosyasının bu dizinde olmamasıyla ilgili bir hatadır. Değilse belirtildiğinde (varsayılan), kaynak dosyasının yolu yine aynı mantığını kaynak dosyalardan oluşan Java paketi olarak kullanır. Örneğin, `stuff/java/foo/bar/a.txt` şu şekilde konumlandırılacak: `foo/bar/a.txt`.
`runtime_deps`	`List of labels; optional` Son ikili program veya yalnızca çalışma zamanında test için kullanılacak kitaplıklar. Bunlar sıradan `deps` ürününde olduğu gibi çalışma zamanı sınıf yolunda görünür, ancak üzerinde çalışmalıdır. Yalnızca çalışma zamanında gereken bağımlılıklar burada görebilirsiniz. Bağımlılık analizi araçları, `runtime_deps` ve `deps`.
`stamp`	`Integer; optional; default is -1` Derleme bilgilerinin ikili programda kodlanıp kodlanmayacağını belirler. Olası değerler: `stamp = 1`: Derleme bilgilerini `--nostamp` derleme. Bu ayarından kaçınılmalıdır. Aksi takdirde, bu işlem ve buna bağımlı tüm aşağı akış işlemleri. `stamp = 0`: Derleme bilgilerini her zaman sabit değerlerle değiştirin. Bu iyi bir derleme sonucu önbelleğe alma sağlar. `stamp = -1`: Derleme bilgilerinin yerleştirilmesi `--[no]stamp` işaretidir. Bağımlılıkları değişmediği sürece damgalı ikili programlar yeniden oluşturulmaz.
`use_launcher`	`Boolean; optional; default is True` İkili programın özel bir başlatıcı kullanıp kullanmayacağı. Bu özellik false (yanlış) değerine ayarlanırsa Başlatıcı özelliğini ve ilgili `--java_launcher` işaretle bu hedef için yoksayılacak.
`use_testrunner`	`Boolean; optional; default is False` Test çalıştırıcısını kullan (varsayılan olarak `com.google.testing.junit.runner.BazelTestRunner`) sınıfını kullanın. ana giriş noktasını kullanabilir ve test sınıfını `bazel.test_suite` değeri olarak test koşucusuna atanır. sistem özelliğini etkinleştirmelisiniz. Varsayılan değeri geçersiz kılmak için bunu kullanabilirsiniz yardımcı olmak için test çalıştırıcısını kullanarak `java_test` kural, ve `java_binary` kuralları için kullanmayın. Düşük ihtimalle bunu yapmanız gerekir. Bir kullanım `AllTest` içindir başka bir kural tarafından çağrılan kurallar (veri tabanı ) girmeniz gerekir. `AllTest` kuralı `java_binary` olarak tanımlanmalıdır, ancak test çalıştırıcıyı ana giriş noktası olarak kullanmaya devam edebilirsiniz. Test çalıştırıcı sınıfının adı, `main_class` özelliğiyle geçersiz kılınabilir.

java_import

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)

Bu kural, önceden derlenmiş .jar dosyalarının java_library ve için kitaplıklar java_binary kural.

Örnekler

    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",
        ],
    )

Bağımsız değişkenler

Özellikler
`name`	`Name; required` Bu hedef için benzersiz bir ad.
`deps`	`List of labels; optional` Hedefe bağlanacak diğer kitaplıkların listesi. java_library.deps sayfasına göz atın.
`constraints`	`List of strings; optional; nonconfigurable` Java kitaplığı olarak bu kurala uygulanan ekstra kısıtlamalar.
`exports`	`List of labels; optional` Bu kuralın kullanıcılarına sunulacak hedefler. java_library.exports'u inceleyin.
`jars`	`List of labels; required` Bu hedefe bağlı Java hedeflerine sağlanan JAR dosyalarının listesi.
`neverlink`	`Boolean; optional; default is False` Bu kitaplığı yalnızca derleme için kullanın, çalışma zamanında kullanmayın. Kitaplık çalışma zamanı ortamı tarafından sağlanacaksa kullanışlıdır bazı işaretler bulabilirsiniz. Bunun gibi kitaplıklara örnek olarak IDE API'leri verilebilir. için IDE eklentileri veya şu anda çalışan her şey için `tools.jar` standart bir JDK olabilir.
`proguard_specs`	`List of labels; optional` ProGuard spesifikasyonu olarak kullanılacak dosyalar. Burada, ProGuard tarafından kullanılacak spesifikasyonlar açıklanır. Belirtilmişse bunlar, bu kitaplığa bağlı olarak herhangi bir `android_binary` hedefine eklenir. Buraya eklenen dosyalar sadece ideaklı kurallara, yani -dontnote, -dontwarn, yan etkileri ve -keep ile başlayan kuralları içerir. Diğer seçenekler yalnızca `android_binary` öğesinin proguard_specs (totoolojik olmayan birleştirmeler için)
`runtime_deps`	`List of labels; optional` Son ikili program veya yalnızca çalışma zamanında test için kullanılacak kitaplıklar. java_library.runtime_deps kitaplığına göz atın.
`srcjar`	`Label; optional` Derlenmiş JAR dosyaları için kaynak kodunu içeren bir JAR dosyası.

java_library

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)

Bu kural, kaynakları bir .jar dosyasında derler ve bağlar.

Dolaylı çıkış hedefleri

libname.jar: Sınıf dosyalarını içeren bir Java arşivi.
libname-src.jar: Kaynakları içeren bir arşiv ("kaynak jar").

Bağımsız değişkenler

Özellikler
`name`	`Name; required` Bu hedef için benzersiz bir ad.
`deps`	`List of labels; optional` Bu kitaplığa bağlanacak kitaplıkların listesi. `deps` ile ilgili genel yorumları şu adreste bulabilirsiniz: Genel özellikler çoğu derleme kuralına bakın. `deps` içinde listelenen `java_library` kuralları tarafından oluşturulan jar'lar açık olacak bu kuralın derleme zamanı sınıf yolu. Dahası, hizmet hesaplarının geçişli olarak kapatılması `deps`, `runtime_deps` ve `exports` şurada olacak: çalışma zamanı sınıf yolu. Buna karşılık, `data` özelliğindeki hedefler çalıştırma dosyalarına dahil edilir ancak hem derleme zamanında ne de çalışma zamanı sınıf yolundan yararlanır.
`srcs`	`List of labels; optional` Hedefi oluşturmak için işlenen kaynak dosyaların listesi. Bu özellik neredeyse her zaman gereklidir; aşağıdaki istisnalara bakın. `.java` türündeki kaynak dosyalar derlenir. Oluşturulması durumunda `.java` dosyalarına oluşturma kuralının adının eklenmesi genellikle önerilir buraya yerleştirin. Bu hem okunabilirliği artırmakla kalmaz hem de gelecekteki değişikliklere karşı daha dirençli hale getirir: oluşturan kural gelecekte farklı dosyalara ihtiyacınız varsa tek bir yeri düzeltmeniz gerekir: `outs` oluşturma kuralı. Oluşturma kuralını `deps` içinde listelememelisiniz. çünkü işlemsiz. `.srcjar` türündeki kaynak dosyalar paketten çıkarılır ve derlenir. (Bu, bir genrule dosyasıyla `.java` dosyaları oluşturmanız gerekir.) Kurallar: Kural (genellikle `genrule` veya `filegroup`) oluşturulursa yukarıda listelenen dosyalardan herhangi biri, dosyası olarak da kaydedebilir. Bu bağımsız değişken, `main_class` özelliği, sınıfını kullanmanız veya `runtime_deps` bağımsız değişkenini belirtmeniz gerekir.
`data`	`List of labels; optional` Çalışma zamanında bu kitaplığın ihtiyaç duyduğu dosyaların listesi. `data` ile ilgili genel yorumları şu adreste bulabilirsiniz: Genel özellikler çoğu derleme kuralına bakın. Bir `java_library` oluştururken Bazel bu dosyaları hiçbir yere koymaz; eğer `data` dosya oluşturulduktan sonra Bazel tarafından oluşturulur. Bir Bu teste dayalı bir test yöntemidir. `java_library` Bazel, `data` dosya, çalıştırma dosyaları alanına.
`resources`	`List of labels; optional` Java jar'a dahil edilecek veri dosyalarının listesi. Kaynaklar belirtilirse, normal kaynaklarla birlikte kavanozda paketlenir Derleme, `.class` dosya üretti. İçerideki kaynakların konumu proje yapısına göre belirlenir. Bazel ilk olarak Maven'in standart dizin düzenine benzerdir. (bir "src" dizini ve ardından bir "kaynaklar" dizini torunu). Bu durumda bulunduktan sonra Bazel, "Java" adlı en üstteki dizini veya "Javatests" gibi (yani, Örneğin, bir kaynak `<workspace root>/x/java/y/java/z` konumundaysa kaynağın yolu `y/java/z` olur. Bu buluşsal yöntem geçersiz kılınamaz. ancak `resource_strip_prefix` özelliği bir kaynak dosyalar için belirli bir alternatif dizindir. Kaynaklar, kaynak dosyalar veya oluşturulan dosyalar olabilir.
`exported_plugins`	`List of labels; optional` `java_plugin` listesi (ör. ek açıklama) işlemcileri) doğrudan bu kitaplığa bağımlı kitaplıklara aktarmak için kullanılır. Belirtilen `java_plugin` listesi şu kitaplığa uygulanacaktır: Bu kitaplığa, sanki bu kitaplık açık bir şekilde açıkça beyan edilmiş gibi `plugins` içinde etiketler.
`exports`	`List of labels; optional` Dışa aktarılan kitaplıklar. Burada listeleme kuralları, bunları üst kurallar tarafından sanki üst öğelerde olduğu gibi üst kurallarda kullanılabilir hale getirir bu kurallara bağlıydı. Bu, normal (dışa aktarılmayan) `deps` için geçerli değildir. Özet: X kuralı, bir bağımlılık varsa Y içindeki koda erişebilir `deps` kenarıyla başlayan ve ardından sıfır veya daha çok sayıda gelen yol `exports` kenar. Bunu açıklamak için bazı örneklere göz atalım. A'nın B'ye, B'nin ise C'ye bağlı olduğunu varsayın. Bu durumda C, A'nın geçişli bir bağımlılığıdır; dolayısıyla C'nin kaynaklarını değiştirmek ve A'yı yeniden oluşturmak, her şeyi doğru şekilde yeniden yapabilir. Ancak A, C sınıfındaki sınıfları kullanamaz. İzin vermek için A'nın `deps` içinde C'yi belirtmesi gerekir veya B, A'nın çalışmasını kolaylaştırabilir (ve A'ya bağlı olabilecek her şey) için, C değerini (B'nin) `exports` kısmında özelliğini gönderin. Dışa aktarılan kitaplıklar, tüm doğrudan üst kurallar tarafından kapatılabilir. Biraz çekin farklı örnek: A B'ye, B ise C ve D'ye bağlıdır ve C'yi dışa aktarır ancak D'yi dışa aktarmaz. Artık A, C'ye erişebilir ancak D'ye erişemez. C ve D bazı kitaplıkları dışa aktardıysa C'yi ve D' sırasıyla, A yalnızca C'ye erişebilir. ancak D' ile değil. Önemli: Dışa aktarılan kurallar normal bir bağımlılık değildir. Önceki örneğe devam edecek olursak B, C'yi dışa aktarıyor ve C'yi de kullanmak istiyorsa bunu kendi `deps`
`javacopts`	`List of strings; optional` Bu kitaplık için ek derleyici seçenekleri. "Değişken yap" değişikliğine tabi ve Bourne kabuk belirteçleme. Bu derleyici seçenekleri, genel derleyici seçeneklerinden sonra javac'a iletilir.
`neverlink`	`Boolean; optional; default is False` Bu kitaplığın çalışma zamanında değil yalnızca derleme için kullanılıp kullanılmayacağı. Kitaplık, yürütme sırasında çalışma zamanı ortamı tarafından sağlanacaksa kullanışlıdır. Örnekler IDE eklentileri için IDE API'leri veya her şey için `tools.jar` bu tür kitaplıklardan biridir çalışıyordum. `neverlink = 1` yönergesinin, derleyicinin materyali satır içine almasını engellemediğini unutmayın. tarafından izin verildiği şekilde, bu kitaplıktan alıp buna bağımlı derleme hedeflerine Dil Özellikleri (ör. `String` için `static final` sabit değer veya temel türlerde) ayırmaları gerekir. Bu nedenle tercih edilen kullanım alanı, çalışma zamanı kitaplığının ile aynı olacak. Çalışma zamanı kitaplığı, derleme kitaplığından farklıysa yalnızca JLS'nin derleyicilerin satır içi yapmasını yasakladığı (ve JLS'nin gelecekteki tüm sürümleri).
`plugins`	`List of labels; optional` Derleme zamanında çalışacak Java derleyici eklentileri. Bu özellikte belirtilen her `java_plugin` bu kuralla birlikte çalıştırılır geliştirildi. Bir kitaplık, `exported_plugins` Kaynaklar oluşturulan dosya, bu kuralın ortaya çıkan jar'ına dahil edilir.
`proguard_specs`	`List of labels; optional` ProGuard spesifikasyonu olarak kullanılacak dosyalar. Burada, ProGuard tarafından kullanılacak spesifikasyonlar açıklanır. Belirtilmişse bunlar, bu kitaplığa bağlı olarak herhangi bir `android_binary` hedefine eklenir. Buraya eklenen dosyalar sadece ideaklı kurallara, yani -dontnote, -dontwarn, yan etkileri ve -keep ile başlayan kuralları içerir. Diğer seçenekler yalnızca `android_binary` öğesinin proguard_specs (totoolojik olmayan birleştirmeler için)
`resource_jars`	`List of labels; optional` Desteği sonlandırıldı: Bunun yerine java_import ve deps veyaworkspace_deps öğelerini kullanın.
`resource_strip_prefix`	`String; optional` Java kaynaklarından çıkarılacak yol ön eki. Belirtilirse bu yol öneki `resources` içindeki her dosyadan çıkarılır. özelliğini gönderin. Bu, kaynak dosyasının bu dizinde olmamasıyla ilgili bir hatadır. Değilse belirtildiğinde (varsayılan), kaynak dosyasının yolu yine aynı mantığını kaynak dosyalardan oluşan Java paketi olarak kullanır. Örneğin, `stuff/java/foo/bar/a.txt` şu şekilde konumlandırılacak: `foo/bar/a.txt`.
`runtime_deps`	`List of labels; optional` Son ikili program veya yalnızca çalışma zamanında test için kullanılacak kitaplıklar. Bunlar sıradan `deps` ürününde olduğu gibi çalışma zamanı sınıf yolunda görünür, ancak üzerinde çalışmalıdır. Yalnızca çalışma zamanında gereken bağımlılıklar burada görebilirsiniz. Bağımlılık analizi araçları, `runtime_deps` ve `deps`.

java_lite_proto_library

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 dosyadan Java kodu oluşturur.

deps, proto_library kuralına işaret etmelidir.

Örnek:

java_library(
    name = "lib",
    deps = [":foo"],
)

java_lite_proto_library(
    name = "foo",
    deps = [":bar"],
)

proto_library(
    name = "bar",
)

Bağımsız değişkenler

Özellikler

name

Name; required

Bu hedef için benzersiz bir ad.

deps

List of labels; optional

proto_library listesi kurallarını belirtin.

java_proto_library

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 dosyadan Java kodu oluşturur.

deps, proto_library kuralına işaret etmelidir.

Örnek:

java_library(
    name = "lib",
    deps = [":foo_java_proto"],
)

java_proto_library(
    name = "foo_java_proto",
    deps = [":foo_proto"],
)

proto_library(
    name = "foo_proto",
)

Bağımsız değişkenler

Özellikler

name

Name; required

Bu hedef için benzersiz bir ad.

deps

List of labels; optional

proto_library listesi kurallarını belirtin.

java_test

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() kuralı bir Java testi derler. Test, projenizdeki test kodu. Derlenmekte olan ana sınıf yerine test çalıştırıcının ana yöntemi çağrılır.

Dolaylı çıkış hedefleri

name.jar: Bir Java arşivi.
name_deploy.jar: Uygun bir Java arşivi . (Yalnızca açıkça talep edildiğinde oluşturulur.) Şu açıklamaya bakın: Şu kaynaktan name_deploy.jar çıkış: java_binary'yi ziyaret edin.

java_binary() bağımsız değişkenleriyle ilgili bölüme bakın. Bu kural ayrıca tüm özellikleri destekler. (*_test) testine tabi tutun.

Örnekler

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",
    ],
)

Bağımsız değişkenler

Özellikler
`name`	`Name; required` Bu hedef için benzersiz bir ad.
`deps`	`List of labels; optional` Hedefe bağlanacak diğer kitaplıkların listesi. `deps` ile ilgili genel yorumları şu adreste bulabilirsiniz: Genel özellikler çoğu derleme kuralına bakın.
`srcs`	`List of labels; optional` Hedefi oluşturmak için işlenen kaynak dosyaların listesi. Bu özellik neredeyse her zaman gereklidir; aşağıdaki istisnalara bakın. `.java` türündeki kaynak dosyalar derlenir. Oluşturulması durumunda `.java` dosyalarına oluşturma kuralının adının eklenmesi genellikle önerilir buraya yerleştirin. Bu hem okunabilirliği artırmakla kalmaz hem de gelecekteki değişikliklere karşı daha dirençli hale getirir: oluşturan kural gelecekte farklı dosyalara ihtiyacınız varsa tek bir yeri düzeltmeniz gerekir: `outs` oluşturma kuralı. Oluşturma kuralını `deps` içinde listelememelisiniz. çünkü işlemsiz. `.srcjar` türündeki kaynak dosyalar paketten çıkarılır ve derlenir. (Bu, bir genrule dosyasıyla `.java` dosyaları oluşturmanız gerekir.) Kurallar: Kural (genellikle `genrule` veya `filegroup`) oluşturulursa yukarıda listelenen dosyalardan herhangi biri, dosyası olarak da kaydedebilir. Bu bağımsız değişken, `main_class` özelliği, sınıfını kullanmanız veya `runtime_deps` bağımsız değişkenini belirtmeniz gerekir.
`resources`	`List of labels; optional` Java jar'a dahil edilecek veri dosyalarının listesi. Kaynaklar belirtilirse, normal kaynaklarla birlikte kavanozda paketlenir Derleme, `.class` dosya üretti. İçerideki kaynakların konumu proje yapısına göre belirlenir. Bazel ilk olarak Maven'in standart dizin düzenine benzerdir. (bir "src" dizini ve ardından bir "kaynaklar" dizini torunu). Bu durumda bulunduktan sonra Bazel, "Java" adlı en üstteki dizini veya "Javatests" gibi (yani, Örneğin, bir kaynak `<workspace root>/x/java/y/java/z` konumundaysa kaynağın yolu `y/java/z` olur. Bu buluşsal yöntem geçersiz kılınamaz. ancak `resource_strip_prefix` özelliği bir kaynak dosyalar için belirli bir alternatif dizindir. Kaynaklar, kaynak dosyalar veya oluşturulan dosyalar olabilir.
`classpath_resources`	`List of labels; optional` BAŞKA BİR YOL OLMADIĞINDAN BU SEÇENEĞİ KULLANMAYIN) Java ağacının kökünde bulunması gereken kaynakların listesi. Bu özelliğin tek amacı, kaynaklarının kullanımını gerektiren üçüncü taraf kitaplıkları desteklemektir sınıf yolunda tam olarak `"myconfig.xml"` olarak bulundu. Yalnızca şuralarda izin verilir: kullanılmasıdır.
`create_executable`	`Boolean; optional; nonconfigurable; default is True` İkili programın yürütülebilir olup olmadığı. Yürütülemez ikili programlar toplu geçişli çalışma zamanı Java bağımlılıkları bir dağıtım jar'ına bağlıdır, ancak doğrudan yürütülemez. Bu özellik ayarlanırsa sarmalayıcı komut dosyası oluşturulmaz. Bu, yanlış `launcher` veya `main_class` özellikleri için bu değeri 0 olarak ayarlayın. ayarlandı.
`deploy_manifest_lines`	`List of strings; optional` için oluşturulan `META-INF/manifest.mf` dosyasına eklenecek satırların listesi `_deploy.jar` hedef. Bu özelliğin içeriği konu değildir* "Değişken yap" olarak değiştirin.
`javacopts`	`List of strings; optional` Bu kitaplık için ek derleyici seçenekleri. "Değişken yap" değişikliğine tabi ve Bourne kabuk belirteçleme. Bu derleyici seçenekleri, genel derleyici seçeneklerinden sonra javac'a iletilir.
`jvm_flags`	`List of strings; optional` Bu ikili programı çalıştırmak için oluşturulmuş sarmalayıcı komut dosyasına yerleştirilecek işaretlerin listesi. $(location) öğesine tabi ve "Değişken yap" ifadesini değiştirme ve Bourne kabuk belirteçleme. Java ikili programı için sarmalayıcı komut dosyası bir CLASSPATH tanımı içeriyor (bağımlı tüm jar'ları bulmak için) kullanır ve doğru Java yorumlayıcısını çağırır. Sarmalayıcı komut dosyası tarafından oluşturulan komut satırı, ana sınıf ve ardından `"$@"` ile diğerlerini geçin bağımsız değişkenlerini ekleyin. Ancak, ayrıştırma için tasarlanmış bağımsız değişkenler komuttaki sınıf adından önce belirtilmelidir. satırında görünür. `jvm_flags` içeriği sarmalayıcıya eklenir komut dosyasını eklemeniz gerekir. Bu özelliğin `_deploy.jar` üzerinde etkisi olmadığını* unutmayın. çıktı.
`launcher`	`Label; optional` Java programınızı çalıştırmak için kullanılacak Normal `bin/java` programı JDK'ya dahildir. Hedef bir `cc_binary` olmalıdır. Şu özelliklere sahip herhangi bir `cc_binary`: , Bu özellik için bir değer olarak Java Invocation API belirtilebilir. Varsayılan olarak, Bazel normal JDK başlatıcıyı (bin/Java veya java.exe) kullanır. İlgili `--java_launcher` Bazel işareti yalnızca bunları etkiler Şu özelliklere sahip `java_binary` ve `java_test` hedef: `launcher` özelliği belirtilmedi. Yerel (C++, SWIG, JNI) bağımlılıklarınızın farklı şekilde oluşturulacağını unutmayın JDK başlatıcıyı mı yoksa başka bir başlatıcıyı mı kullandığınıza bağlı olarak: Normal JDK başlatıcıyı (varsayılan) kullanıyorsanız yerel bağımlılıklar `{name}_nativedeps.so` adlı paylaşılan bir kitaplık olarak oluşturulur. `{name}`, bu java_binary kuralının `name` özelliğidir. Kullanılmayan kod, bu yapılandırmada bağlayıcı tarafından kaldırılmaz. Başka bir başlatıcı kullanıyorsanız yerel (C++) bağımlılıkları statik olarak `{name}_nativedeps` adlı bir ikili programa bağlanmıştır; burada `{name}` bu java_binary kuralının `name` özelliğidir. Böyle durumlarda bağlayıcı, kullanılmadığını düşündüğü kodları elde edilen ikili programdan kaldırır. Yani, yalnızca JNI aracılığıyla erişilen C++ kodları yalnızca `cc_library` hedefi `alwayslink = 1` değerini belirtiyor. Varsayılan JDK başlatıcı dışında herhangi bir başlatıcıyı kullanırken biçim, `*_deploy.jar` çıkış değişikliğinin sayısı. Temel konuları java_binary dokümanlarına göz atın.
`main_class`	`String; optional` Giriş noktası olarak kullanılacak `main()` yöntemine sahip sınıfın adı. Bir kural bu seçeneği kullanıyorsa `srcs=[...]` listesine ihtiyaç duymaz. Dolayısıyla, bu özellikle, önceden hazırlanmış bir Java kitaplığından yürütülebilir bir dosya bir veya daha fazla `main()` yöntemi içerir. Bu özelliğin değeri bir kaynak dosya değil, sınıf adıdır. Sınıf çalışma zamanında kullanılabilir: bu kural tarafından derlenmiş olabilir (`srcs` kaynağından) veya doğrudan veya geçişli bağımlılıklar tarafından sağlanan (`runtime_deps` veya `deps`). Sınıf kullanılamıyorsa ikili program çalışma zamanında başarısız olur. orada derleme zamanı denetimi yoktur.
`plugins`	`List of labels; optional` Derleme zamanında çalışacak Java derleyici eklentileri. Bu özellikte belirtilen her `java_plugin` bu kuralla birlikte çalıştırılır geliştirildi. Bir kitaplık, `exported_plugins` Kaynaklar oluşturulan dosya, bu kuralın ortaya çıkan jar'ına dahil edilir.
`resource_jars`	`List of labels; optional` Desteği sonlandırıldı: Bunun yerine java_import ve deps veyaworkspace_deps öğelerini kullanın.
`resource_strip_prefix`	`String; optional` Java kaynaklarından çıkarılacak yol ön eki. Belirtilirse bu yol öneki `resources` içindeki her dosyadan çıkarılır. özelliğini gönderin. Bu, kaynak dosyasının bu dizinde olmamasıyla ilgili bir hatadır. Değilse belirtildiğinde (varsayılan), kaynak dosyasının yolu yine aynı mantığını kaynak dosyalardan oluşan Java paketi olarak kullanır. Örneğin, `stuff/java/foo/bar/a.txt` şu şekilde konumlandırılacak: `foo/bar/a.txt`.
`runtime_deps`	`List of labels; optional` Son ikili program veya yalnızca çalışma zamanında test için kullanılacak kitaplıklar. Bunlar sıradan `deps` ürününde olduğu gibi çalışma zamanı sınıf yolunda görünür, ancak üzerinde çalışmalıdır. Yalnızca çalışma zamanında gereken bağımlılıklar burada görebilirsiniz. Bağımlılık analizi araçları, `runtime_deps` ve `deps`.
`stamp`	`Integer; optional; default is 0` Derleme bilgilerinin ikili programda kodlanıp kodlanmayacağını belirler. Olası değerler: `stamp = 1`: Derleme bilgilerini `--nostamp` derleme. Bu ayarından kaçınılmalıdır. Aksi takdirde, bu işlem ve buna bağımlı tüm aşağı akış işlemleri. `stamp = 0`: Derleme bilgilerini her zaman sabit değerlerle değiştirin. Bu iyi bir derleme sonucu önbelleğe alma sağlar. `stamp = -1`: Derleme bilgilerinin yerleştirilmesi `--[no]stamp` işaretidir. Bağımlılıkları değişmediği sürece damgalı ikili programlar yeniden oluşturulmaz.
`test_class`	`String; optional` Test çalıştırıcısı tarafından yüklenecek Java sınıfı. Varsayılan olarak, bu bağımsız değişken tanımlanmamışsa eski mod kullanılır ve bunun yerine test bağımsız değişkenleri kullanılır. `--nolegacy_bazel_java_test` işaretini ayarla ilk argümantan vazgeçmemeye çalışın. Bu özellik, çalıştırılacak bir Java sınıfının adını belirtir inceleyeceğiz. Bunun ayarlanması nadiren gerekir. Bu bağımsız değişken atlanırsa hedefin `name` ve dönüşüm değerleri kullanılarak kaynağa-köke göre görelim. Test, bilinen bir kaynak kök, `test_class` aşağıdaki durumlarda Bazel hata bildirir: ayarlanmamış. JUnit3 için test sınıfının `junit.framework.TestCase` veya herkese açık olması gerekiyor değeri döndüren statik `suite()` yöntemi `junit.framework.Test` (veya `Test` alt sınıfı). JUnit4 için, sınıfa `org.junit.runner.RunWith`. Bu özellik, birden fazla `java_test` kuralının aşağıdakileri yapmasına izin verir: aynı `Test` öğesini paylaş (`TestCase`, `TestSuite`, ...). Normal şartlarda ek bilginin iletildiğinden (ör. `jvm_flags=['-Dkey=value']` aracılığıyla) her durumda değişiklik gösterebilir, örneğin farklı bir alt kümesidir. Bu özellik, `javatests` ağacı dışındaki Java testleri.
`use_launcher`	`Boolean; optional; default is True` İkili programın özel bir başlatıcı kullanıp kullanmayacağı. Bu özellik false (yanlış) değerine ayarlanırsa Başlatıcı özelliğini ve ilgili `--java_launcher` işaretle bu hedef için yoksayılacak.
`use_testrunner`	`Boolean; optional; default is True` Test çalıştırıcısını kullan (varsayılan olarak `com.google.testing.junit.runner.BazelTestRunner`) sınıfını kullanın. ana giriş noktasını kullanabilir ve test sınıfını `bazel.test_suite` değeri olarak test koşucusuna atanır. sistem özelliğini etkinleştirmelisiniz. Varsayılan değeri geçersiz kılmak için bunu kullanabilirsiniz yardımcı olmak için test çalıştırıcısını kullanarak `java_test` kural, ve `java_binary` kuralları için kullanmayın. Düşük ihtimalle bunu yapmanız gerekir. Bir kullanım `AllTest` içindir başka bir kural tarafından çağrılan kurallar (veri tabanı ) girmeniz gerekir. `AllTest` kuralı `java_binary` olarak tanımlanmalıdır, ancak test çalıştırıcıyı ana giriş noktası olarak kullanmaya devam edebilirsiniz. Test çalıştırıcı sınıfının adı, `main_class` özelliğiyle geçersiz kılınabilir.

java_package_configuration

java_package_configuration(name, data, compatible_with, deprecation, distribs, features, javacopts, licenses, packages, restricted_to, tags, target_compatible_with, testonly, visibility)

Bir paket grubuna uygulanacak yapılandırma. Yapılandırmalar java_toolchain.javacopts sn.

Örnek:

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",
    ]
)

Bağımsız değişkenler

Özellikler
`name`	`Name; required` Bu hedef için benzersiz bir ad.
`data`	`List of labels; optional` Çalışma zamanında bu yapılandırma için gereken dosyaların listesi.
`javacopts`	`List of strings; optional` Java derleyici işaretleri.
`packages`	`List of labels; optional` `package_group` kümesi karar vermelisiniz.

java_plugin

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 tarafından çalıştırılan Java derleyicisi için eklentileri tanımlar. Şu anda, yalnızca desteklenen tür eklentileri ek açıklama işlemcileridir. java_library veya java_binary kuralı, plugins aracılığıyla eklentilere bağlı olarak eklentileri çalıştırabilir. özelliğini gönderin. Ayrıca java_library, eklentileri ona doğrudan bağımlıysa exported_plugins.

Dolaylı çıkış hedefleri

libname.jar: Bir Java arşivi.

Bağımsız değişkenler java_library ile aynıdır, ancak şu durumlar hariçtir: processor_class bağımsız değişkeninin eklenmesi gerekir.

Bağımsız değişkenler

Özellikler
`name`	`Name; required` Bu hedef için benzersiz bir ad.
`deps`	`List of labels; optional` Bu kitaplığa bağlanacak kitaplıkların listesi. `deps` ile ilgili genel yorumları şu adreste bulabilirsiniz: Genel özellikler çoğu derleme kuralına bakın. `deps` içinde listelenen `java_library` kuralları tarafından oluşturulan jar'lar açık olacak bu kuralın derleme zamanı sınıf yolu. Dahası, hizmet hesaplarının geçişli olarak kapatılması `deps`, `runtime_deps` ve `exports` şurada olacak: çalışma zamanı sınıf yolu. Buna karşılık, `data` özelliğindeki hedefler çalıştırma dosyalarına dahil edilir ancak hem derleme zamanında ne de çalışma zamanı sınıf yolundan yararlanır.
`srcs`	`List of labels; optional` Hedefi oluşturmak için işlenen kaynak dosyaların listesi. Bu özellik neredeyse her zaman gereklidir; aşağıdaki istisnalara bakın. `.java` türündeki kaynak dosyalar derlenir. Oluşturulması durumunda `.java` dosyalarına oluşturma kuralının adının eklenmesi genellikle önerilir buraya yerleştirin. Bu hem okunabilirliği artırmakla kalmaz hem de gelecekteki değişikliklere karşı daha dirençli hale getirir: oluşturan kural gelecekte farklı dosyalara ihtiyacınız varsa tek bir yeri düzeltmeniz gerekir: `outs` oluşturma kuralı. Oluşturma kuralını `deps` içinde listelememelisiniz. çünkü işlemsiz. `.srcjar` türündeki kaynak dosyalar paketten çıkarılır ve derlenir. (Bu, bir genrule dosyasıyla `.java` dosyaları oluşturmanız gerekir.) Kurallar: Kural (genellikle `genrule` veya `filegroup`) oluşturulursa yukarıda listelenen dosyalardan herhangi biri, dosyası olarak da kaydedebilir. Bu bağımsız değişken, `main_class` özelliği, sınıfını kullanmanız veya `runtime_deps` bağımsız değişkenini belirtmeniz gerekir.
`data`	`List of labels; optional` Çalışma zamanında bu kitaplığın ihtiyaç duyduğu dosyaların listesi. `data` ile ilgili genel yorumları şu adreste bulabilirsiniz: Genel özellikler çoğu derleme kuralına bakın. Bir `java_library` oluştururken Bazel bu dosyaları hiçbir yere koymaz; eğer `data` dosya oluşturulduktan sonra Bazel tarafından oluşturulur. Bir Bu teste dayalı bir test yöntemidir. `java_library` Bazel, `data` dosya, çalıştırma dosyaları alanına.
`resources`	`List of labels; optional` Java jar'a dahil edilecek veri dosyalarının listesi. Kaynaklar belirtilirse, normal kaynaklarla birlikte kavanozda paketlenir Derleme, `.class` dosya üretti. İçerideki kaynakların konumu proje yapısına göre belirlenir. Bazel ilk olarak Maven'in standart dizin düzenine benzerdir. (bir "src" dizini ve ardından bir "kaynaklar" dizini torunu). Bu durumda bulunduktan sonra Bazel, "Java" adlı en üstteki dizini veya "Javatests" gibi (yani, Örneğin, bir kaynak `<workspace root>/x/java/y/java/z` konumundaysa kaynağın yolu `y/java/z` olur. Bu buluşsal yöntem geçersiz kılınamaz. ancak `resource_strip_prefix` özelliği bir kaynak dosyalar için belirli bir alternatif dizindir. Kaynaklar, kaynak dosyalar veya oluşturulan dosyalar olabilir.
`generates_api`	`Boolean; optional; default is False` Bu özellik, API kodu oluşturan ek açıklama işlemcilerini işaretler. Bir kural, API oluşturan ek açıklama işlemcisi kullanıyorsa diğer kurallar kendileri oluşturulan koda yalnızca derleme işlemleri, oluşturma kuralından sonra programlanır. Bu özelliğinin değeri, Bazel'a --java_header_compilation etkin. UYARI: Bu özellik, derlemeyi yalnızca gerekli olduğunda kullanın.
`javacopts`	`List of strings; optional` Bu kitaplık için ek derleyici seçenekleri. "Değişken yap" değişikliğine tabi ve Bourne kabuk belirteçleme. Bu derleyici seçenekleri, genel derleyici seçeneklerinden sonra javac'a iletilir.
`neverlink`	`Boolean; optional; default is False` Bu kitaplığın çalışma zamanında değil yalnızca derleme için kullanılıp kullanılmayacağı. Kitaplık, yürütme sırasında çalışma zamanı ortamı tarafından sağlanacaksa kullanışlıdır. Örnekler IDE eklentileri için IDE API'leri veya her şey için `tools.jar` bu tür kitaplıklardan biridir çalışıyordum. `neverlink = 1` yönergesinin, derleyicinin materyali satır içine almasını engellemediğini unutmayın. tarafından izin verildiği şekilde, bu kitaplıktan alıp buna bağımlı derleme hedeflerine Dil Özellikleri (ör. `String` için `static final` sabit değer veya temel türlerde) ayırmaları gerekir. Bu nedenle tercih edilen kullanım alanı, çalışma zamanı kitaplığının ile aynı olacak. Çalışma zamanı kitaplığı, derleme kitaplığından farklıysa yalnızca JLS'nin derleyicilerin satır içi yapmasını yasakladığı (ve JLS'nin gelecekteki tüm sürümleri).
`output_licenses`	`Licence type; optional` Bkz. `common attributes`
`plugins`	`List of labels; optional` Derleme zamanında çalışacak Java derleyici eklentileri. Bu özellikte belirtilen her `java_plugin` bu kuralla birlikte çalıştırılır geliştirildi. Bir kitaplık, `exported_plugins` Kaynaklar oluşturulan dosya, bu kuralın ortaya çıkan jar'ına dahil edilir.
`processor_class`	`String; optional` İşlemci sınıfı, Java derleyicinin kullanması gereken tam sınıf türüdür. giriş noktası olarak kullanılır. Belirtilmezse bu kural Java derleyicinin ek açıklama işlemesine bir ek açıklama işlemcisi ekler, ancak çalışma zamanı sınıf yolu, derleyicinin ek açıklama işlemci yoluna dahil edilmeye devam eder. (Bu öncelikle tarafından kullanılmak üzere tasarlanmıştır. Yüklenen Error Prone eklentileri kullanarak ek açıklama işlemci yolundan java.util.ServiceLoader.)
`proguard_specs`	`List of labels; optional` ProGuard spesifikasyonu olarak kullanılacak dosyalar. Burada, ProGuard tarafından kullanılacak spesifikasyonlar açıklanır. Belirtilmişse bunlar, bu kitaplığa bağlı olarak herhangi bir `android_binary` hedefine eklenir. Buraya eklenen dosyalar sadece ideaklı kurallara, yani -dontnote, -dontwarn, yan etkileri ve -keep ile başlayan kuralları içerir. Diğer seçenekler yalnızca `android_binary` öğesinin proguard_specs (totoolojik olmayan birleştirmeler için)
`resource_jars`	`List of labels; optional` Desteği sonlandırıldı: Bunun yerine java_import ve deps veyaworkspace_deps öğelerini kullanın.
`resource_strip_prefix`	`String; optional` Java kaynaklarından çıkarılacak yol ön eki. Belirtilirse bu yol öneki `resources` içindeki her dosyadan çıkarılır. özelliğini gönderin. Bu, kaynak dosyasının bu dizinde olmamasıyla ilgili bir hatadır. Değilse belirtildiğinde (varsayılan), kaynak dosyasının yolu yine aynı mantığını kaynak dosyalardan oluşan Java paketi olarak kullanır. Örneğin, `stuff/java/foo/bar/a.txt` şu şekilde konumlandırılacak: `foo/bar/a.txt`.

java_runtime

java_runtime(name, srcs, compatible_with, deprecation, distribs, features, hermetic_srcs, java, java_home, lib_modules, licenses, restricted_to, tags, target_compatible_with, testonly, visibility)

Java çalışma zamanının yapılandırmasını belirtir.

Örnek:

java_runtime(
    name = "jdk-9-ea+153",
    srcs = glob(["jdk9-ea+153/**"]),
    java_home = "jdk9-ea+153",
)

Bağımsız değişkenler

Özellikler
`name`	`Name; required` Bu hedef için benzersiz bir ad.
`srcs`	`List of labels; optional` Çalışma zamanındaki tüm dosyalar.
`hermetic_srcs`	`List of labels; optional` Hermetik dağıtımlar için çalışma zamanındaki dosyalar.
`java`	`Label; optional` Java yürütülebilir dosyasının yolu.
`java_home`	`String; optional` Çalışma zamanının kök yolu. "Yap" konusuyla ilgili değişkeni ikame değerleridir. Bu yol mutlak ise kural, iyi bilinen ve hermetik olmayan bir Java çalışma zamanını yol'a dokunun. Bu durumda, `srcs` ve `java` özellikleri boş olmalıdır.
`lib_modules`	`Label; optional` Hermetik dağıtımlar için gerekli olan lib/modules dosyası.

java_toolchain

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_workers, javacopts, jvm_opts, licenses, oneversion, 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 derleyici yapılandırmasını belirtir. Kullanılacak araç zinciri, --java_toolchain bağımsız değişkenini kullanır. Normalde bu tür kuralları siz istemeden Java derleyicinizi ayarlayın.

Örnekler

Basit bir örnek şöyle olabilir:

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",
)

Bağımsız değişkenler

Özellikler
`name`	`Name; required` Bu hedef için benzersiz bir ad.
`android_lint_data`	`List of labels; optional` android_lint_jvm_opts sürümünde etiket genişletme için kullanılabilecek araçların etiketleri.
`android_lint_jvm_opts`	`List of strings; optional` Android Lint çağrılırken JVM için bağımsız değişkenlerin listesi.
`android_lint_opts`	`List of strings; optional` Android Lint bağımsız değişkenlerinin listesi.
`android_lint_package_configuration`	`List of labels; optional` Belirtilen paket gruplarına uygulanması gereken Android Lint Yapılandırması.
`android_lint_runner`	`Label; optional` Android Lint çalıştırıcısının etiketi (varsa).
`bootclasspath`	`List of labels; optional` Java hedef bootclasspath girişleri. javac'ın -bootclasspath işaretine karşılık gelir.
`deps_checker`	`List of labels; optional` ImportDepsChecker dağıtım jar'ının etiketi.
`forcibly_disable_header_compilation`	`Boolean; optional; default is False` Bunu yapmayan platformlarda başlık derlemesini devre dışı bırakmak için --java_header_compilation değerini geçersiz kılar desteklemeniz gerekir, örneğin, JDK 7 Bazel.
`genclass`	`List of labels; required` GenClass dağıtım jar'ının etiketi.
`header_compiler`	`List of labels; optional` Üst bilgi derleyici etiketi. --java_header_compilation özelliği etkinse gereklidir.
`header_compiler_direct`	`List of labels; optional` Şunu yapmayan doğrudan classpath işlemleri için kullanılacak başlık derleyicinin isteğe bağlı etiketi: API oluşturan ek açıklama işlemcileri eklemeyin. Bu araç, not işlemeyi desteklemez.
`ijar`	`List of labels; required` ijar yürütülebilir dosyasının etiketi.
`jacocorunner`	`Label; optional` JacocoCoverageRunner dağıtım jar'ının etiketi.
`java_runtime`	`Label; required` Bu araç zinciriyle kullanılacak java_runtime kodu. Varsayılan olarak java_runtime değerine ayarlanır. nasıl yapılandırılacakları hakkında daha fazla bilgi edinin.
`javabuilder`	`List of labels; required` JavaBuilder dağıtım deposunun etiketi.
`javabuilder_data`	`List of labels; optional` javabuilder_jvm_opts adresinde etiket genişletme için kullanılabilecek verilerin etiketleri.
`javabuilder_jvm_opts`	`List of strings; optional` JavaBuilder çağrılırken JVM için bağımsız değişkenlerin listesi.
`javac_supports_multiplex_workers`	`Boolean; optional; default is True` JavaBuilder, Multiplex kalıcı çalışanı olarak çalıştırmayı destekliyorsa doğru, desteklenmiyorsa false'tur.
`javac_supports_workers`	`Boolean; optional; default is True` JavaBuilder kalıcı çalışan olarak çalıştırmayı destekliyorsa doğru, desteklenmiyorsa false (yanlış) değerini alır.
`javacopts`	`List of strings; optional` Java derleyici için ekstra bağımsız değişkenlerin listesi. Lütfen Java derleyicisine bakın listesine göz atın.
`jvm_opts`	`List of strings; optional` Java derleyicisi çağrılırken JVM için bağımsız değişkenlerin listesi. Lütfen Java'ya bakın sanal makine dokümanlarına göz atın.
`oneversion`	`Label; optional` Tek sürümlü yaptırım ikili programının etiketi.
`oneversion_whitelist`	`Label; optional` Tek sürüm beyaz listesinin etiketi.
`package_configuration`	`List of labels; optional` Belirtilen paket gruplarına uygulanması gereken yapılandırma.
`proguard_allowlister`	`Label; optional; default is @bazel_tools//tools/jdk:proguard_whitelister` ProGuard izin verilenler listesinin etiketi.
`resourcejar`	`List of labels; optional` Yürütülebilir kaynak jar oluşturucunun etiketi.
`singlejar`	`List of labels; required` SingleJar dağıtım jar'ının etiketi.
`source_version`	`String; optional` Java kaynak sürümü (ör. "6" veya "7"). Hangi kod yapısı grubunu Java kaynak kodunda izin verilir.
`target_version`	`String; optional` Java hedef sürümü (ör. "6" veya "7"). Sınıfın hangi Java çalışma zamanı için olduğunu belirtir derlemeniz gerekir.
`timezone_data`	`Label; optional` Saat dilimi verilerini içeren bir kaynak jar'ının etiketi. Ayarlanırsa saat dilimi verileri tüm java_binary kurallarının dolaylı çalışma zamanı bağımlılığıdır.
`tools`	`List of labels; optional` jvm_opts öğesinde etiket genişletme için kullanılabilecek araçların etiketleri.
`turbine_data`	`List of labels; optional` turbine_jvm_opts konumunda etiket genişletme için kullanılabilecek veri etiketleri.
`turbine_jvm_opts`	`List of strings; optional` Türbin çağrılırken JVM için bağımsız değişkenlerin listesi.
`xlint`	`List of strings; optional` Varsayılan listeye eklenecek veya varsayılan listeden kaldırılacak uyarı listesi. Öncesinde tire işareti bulunan dosyayı kaldırır. Daha fazla bilgi için lütfen -Xlint seçenekleriyle ilgili Javac dokümanlarına bakın.