Aturan Java

Laporkan masalah Lihat sumber Nightly · 8.0 · 7.4 · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Aturan

• java_binary
• java_import
• java_library
• java_test
• java_package_configuration
• java_plugin
• java_runtime
• java_toolchain

java_binary

Melihat sumber aturan

java_binary(name, deps, srcs, data, resources, add_exports, add_opens, args, bootclasspath, 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, neverlink, output_licenses, plugins, resource_strip_prefix, restricted_to, runtime_deps, stamp, tags, target_compatible_with, testonly, toolchains, use_launcher, use_testrunner, visibility)

Mem-build arsip Java ("file jar"), serta skrip shell wrapper dengan nama yang sama dengan aturan. Skrip shell wrapper menggunakan classpath yang mencakup, antara lain, file jar untuk setiap library tempat biner bergantung. Saat menjalankan skrip shell wrapper, variabel lingkungan JAVABIN yang tidak kosong akan diprioritaskan daripada versi yang ditentukan melalui flag --java_runtime_version Bazel.

Skrip wrapper menerima beberapa flag unik. Lihat //src/main/java/com/google/devtools/build/lib/bazel/rules/java/java_stub_template.txt untuk mengetahui daftar flag yang dapat dikonfigurasi dan variabel lingkungan yang diterima oleh wrapper.

Target output implisit

• name.jar: Arsip Java, yang berisi file class dan resource lainnya yang sesuai dengan dependensi langsung biner.
• name-src.jar: Arsip yang berisi sumber ("jar sumber").
• name_deploy.jar: Arsip Java yang sesuai untuk deployment (hanya di-build jika diminta secara eksplisit).

  Mem-build target <name>_deploy.jar untuk aturan Anda akan membuat file jar mandiri dengan manifes yang memungkinkannya dijalankan dengan perintah java -jar atau dengan opsi --singlejar skrip wrapper. Menggunakan skrip wrapper lebih disukai daripada java -jar karena juga meneruskan flag JVM dan opsi untuk memuat library native.

  Jar deployment berisi semua class yang akan ditemukan oleh classloader yang menelusuri classpath dari skrip wrapper biner dari awal hingga akhir. Direktori ini juga berisi library native yang diperlukan untuk dependensi. Class ini otomatis dimuat ke JVM saat runtime.

  Jika target Anda menentukan atribut launcher, _deploy.jar akan menjadi biner native, bukan file JAR normal. File ini akan berisi peluncur serta dependensi native (C++) dari aturan Anda, yang semuanya ditautkan ke biner statis. Byte file jar yang sebenarnya akan ditambahkan ke biner native tersebut, sehingga membuat satu blob biner yang berisi kode yang dapat dieksekusi dan kode Java. Anda dapat mengeksekusi file jar yang dihasilkan secara langsung seperti Anda mengeksekusi biner native.

• name_deploy-src.jar: Arsip yang berisi sumber yang dikumpulkan dari penutupan transitif target. Class ini akan cocok dengan class di deploy.jar kecuali jika jar tidak memiliki jar sumber yang cocok.

Sebaiknya gunakan nama file sumber yang merupakan titik entri utama aplikasi (tanpa ekstensi). Misalnya, jika titik entri Anda disebut Main.java, nama Anda dapat berupa Main.

Atribut deps tidak diizinkan dalam aturan java_binary tanpa srcs; aturan tersebut memerlukan main_class yang disediakan oleh runtime_deps.

Cuplikan kode berikut mengilustrasikan kesalahan umum:

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

Sebagai gantinya, lakukan hal berikut:

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

Argumen

Atribut
name	Nama; wajib Nama unik untuk target ini.
deps	Daftar label; default-nya adalah [] Daftar library lain yang akan ditautkan ke target. Lihat komentar umum tentang deps di Atribut umum yang ditentukan oleh sebagian besar aturan build.
srcs	Daftar label; default-nya adalah [] Daftar file sumber yang diproses untuk membuat target. Atribut ini hampir selalu diperlukan; lihat pengecualian di bawah. File sumber jenis .java dikompilasi. Untuk file .java yang dihasilkan, sebaiknya masukkan nama aturan yang menghasilkan di sini, bukan nama file itu sendiri. Hal ini tidak hanya meningkatkan keterbacaan, tetapi juga membuat aturan lebih tahan terhadap perubahan di masa mendatang: jika aturan pembuatan menghasilkan file yang berbeda di masa mendatang, Anda hanya perlu memperbaiki satu tempat: outs dari aturan pembuatan. Anda tidak boleh mencantumkan aturan pembuatan di deps karena tidak ada operasi. File sumber jenis .srcjar diekstrak dan dikompilasi. (Hal ini berguna jika Anda perlu membuat serangkaian file .java dengan genrule.) Aturan: jika aturan (biasanya genrule atau filegroup) menghasilkan salah satu file yang tercantum di atas, file tersebut akan digunakan dengan cara yang sama seperti yang dijelaskan untuk file sumber. Argumen ini hampir selalu diperlukan, kecuali jika atribut main_class menentukan class di classpath runtime atau Anda menentukan argumen runtime_deps.
data	Daftar label; default-nya adalah [] Daftar file yang diperlukan oleh library ini saat runtime. Lihat komentar umum tentang data di Atribut umum yang ditentukan oleh sebagian besar aturan build.
resources	Daftar label; default-nya adalah [] Daftar file data yang akan disertakan dalam jar Java. Resource dapat berupa file sumber atau file yang dihasilkan. Jika ditentukan, resource akan dipaketkan dalam jar bersama dengan file .class biasa yang dihasilkan oleh kompilasi. Lokasi resource di dalam file jar ditentukan oleh struktur project. Bazel pertama-tama mencari tata letak direktori standar Maven, (direktori "src" diikuti dengan turunan direktori "resources"). Jika tidak ditemukan, Bazel akan mencari direktori teratas bernama "java" atau "javatests" (jadi, misalnya, jika resource berada di <workspace root>/x/java/y/java/z, jalur resource akan menjadi y/java/z. Heuristik ini tidak dapat diganti, tetapi atribut resource_strip_prefix dapat digunakan untuk menentukan direktori alternatif tertentu untuk file resource.
add_exports	Daftar string; default-nya adalah [] Izinkan library ini mengakses module atau package yang diberikan. Ini sesuai dengan flag javac dan JVM --add-exports=.
add_opens	Daftar string; default-nya adalah [] Izinkan library ini mengakses module atau package yang diberikan secara reflektif. Ini sesuai dengan flag javac dan JVM --add-opens=.
bootclasspath	Label; default-nya adalah None API terbatas, jangan gunakan!
classpath_resources	Daftar label; default-nya adalah [] JANGAN GUNAKAN OPSI INI KECUALI TIDAK ADA CARA LAIN) Daftar resource yang harus berada di root hierarki java. Satu-satunya tujuan atribut ini adalah untuk mendukung library pihak ketiga yang mewajibkan resource-nya ditemukan di classpath persis seperti "myconfig.xml". Hal ini hanya diizinkan pada biner, bukan library, karena bahaya konflik namespace.
create_executable	Boolean; default-nya adalah True Tidak digunakan lagi, sebagai gantinya gunakan java_single_jar.
deploy_env	Daftar label; default-nya adalah [] Daftar target java_binary lainnya yang mewakili lingkungan deployment untuk biner ini. Tetapkan atribut ini saat mem-build plugin yang akan dimuat oleh java_binary lain. Menetapkan atribut ini akan mengecualikan semua dependensi dari classpath runtime (dan jar deployment) dari biner ini yang dibagikan antara biner ini dan target yang ditentukan di deploy_env.
deploy_manifest_lines	Daftar string; default-nya adalah [] Daftar baris yang akan ditambahkan ke file META-INF/manifest.mf yang dihasilkan untuk target *_deploy.jar. Konten atribut ini tidak tunduk pada penggantian "Buat variabel".
javacopts	Daftar string; default-nya adalah [] Opsi compiler tambahan untuk biner ini. Tunduk pada penggantian "Make variable" dan tokenisasi shell Bourne. Opsi compiler ini diteruskan ke javac setelah opsi compiler global.
jvm_flags	Daftar string; default-nya adalah [] Daftar flag yang akan disematkan dalam skrip wrapper yang dibuat untuk menjalankan biner ini. Tunduk pada substitusi $(location) dan "Make variable", serta tokenisasi shell Bourne. Skrip wrapper untuk biner Java menyertakan definisi CLASSPATH (untuk menemukan semua jar dependen) dan memanggil penafsir Java yang tepat. Command line yang dihasilkan oleh skrip wrapper menyertakan nama class utama yang diikuti dengan "$@" sehingga Anda dapat meneruskan argumen lain setelah nama class. Namun, argumen yang dimaksudkan untuk penguraian oleh JVM harus ditentukan sebelum nama class di command line. Konten jvm_flags ditambahkan ke skrip wrapper sebelum nama class dicantumkan. Perhatikan bahwa atribut ini tidak berpengaruh pada output *_deploy.jar.
launcher	Label; default-nya adalah None Tentukan biner yang akan digunakan untuk menjalankan program Java, bukan program bin/java normal yang disertakan dengan JDK. Target harus berupa cc_binary. Setiap cc_binary yang menerapkan Java Invocation API dapat ditentukan sebagai nilai untuk atribut ini. Secara default, Bazel akan menggunakan peluncur JDK normal (bin/java atau java.exe). Flag Bazel --java_launcher terkait hanya memengaruhi target java_binary dan java_test yang belum menentukan atribut launcher. Perhatikan bahwa dependensi native (C++, SWIG, JNI) Anda akan di-build secara berbeda bergantung pada apakah Anda menggunakan peluncur JDK atau peluncur lain: Jika Anda menggunakan peluncur JDK normal (default), dependensi native di-build sebagai library bersama bernama {name}_nativedeps.so, dengan {name} adalah atribut name dari aturan java_binary ini. Kode yang tidak digunakan tidak dihapus oleh penaut dalam konfigurasi ini. Jika Anda menggunakan peluncur lain, dependensi native (C++) akan dihubungkan secara statis ke dalam biner bernama {name}_nativedeps, dengan {name} adalah atribut name dari aturan java_binary ini. Dalam hal ini, penaut akan menghapus kode apa pun yang dianggap tidak digunakan dari biner yang dihasilkan, yang berarti kode C++ apa pun yang diakses hanya melalui JNI mungkin tidak ditautkan kecuali target cc_library menentukan alwayslink = True. Saat menggunakan peluncur selain peluncur JDK default, format output *_deploy.jar akan berubah. Lihat dokumen java_binary utama untuk mengetahui detailnya.
main_class	String; default-nya adalah "" Nama class dengan metode main() yang akan digunakan sebagai titik entri. Jika menggunakan opsi ini, aturan tidak memerlukan daftar srcs=[...]. Dengan demikian, dengan atribut ini, seseorang dapat membuat file yang dapat dieksekusi dari library Java yang sudah berisi satu atau beberapa metode main(). Nilai atribut ini adalah nama class, bukan file sumber. Class harus tersedia saat runtime: class dapat dikompilasi oleh aturan ini (dari srcs) atau disediakan oleh dependensi langsung atau transitif (melalui runtime_deps atau deps). Jika class tidak tersedia, biner akan gagal saat runtime; tidak ada pemeriksaan waktu build.
neverlink	Boolean; default-nya adalah False
plugins	Daftar label; default-nya adalah [] Plugin compiler Java untuk dijalankan pada waktu kompilasi. Setiap java_plugin yang ditentukan dalam atribut ini akan dijalankan setiap kali aturan ini di-build. Library juga dapat mewarisi plugin dari dependensi yang menggunakan exported_plugins. Resource yang dihasilkan oleh plugin akan disertakan dalam jar yang dihasilkan dari aturan ini.
resource_strip_prefix	String; default-nya adalah "" Awalan jalur yang akan dihapus dari resource Java. Jika ditentukan, awalan jalur ini akan dihapus dari setiap file dalam atribut resources. File resource yang tidak berada di direktori ini akan mengalami error. Jika tidak ditentukan (default), jalur file resource ditentukan sesuai dengan logika yang sama dengan paket Java file sumber. Misalnya, file sumber di stuff/java/foo/bar/a.txt akan berada di foo/bar/a.txt.
runtime_deps	Daftar label; default-nya adalah [] Library yang akan tersedia untuk biner atau pengujian akhir hanya saat runtime. Seperti deps biasa, class ini akan muncul di classpath runtime, tetapi tidak seperti deps biasa, tidak muncul di classpath waktu kompilasi. Dependensi yang hanya diperlukan saat runtime harus tercantum di sini. Alat analisis dependensi harus mengabaikan target yang muncul di runtime_deps dan deps.
stamp	Bilangan bulat; default-nya adalah -1 Apakah akan mengenkode informasi build ke dalam biner. Nilai yang mungkin: stamp = 1: Selalu stempel informasi build ke dalam biner, bahkan dalam build --nostamp. Setelan ini harus dihindari, karena berpotensi menghentikan penyimpanan dalam cache jarak jauh untuk biner dan tindakan downstream apa pun yang bergantung padanya. stamp = 0: Selalu ganti informasi build dengan nilai konstan. Hal ini memberikan caching hasil build yang baik. stamp = -1: Penyematan informasi build dikontrol oleh flag --[no]stamp. Biner yang dicap tidak akan di-build ulang kecuali jika dependensinya berubah.
use_launcher	Boolean; default-nya adalah True Apakah biner harus menggunakan peluncur kustom. Jika atribut ini disetel ke salah (false), atribut launcher dan flag --java_launcher terkait akan diabaikan untuk target ini.
use_testrunner	Boolean; default-nya adalah False Gunakan class runner pengujian (com.google.testing.junit.runner.BazelTestRunner secara default) sebagai titik entri utama untuk program Java, dan berikan class pengujian ke runner pengujian sebagai nilai properti sistem bazel.test_suite. Anda dapat menggunakannya untuk mengganti perilaku default, yaitu menggunakan runner pengujian untuk aturan java_test, dan tidak menggunakannya untuk aturan java_binary. Anda mungkin tidak ingin melakukannya. Salah satu penggunaannya adalah untuk aturan AllTest yang dipanggil oleh aturan lain (misalnya, untuk menyiapkan database sebelum menjalankan pengujian). Aturan AllTest harus dideklarasikan sebagai java_binary, tetapi harus tetap menggunakan runner pengujian sebagai titik entri utamanya. Nama class runner pengujian dapat diganti dengan atribut main_class.

java_import

Melihat sumber aturan

java_import(name, deps, data, add_exports, add_opens, 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, toolchains, visibility)

Aturan ini memungkinkan penggunaan file .jar yang telah dikompilasi sebelumnya sebagai library untuk aturan java_library dan java_binary.

Contoh

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

Argumen

Atribut
name	Nama; wajib Nama unik untuk target ini.
deps	Daftar label; default-nya adalah [] Daftar library lain yang akan ditautkan ke target. Lihat java_library.deps.
data	Daftar label; default-nya adalah [] Daftar file yang diperlukan oleh aturan ini saat runtime.
add_exports	Daftar string; default-nya adalah [] Izinkan library ini mengakses module atau package yang diberikan. Ini sesuai dengan flag javac dan JVM --add-exports=.
add_opens	Daftar string; default-nya adalah [] Izinkan library ini mengakses module atau package yang diberikan secara reflektif. Ini sesuai dengan flag javac dan JVM --add-opens=.
constraints	Daftar string; default-nya adalah [] Batasan tambahan yang dikenakan pada aturan ini sebagai library Java.
exports	Daftar label; default-nya adalah [] Target yang akan disediakan untuk pengguna aturan ini. Lihat java_library.exports.
jars	Daftar label; wajib diisi Daftar file JAR yang disediakan ke target Java yang bergantung pada target ini.
neverlink	Boolean; default-nya adalah False Hanya gunakan library ini untuk kompilasi, bukan saat runtime. Berguna jika library akan disediakan oleh lingkungan runtime selama eksekusi. Contoh library seperti ini adalah IDE API untuk plugin IDE atau tools.jar untuk apa pun yang berjalan di JDK standar.
proguard_specs	Daftar label; default-nya adalah [] File yang akan digunakan sebagai spesifikasi Proguard. File ini akan menjelaskan kumpulan spesifikasi yang akan digunakan oleh Proguard. Jika ditentukan, target tersebut akan ditambahkan ke target android_binary apa pun yang bergantung pada library ini. File yang disertakan di sini hanya boleh memiliki aturan idempoten, yaitu -dontnote, -dontwarn, assumenosideeffects, dan aturan yang dimulai dengan -keep. Opsi lain hanya dapat muncul di proguard_specs android_binary, untuk memastikan penggabungan non-tautologis.
runtime_deps	Daftar label; default-nya adalah [] Library yang akan tersedia untuk biner atau pengujian akhir hanya saat runtime. Lihat java_library.runtime_deps.
srcjar	Label; default-nya adalah None File JAR yang berisi kode sumber untuk file JAR yang dikompilasi.

java_library

Melihat sumber aturan

java_library(name, deps, srcs, data, resources, add_exports, add_opens, bootclasspath, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, exported_plugins, exports, features, javabuilder_jvm_flags, javacopts, licenses, neverlink, plugins, proguard_specs, resource_strip_prefix, restricted_to, runtime_deps, tags, target_compatible_with, testonly, toolchains, visibility)

Aturan ini mengompilasi dan menautkan sumber ke dalam file .jar.

Output implisit

• libname.jar: Arsip Java yang berisi file class.
• libname-src.jar: Arsip yang berisi sumber ("jar sumber").

Argumen

Atribut
name	Nama; wajib Nama unik untuk target ini.
deps	Daftar label; default-nya adalah [] Daftar library yang akan ditautkan ke library ini. Lihat komentar umum tentang deps di Atribut umum yang ditentukan oleh sebagian besar aturan build. Jar yang dibuat oleh aturan java_library yang tercantum di deps akan berada di classpath waktu kompilasi aturan ini. Selain itu, penutupan transitif deps, runtime_deps, dan exports akan berada di classpath runtime. Sebaliknya, target dalam atribut data disertakan dalam runfile, tetapi tidak pada classpath waktu kompilasi atau runtime.
srcs	Daftar label; default-nya adalah [] Daftar file sumber yang diproses untuk membuat target. Atribut ini hampir selalu diperlukan; lihat pengecualian di bawah. File sumber jenis .java dikompilasi. Untuk file .java yang dihasilkan, sebaiknya masukkan nama aturan yang menghasilkan di sini, bukan nama file itu sendiri. Hal ini tidak hanya meningkatkan keterbacaan, tetapi juga membuat aturan lebih tahan terhadap perubahan di masa mendatang: jika aturan pembuatan menghasilkan file yang berbeda di masa mendatang, Anda hanya perlu memperbaiki satu tempat: outs dari aturan pembuatan. Anda tidak boleh mencantumkan aturan pembuatan di deps karena tidak ada operasi. File sumber jenis .srcjar diekstrak dan dikompilasi. (Hal ini berguna jika Anda perlu membuat serangkaian file .java dengan genrule.) Aturan: jika aturan (biasanya genrule atau filegroup) menghasilkan salah satu file yang tercantum di atas, file tersebut akan digunakan dengan cara yang sama seperti yang dijelaskan untuk file sumber. File sumber jenis .properties diperlakukan sebagai resource. Semua file lainnya akan diabaikan, selama ada setidaknya satu file dari jenis file yang dijelaskan di atas. Jika tidak, error akan ditampilkan. Argumen ini hampir selalu diperlukan, kecuali jika Anda menentukan argumen runtime_deps.
data	Daftar label; default-nya adalah [] Daftar file yang diperlukan oleh library ini saat runtime. Lihat komentar umum tentang data di Atribut umum yang ditentukan oleh sebagian besar aturan build. Saat mem-build java_library, Bazel tidak menempatkan file ini di mana pun; jika file data adalah file yang dihasilkan, Bazel akan membuatnya. Saat mem-build pengujian yang bergantung pada java_library ini, Bazel akan menyalin atau menautkan file data ke area runfile.
resources	Daftar label; default-nya adalah [] Daftar file data yang akan disertakan dalam jar Java. Resource dapat berupa file sumber atau file yang dihasilkan. Jika ditentukan, resource akan dipaketkan dalam jar bersama dengan file .class biasa yang dihasilkan oleh kompilasi. Lokasi resource di dalam file jar ditentukan oleh struktur project. Bazel pertama-tama mencari tata letak direktori standar Maven, (direktori "src" diikuti dengan turunan direktori "resources"). Jika tidak ditemukan, Bazel akan mencari direktori teratas bernama "java" atau "javatests" (jadi, misalnya, jika resource berada di <workspace root>/x/java/y/java/z, jalur resource akan menjadi y/java/z. Heuristik ini tidak dapat diganti, tetapi atribut resource_strip_prefix dapat digunakan untuk menentukan direktori alternatif tertentu untuk file resource.
add_exports	Daftar string; default-nya adalah [] Izinkan library ini mengakses module atau package yang diberikan. Ini sesuai dengan flag javac dan JVM --add-exports=.
add_opens	Daftar string; default-nya adalah [] Izinkan library ini mengakses module atau package yang diberikan secara reflektif. Ini sesuai dengan flag javac dan JVM --add-opens=.
bootclasspath	Label; default-nya adalah None API terbatas, jangan gunakan!
exported_plugins	Daftar label; default-nya adalah [] Daftar java_plugin (misalnya, pemroses anotasi) untuk diekspor ke library yang secara langsung bergantung pada library ini. Daftar java_plugin yang ditentukan akan diterapkan ke library apa pun yang secara langsung bergantung pada library ini, sama seperti library tersebut telah mendeklarasikan label ini secara eksplisit di plugins.
exports	Daftar label; default-nya adalah [] Library yang diekspor. Mencantumkan aturan di sini akan membuatnya tersedia untuk aturan induk, seolah-olah induk secara eksplisit bergantung pada aturan ini. Hal ini tidak berlaku untuk deps reguler (tidak diekspor). Ringkasan: aturan X dapat mengakses kode di Y jika ada jalur dependensi di antara keduanya yang dimulai dengan tepi deps, diikuti dengan nol atau beberapa tepi exports. Mari kita lihat beberapa contoh untuk menggambarkan hal ini. Asumsikan A bergantung pada B dan B bergantung pada C. Dalam hal ini, C adalah dependensi transitif dari A, sehingga mengubah sumber C dan mem-build ulang A akan mem-build ulang semuanya dengan benar. Namun, A tidak akan dapat menggunakan class di C. Untuk mengizinkan hal itu, A harus mendeklarasikan C dalam deps-nya, atau B dapat mempermudah A (dan apa pun yang mungkin bergantung pada A) dengan mendeklarasikan C dalam atribut exports (B). Penutupan library yang diekspor tersedia untuk semua aturan induk langsung. Ambil contoh yang sedikit berbeda: A bergantung pada B, B bergantung pada C dan D, dan juga mengekspor C, tetapi tidak mengekspor D. Sekarang A memiliki akses ke C, tetapi tidak ke D. Sekarang, jika C dan D mengekspor beberapa library, yaitu C' dan D', A hanya dapat mengakses C', tetapi tidak dapat mengakses D'. Penting: aturan yang diekspor bukan merupakan dependensi reguler. Sesuai dengan contoh sebelumnya, jika B mengekspor C dan juga ingin menggunakan C, B harus mencantumkannya dalam deps-nya sendiri.
javabuilder_jvm_flags	Daftar string; default-nya adalah [] API terbatas, jangan gunakan!
javacopts	Daftar string; default-nya adalah [] Opsi compiler tambahan untuk library ini. Tunduk pada penggantian "Make variable" dan tokenisasi shell Bourne. Opsi compiler ini diteruskan ke javac setelah opsi compiler global.
neverlink	Boolean; default-nya adalah False Apakah library ini hanya boleh digunakan untuk kompilasi dan bukan saat runtime. Berguna jika library akan disediakan oleh lingkungan runtime selama eksekusi. Contoh library tersebut adalah IDE API untuk plugin IDE atau tools.jar untuk apa pun yang berjalan di JDK standar. Perhatikan bahwa neverlink = True tidak mencegah compiler menyisipkan materi dari library ini ke dalam target kompilasi yang bergantung padanya, sebagaimana diizinkan oleh Spesifikasi Bahasa Java (misalnya, Konstanta static final dari String atau jenis primitif). Oleh karena itu, kasus penggunaan yang lebih disukai adalah saat library runtime identik dengan library kompilasi. Jika library runtime berbeda dengan library kompilasi, Anda harus memastikan bahwa library tersebut hanya berbeda di tempat JLS melarang compiler untuk melakukan inline (dan hal ini harus berlaku untuk semua versi JLS mendatang).
plugins	Daftar label; default-nya adalah [] Plugin compiler Java untuk dijalankan pada waktu kompilasi. Setiap java_plugin yang ditentukan dalam atribut ini akan dijalankan setiap kali aturan ini di-build. Library juga dapat mewarisi plugin dari dependensi yang menggunakan exported_plugins. Resource yang dihasilkan oleh plugin akan disertakan dalam jar yang dihasilkan dari aturan ini.
proguard_specs	Daftar label; default-nya adalah [] File yang akan digunakan sebagai spesifikasi Proguard. File ini akan menjelaskan kumpulan spesifikasi yang akan digunakan oleh Proguard. Jika ditentukan, target tersebut akan ditambahkan ke target android_binary apa pun yang bergantung pada library ini. File yang disertakan di sini hanya boleh memiliki aturan idempoten, yaitu -dontnote, -dontwarn, assumenosideeffects, dan aturan yang dimulai dengan -keep. Opsi lain hanya dapat muncul di proguard_specs android_binary, untuk memastikan penggabungan non-tautologis.
resource_strip_prefix	String; default-nya adalah "" Awalan jalur yang akan dihapus dari resource Java. Jika ditentukan, awalan jalur ini akan dihapus dari setiap file dalam atribut resources. File resource yang tidak berada di direktori ini akan mengalami error. Jika tidak ditentukan (default), jalur file resource ditentukan sesuai dengan logika yang sama dengan paket Java file sumber. Misalnya, file sumber di stuff/java/foo/bar/a.txt akan berada di foo/bar/a.txt.
runtime_deps	Daftar label; default-nya adalah [] Library yang akan tersedia untuk biner atau pengujian akhir hanya saat runtime. Seperti deps biasa, class ini akan muncul di classpath runtime, tetapi tidak seperti deps biasa, tidak muncul di classpath waktu kompilasi. Dependensi yang hanya diperlukan saat runtime harus tercantum di sini. Alat analisis dependensi harus mengabaikan target yang muncul di runtime_deps dan deps.

java_test

Melihat sumber aturan

java_test(name, deps, srcs, data, resources, add_exports, add_opens, args, bootclasspath, 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, neverlink, plugins, 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)

Aturan java_test() mengompilasi pengujian Java. Pengujian adalah wrapper biner di sekitar kode pengujian Anda. Metode utama runner pengujian dipanggil, bukan class utama yang dikompilasi.

Target output implisit

• name.jar: Arsip Java.
• name_deploy.jar: Arsip Java yang cocok untuk deployment. (Hanya di-build jika diminta secara eksplisit.) Lihat deskripsi output name_deploy.jar dari java_binary untuk mengetahui detail selengkapnya.

Lihat bagian tentang argumen java_binary(). Aturan ini juga mendukung semua atribut yang umum untuk semua aturan pengujian (*_test).

Contoh

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

Argumen

Atribut
name	Nama; wajib Nama unik untuk target ini.
deps	Daftar label; default-nya adalah [] Daftar library lain yang akan ditautkan ke target. Lihat komentar umum tentang deps di Atribut umum yang ditentukan oleh sebagian besar aturan build.
srcs	Daftar label; default-nya adalah [] Daftar file sumber yang diproses untuk membuat target. Atribut ini hampir selalu diperlukan; lihat pengecualian di bawah. File sumber jenis .java dikompilasi. Untuk file .java yang dihasilkan, sebaiknya masukkan nama aturan yang menghasilkan di sini, bukan nama file itu sendiri. Hal ini tidak hanya meningkatkan keterbacaan, tetapi juga membuat aturan lebih tahan terhadap perubahan di masa mendatang: jika aturan pembuatan menghasilkan file yang berbeda di masa mendatang, Anda hanya perlu memperbaiki satu tempat: outs dari aturan pembuatan. Anda tidak boleh mencantumkan aturan pembuatan di deps karena tidak ada operasi. File sumber jenis .srcjar diekstrak dan dikompilasi. (Hal ini berguna jika Anda perlu membuat serangkaian file .java dengan genrule.) Aturan: jika aturan (biasanya genrule atau filegroup) menghasilkan salah satu file yang tercantum di atas, file tersebut akan digunakan dengan cara yang sama seperti yang dijelaskan untuk file sumber. Argumen ini hampir selalu diperlukan, kecuali jika atribut main_class menentukan class di classpath runtime atau Anda menentukan argumen runtime_deps.
data	Daftar label; default-nya adalah [] Daftar file yang diperlukan oleh library ini saat runtime. Lihat komentar umum tentang data di Atribut umum yang ditentukan oleh sebagian besar aturan build.
resources	Daftar label; default-nya adalah [] Daftar file data yang akan disertakan dalam jar Java. Resource dapat berupa file sumber atau file yang dihasilkan. Jika ditentukan, resource akan dipaketkan dalam jar bersama dengan file .class biasa yang dihasilkan oleh kompilasi. Lokasi resource di dalam file jar ditentukan oleh struktur project. Bazel pertama-tama mencari tata letak direktori standar Maven, (direktori "src" diikuti dengan turunan direktori "resources"). Jika tidak ditemukan, Bazel akan mencari direktori teratas bernama "java" atau "javatests" (jadi, misalnya, jika resource berada di <workspace root>/x/java/y/java/z, jalur resource akan menjadi y/java/z. Heuristik ini tidak dapat diganti, tetapi atribut resource_strip_prefix dapat digunakan untuk menentukan direktori alternatif tertentu untuk file resource.
add_exports	Daftar string; default-nya adalah [] Izinkan library ini mengakses module atau package yang diberikan. Ini sesuai dengan flag javac dan JVM --add-exports=.
add_opens	Daftar string; default-nya adalah [] Izinkan library ini mengakses module atau package yang diberikan secara reflektif. Ini sesuai dengan flag javac dan JVM --add-opens=.
bootclasspath	Label; default-nya adalah None API terbatas, jangan gunakan!
classpath_resources	Daftar label; default-nya adalah [] JANGAN GUNAKAN OPSI INI KECUALI TIDAK ADA CARA LAIN) Daftar resource yang harus berada di root hierarki java. Satu-satunya tujuan atribut ini adalah untuk mendukung library pihak ketiga yang mewajibkan resource-nya ditemukan di classpath persis seperti "myconfig.xml". Hal ini hanya diizinkan pada biner, bukan library, karena bahaya konflik namespace.
create_executable	Boolean; default-nya adalah True Tidak digunakan lagi, sebagai gantinya gunakan java_single_jar.
deploy_manifest_lines	Daftar string; default-nya adalah [] Daftar baris yang akan ditambahkan ke file META-INF/manifest.mf yang dihasilkan untuk target *_deploy.jar. Konten atribut ini tidak tunduk pada penggantian "Buat variabel".
javacopts	Daftar string; default-nya adalah [] Opsi compiler tambahan untuk biner ini. Tunduk pada penggantian "Make variable" dan tokenisasi shell Bourne. Opsi compiler ini diteruskan ke javac setelah opsi compiler global.
jvm_flags	Daftar string; default-nya adalah [] Daftar flag yang akan disematkan dalam skrip wrapper yang dibuat untuk menjalankan biner ini. Tunduk pada substitusi $(location) dan "Make variable", serta tokenisasi shell Bourne. Skrip wrapper untuk biner Java menyertakan definisi CLASSPATH (untuk menemukan semua jar dependen) dan memanggil penafsir Java yang tepat. Command line yang dihasilkan oleh skrip wrapper menyertakan nama class utama yang diikuti dengan "$@" sehingga Anda dapat meneruskan argumen lain setelah nama class. Namun, argumen yang dimaksudkan untuk penguraian oleh JVM harus ditentukan sebelum nama class di command line. Konten jvm_flags ditambahkan ke skrip wrapper sebelum nama class dicantumkan. Perhatikan bahwa atribut ini tidak berpengaruh pada output *_deploy.jar.
launcher	Label; default-nya adalah None Tentukan biner yang akan digunakan untuk menjalankan program Java, bukan program bin/java normal yang disertakan dengan JDK. Target harus berupa cc_binary. Setiap cc_binary yang menerapkan Java Invocation API dapat ditentukan sebagai nilai untuk atribut ini. Secara default, Bazel akan menggunakan peluncur JDK normal (bin/java atau java.exe). Flag Bazel --java_launcher terkait hanya memengaruhi target java_binary dan java_test yang belum menentukan atribut launcher. Perhatikan bahwa dependensi native (C++, SWIG, JNI) Anda akan di-build secara berbeda bergantung pada apakah Anda menggunakan peluncur JDK atau peluncur lain: Jika Anda menggunakan peluncur JDK normal (default), dependensi native di-build sebagai library bersama bernama {name}_nativedeps.so, dengan {name} adalah atribut name dari aturan java_binary ini. Kode yang tidak digunakan tidak dihapus oleh penaut dalam konfigurasi ini. Jika Anda menggunakan peluncur lain, dependensi native (C++) akan dihubungkan secara statis ke dalam biner bernama {name}_nativedeps, dengan {name} adalah atribut name dari aturan java_binary ini. Dalam hal ini, penaut akan menghapus kode apa pun yang dianggap tidak digunakan dari biner yang dihasilkan, yang berarti kode C++ apa pun yang diakses hanya melalui JNI mungkin tidak ditautkan kecuali target cc_library menentukan alwayslink = True. Saat menggunakan peluncur selain peluncur JDK default, format output *_deploy.jar akan berubah. Lihat dokumen java_binary utama untuk mengetahui detailnya.
main_class	String; default-nya adalah "" Nama class dengan metode main() yang akan digunakan sebagai titik entri. Jika menggunakan opsi ini, aturan tidak memerlukan daftar srcs=[...]. Dengan demikian, dengan atribut ini, seseorang dapat membuat file yang dapat dieksekusi dari library Java yang sudah berisi satu atau beberapa metode main(). Nilai atribut ini adalah nama class, bukan file sumber. Class harus tersedia saat runtime: class dapat dikompilasi oleh aturan ini (dari srcs) atau disediakan oleh dependensi langsung atau transitif (melalui runtime_deps atau deps). Jika class tidak tersedia, biner akan gagal saat runtime; tidak ada pemeriksaan waktu build.
neverlink	Boolean; default-nya adalah False
plugins	Daftar label; default-nya adalah [] Plugin compiler Java untuk dijalankan pada waktu kompilasi. Setiap java_plugin yang ditentukan dalam atribut ini akan dijalankan setiap kali aturan ini di-build. Library juga dapat mewarisi plugin dari dependensi yang menggunakan exported_plugins. Resource yang dihasilkan oleh plugin akan disertakan dalam jar yang dihasilkan dari aturan ini.
resource_strip_prefix	String; default-nya adalah "" Awalan jalur yang akan dihapus dari resource Java. Jika ditentukan, awalan jalur ini akan dihapus dari setiap file dalam atribut resources. File resource yang tidak berada di direktori ini akan mengalami error. Jika tidak ditentukan (default), jalur file resource ditentukan sesuai dengan logika yang sama dengan paket Java file sumber. Misalnya, file sumber di stuff/java/foo/bar/a.txt akan berada di foo/bar/a.txt.
runtime_deps	Daftar label; default-nya adalah [] Library yang akan tersedia untuk biner atau pengujian akhir hanya saat runtime. Seperti deps biasa, class ini akan muncul di classpath runtime, tetapi tidak seperti deps biasa, tidak muncul di classpath waktu kompilasi. Dependensi yang hanya diperlukan saat runtime harus tercantum di sini. Alat analisis dependensi harus mengabaikan target yang muncul di runtime_deps dan deps.
stamp	Bilangan bulat; default-nya adalah 0 Apakah akan mengenkode informasi build ke dalam biner. Nilai yang mungkin: stamp = 1: Selalu stempel informasi build ke dalam biner, bahkan dalam build --nostamp. Setelan ini harus dihindari, karena berpotensi menghentikan penyimpanan dalam cache jarak jauh untuk biner dan tindakan downstream apa pun yang bergantung padanya. stamp = 0: Selalu ganti informasi build dengan nilai konstan. Hal ini memberikan caching hasil build yang baik. stamp = -1: Penyematan informasi build dikontrol oleh flag --[no]stamp. Biner yang dicap tidak akan di-build ulang kecuali jika dependensinya berubah.
test_class	String; default-nya adalah "" Class Java yang akan dimuat oleh runner pengujian. Secara default, jika argumen ini tidak ditentukan, mode lama akan digunakan dan argumen pengujian akan digunakan. Tetapkan tanda --nolegacy_bazel_java_test agar tidak kembali ke argumen pertama. Atribut ini menentukan nama class Java yang akan dijalankan oleh pengujian ini. Anda jarang perlu menetapkannya. Jika dihilangkan, argumen ini akan disimpulkan menggunakan name target dan jalur relatif root sumbernya. Jika pengujian berada di luar root sumber yang diketahui, Bazel akan melaporkan error jika test_class tidak ditetapkan. Untuk JUnit3, class pengujian harus berupa subclass dari junit.framework.TestCase atau harus memiliki metode suite() statis publik yang menampilkan junit.framework.Test (atau subclass dari Test). Untuk JUnit4, class harus dianotasi dengan org.junit.runner.RunWith. Atribut ini memungkinkan beberapa aturan java_test untuk berbagi Test yang sama (TestCase, TestSuite, ...). Biasanya, informasi tambahan diteruskan ke atribut tersebut (misalnya melalui jvm_flags=['-Dkey=value']) sehingga perilakunya berbeda dalam setiap kasus, seperti menjalankan subset pengujian yang berbeda. Atribut ini juga memungkinkan penggunaan pengujian Java di luar hierarki javatests.
use_launcher	Boolean; default-nya adalah True Apakah biner harus menggunakan peluncur kustom. Jika atribut ini disetel ke salah (false), atribut launcher dan flag --java_launcher terkait akan diabaikan untuk target ini.
use_testrunner	Boolean; default-nya adalah True Gunakan class runner pengujian (com.google.testing.junit.runner.BazelTestRunner secara default) sebagai titik entri utama untuk program Java, dan berikan class pengujian ke runner pengujian sebagai nilai properti sistem bazel.test_suite. Anda dapat menggunakannya untuk mengganti perilaku default, yaitu menggunakan runner pengujian untuk aturan java_test, dan tidak menggunakannya untuk aturan java_binary. Anda mungkin tidak ingin melakukannya. Salah satu penggunaannya adalah untuk aturan AllTest yang dipanggil oleh aturan lain (misalnya, untuk menyiapkan database sebelum menjalankan pengujian). Aturan AllTest harus dideklarasikan sebagai java_binary, tetapi harus tetap menggunakan runner pengujian sebagai titik entri utamanya. Nama class runner pengujian dapat diganti dengan atribut main_class.

java_package_configuration

Melihat sumber aturan

java_package_configuration(name, data, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, javacopts, output_licenses, packages, restricted_to, system, tags, target_compatible_with, testonly, toolchains, visibility)

Konfigurasi yang akan diterapkan ke kumpulan paket. Konfigurasi dapat ditambahkan ke java_toolchain.javacopts.

Contoh:

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

Argumen

Atribut
name	Nama; wajib Nama unik untuk target ini.
data	Daftar label; default-nya adalah [] Daftar file yang diperlukan oleh konfigurasi ini saat runtime.
javacopts	Daftar string; default-nya adalah [] Flag compiler Java.
output_licenses	Daftar string; default-nya adalah []
packages	Daftar label; default-nya adalah [] Kumpulan package_group yang akan menjadi tempat penerapan konfigurasi.
system	Label; default-nya adalah None Bersesuaian dengan flag --system javac.

java_plugin

Melihat sumber aturan

java_plugin(name, deps, srcs, data, resources, add_exports, add_opens, bootclasspath, compatible_with, deprecation, distribs, exec_compatible_with, exec_properties, features, generates_api, javabuilder_jvm_flags, javacopts, licenses, neverlink, output_licenses, plugins, processor_class, proguard_specs, resource_strip_prefix, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility)

java_plugin menentukan plugin untuk compiler Java yang dijalankan oleh Bazel. Jenis plugin yang didukung hanyalah pemroses anotasi. Aturan java_library atau java_binary dapat menjalankan plugin dengan bergantung pada plugin tersebut melalui atribut plugins. java_library juga dapat otomatis mengekspor plugin ke library yang secara langsung bergantung padanya menggunakan exported_plugins.

Target output implisit

• libname.jar: Arsip Java.

Argumen identik dengan java_library, kecuali penambahan argumen processor_class.

Argumen

Atribut
name	Nama; wajib Nama unik untuk target ini.
deps	Daftar label; default-nya adalah [] Daftar library yang akan ditautkan ke library ini. Lihat komentar umum tentang deps di Atribut umum yang ditentukan oleh sebagian besar aturan build. Jar yang dibuat oleh aturan java_library yang tercantum di deps akan berada di classpath waktu kompilasi aturan ini. Selain itu, penutupan transitif deps, runtime_deps, dan exports akan berada di classpath runtime. Sebaliknya, target dalam atribut data disertakan dalam runfile, tetapi tidak pada classpath waktu kompilasi atau runtime.
srcs	Daftar label; default-nya adalah [] Daftar file sumber yang diproses untuk membuat target. Atribut ini hampir selalu diperlukan; lihat pengecualian di bawah. File sumber jenis .java dikompilasi. Untuk file .java yang dihasilkan, sebaiknya masukkan nama aturan yang menghasilkan di sini, bukan nama file itu sendiri. Hal ini tidak hanya meningkatkan keterbacaan, tetapi juga membuat aturan lebih tahan terhadap perubahan di masa mendatang: jika aturan pembuatan menghasilkan file yang berbeda di masa mendatang, Anda hanya perlu memperbaiki satu tempat: outs dari aturan pembuatan. Anda tidak boleh mencantumkan aturan pembuatan di deps karena tidak ada operasi. File sumber jenis .srcjar diekstrak dan dikompilasi. (Hal ini berguna jika Anda perlu membuat serangkaian file .java dengan genrule.) Aturan: jika aturan (biasanya genrule atau filegroup) menghasilkan salah satu file yang tercantum di atas, file tersebut akan digunakan dengan cara yang sama seperti yang dijelaskan untuk file sumber. File sumber jenis .properties diperlakukan sebagai resource. Semua file lainnya akan diabaikan, selama ada setidaknya satu file dari jenis file yang dijelaskan di atas. Jika tidak, error akan ditampilkan. Argumen ini hampir selalu diperlukan, kecuali jika Anda menentukan argumen runtime_deps.
data	Daftar label; default-nya adalah [] Daftar file yang diperlukan oleh library ini saat runtime. Lihat komentar umum tentang data di Atribut umum yang ditentukan oleh sebagian besar aturan build. Saat mem-build java_library, Bazel tidak menempatkan file ini di mana pun; jika file data adalah file yang dihasilkan, Bazel akan membuatnya. Saat mem-build pengujian yang bergantung pada java_library ini, Bazel akan menyalin atau menautkan file data ke area runfile.
resources	Daftar label; default-nya adalah [] Daftar file data yang akan disertakan dalam jar Java. Resource dapat berupa file sumber atau file yang dihasilkan. Jika ditentukan, resource akan dipaketkan dalam jar bersama dengan file .class biasa yang dihasilkan oleh kompilasi. Lokasi resource di dalam file jar ditentukan oleh struktur project. Bazel pertama-tama mencari tata letak direktori standar Maven, (direktori "src" diikuti dengan turunan direktori "resources"). Jika tidak ditemukan, Bazel akan mencari direktori teratas bernama "java" atau "javatests" (jadi, misalnya, jika resource berada di <workspace root>/x/java/y/java/z, jalur resource akan menjadi y/java/z. Heuristik ini tidak dapat diganti, tetapi atribut resource_strip_prefix dapat digunakan untuk menentukan direktori alternatif tertentu untuk file resource.
add_exports	Daftar string; default-nya adalah [] Izinkan library ini mengakses module atau package yang diberikan. Ini sesuai dengan flag javac dan JVM --add-exports=.
add_opens	Daftar string; default-nya adalah [] Izinkan library ini mengakses module atau package yang diberikan secara reflektif. Ini sesuai dengan flag javac dan JVM --add-opens=.
bootclasspath	Label; default-nya adalah None API terbatas, jangan gunakan!
generates_api	Boolean; default-nya adalah False Atribut ini menandai pemroses anotasi yang menghasilkan kode API. Jika aturan menggunakan pemroses anotasi pembuat API, aturan lain yang bergantung padanya hanya dapat merujuk ke kode yang dihasilkan jika tindakan kompilasi dijadwalkan setelah aturan pembuat. Atribut ini menginstruksikan Bazel untuk memperkenalkan batasan penjadwalan saat --java_header_compilation diaktifkan. PERINGATAN: Atribut ini memengaruhi performa build, gunakan hanya jika diperlukan.
javabuilder_jvm_flags	Daftar string; default-nya adalah [] API terbatas, jangan gunakan!
javacopts	Daftar string; default-nya adalah [] Opsi compiler tambahan untuk library ini. Tunduk pada penggantian "Make variable" dan tokenisasi shell Bourne. Opsi compiler ini diteruskan ke javac setelah opsi compiler global.
neverlink	Boolean; default-nya adalah False Apakah library ini hanya boleh digunakan untuk kompilasi dan bukan saat runtime. Berguna jika library akan disediakan oleh lingkungan runtime selama eksekusi. Contoh library tersebut adalah IDE API untuk plugin IDE atau tools.jar untuk apa pun yang berjalan di JDK standar. Perhatikan bahwa neverlink = True tidak mencegah compiler menyisipkan materi dari library ini ke dalam target kompilasi yang bergantung padanya, sebagaimana diizinkan oleh Spesifikasi Bahasa Java (misalnya, Konstanta static final dari String atau jenis primitif). Oleh karena itu, kasus penggunaan yang lebih disukai adalah saat library runtime identik dengan library kompilasi. Jika library runtime berbeda dengan library kompilasi, Anda harus memastikan bahwa library tersebut hanya berbeda di tempat JLS melarang compiler untuk melakukan inline (dan hal ini harus berlaku untuk semua versi JLS mendatang).
output_licenses	Daftar string; default-nya adalah []
plugins	Daftar label; default-nya adalah [] Plugin compiler Java untuk dijalankan pada waktu kompilasi. Setiap java_plugin yang ditentukan dalam atribut ini akan dijalankan setiap kali aturan ini di-build. Library juga dapat mewarisi plugin dari dependensi yang menggunakan exported_plugins. Resource yang dihasilkan oleh plugin akan disertakan dalam jar yang dihasilkan dari aturan ini.
processor_class	String; default-nya adalah "" Class pemroses adalah jenis class yang sepenuhnya memenuhi syarat yang harus digunakan compiler Java sebagai titik entri ke pemroses anotasi. Jika tidak ditentukan, aturan ini tidak akan berkontribusi pada pemroses anotasi untuk pemrosesan anotasi compiler Java, tetapi classpath runtime-nya akan tetap disertakan di jalur pemroses anotasi compiler. (Hal ini secara khusus ditujukan untuk digunakan oleh plugin yang Rentan Error, yang dimuat dari jalur pemroses anotasi menggunakan java.util.ServiceLoader.)
proguard_specs	Daftar label; default-nya adalah [] File yang akan digunakan sebagai spesifikasi Proguard. File ini akan menjelaskan kumpulan spesifikasi yang akan digunakan oleh Proguard. Jika ditentukan, target tersebut akan ditambahkan ke target android_binary apa pun yang bergantung pada library ini. File yang disertakan di sini hanya boleh memiliki aturan idempoten, yaitu -dontnote, -dontwarn, assumenosideeffects, dan aturan yang dimulai dengan -keep. Opsi lain hanya dapat muncul di proguard_specs android_binary, untuk memastikan penggabungan non-tautologis.
resource_strip_prefix	String; default-nya adalah "" Awalan jalur yang akan dihapus dari resource Java. Jika ditentukan, awalan jalur ini akan dihapus dari setiap file dalam atribut resources. File resource yang tidak berada di direktori ini akan mengalami error. Jika tidak ditentukan (default), jalur file resource ditentukan sesuai dengan logika yang sama dengan paket Java file sumber. Misalnya, file sumber di stuff/java/foo/bar/a.txt akan berada di foo/bar/a.txt.

java_runtime

Melihat sumber aturan

java_runtime(name, srcs, compatible_with, default_cds, deprecation, distribs, exec_compatible_with, exec_properties, features, hermetic_srcs, hermetic_static_libs, java, java_home, lib_ct_sym, lib_modules, output_licenses, restricted_to, tags, target_compatible_with, testonly, toolchains, version, visibility)

Menentukan konfigurasi untuk runtime Java.

Contoh:

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

Argumen

Atribut
name	Nama; wajib Nama unik untuk target ini.
srcs	Daftar label; default-nya adalah [] Semua file dalam runtime.
default_cds	Label; default-nya adalah None Arsip CDS default untuk java_runtime hermetis. Jika hermetis diaktifkan untuk target java_binary, CDS default java_runtime akan dikemas dalam JAR deployment hermetis.
hermetic_srcs	Daftar label; default-nya adalah [] File dalam runtime yang diperlukan untuk deployment hermetis.
hermetic_static_libs	Daftar label; default-nya adalah [] Library yang ditautkan secara statis dengan peluncur untuk deployment hermetis
java	Label; default-nya adalah None Jalur ke file java yang dapat dieksekusi.
java_home	String; default-nya adalah "" Jalur ke root runtime. Tunduk pada penggantian variabel"Make". Jika jalur ini bersifat absolut, aturan ini menunjukkan runtime Java non-hermetis dengan jalur yang sudah dikenal. Dalam hal ini, atribut srcs dan java harus kosong.
lib_ct_sym	Label; default-nya adalah None File lib/ct.sym diperlukan untuk kompilasi dengan --release. Jika tidak ditentukan dan hanya ada satu file di srcs yang jalurnya berakhir dengan /lib/ct.sym, file tersebut akan digunakan.
lib_modules	Label; default-nya adalah None File lib/modules yang diperlukan untuk deployment hermetis.
output_licenses	Daftar string; default-nya adalah []
version	Bilangan bulat; default-nya adalah 0 Versi fitur runtime Java. Artinya, bilangan bulat yang ditampilkan oleh Runtime.version().feature().

java_toolchain

Melihat sumber aturan

java_toolchain(name, android_lint_data, android_lint_jvm_opts, android_lint_opts, android_lint_package_configuration, android_lint_runner, bootclasspath, compatible_javacopts, compatible_with, deprecation, deps_checker, distribs, exec_compatible_with, exec_properties, features, forcibly_disable_header_compilation, genclass, header_compiler, header_compiler_builtin_processors, header_compiler_direct, ijar, jacocorunner, java_runtime, javabuilder, javabuilder_data, javabuilder_jvm_opts, javac_supports_multiplex_workers, javac_supports_worker_cancellation, javac_supports_worker_multiplex_sandboxing, javac_supports_workers, javacopts, jspecify_implicit_deps, jspecify_javacopts, jspecify_packages, jspecify_processor, jspecify_processor_class, jspecify_stubs, jvm_opts, licenses, misc, oneversion, oneversion_allowlist, oneversion_allowlist_for_tests, oneversion_whitelist, package_configuration, proguard_allowlister, reduced_classpath_incompatible_processors, restricted_to, singlejar, source_version, tags, target_compatible_with, target_version, testonly, timezone_data, toolchains, tools, turbine_data, turbine_jvm_opts, visibility, xlint)

Menentukan konfigurasi untuk compiler Java. toolchain yang akan digunakan dapat diubah melalui argumen --java_toolchain. Biasanya, Anda tidak boleh menulis aturan semacam itu kecuali jika ingin menyesuaikan compiler Java.

Contoh

Contoh sederhananya adalah:

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

Argumen

Atribut
name	Nama; wajib Nama unik untuk target ini.
android_lint_data	Daftar label; default-nya adalah [] Label alat yang tersedia untuk perluasan label di android_lint_jvm_opts.
android_lint_jvm_opts	Daftar string; default-nya adalah [] Daftar argumen untuk JVM saat memanggil Android Lint.
android_lint_opts	Daftar string; default-nya adalah [] Daftar argumen Android Lint.
android_lint_package_configuration	Daftar label; default-nya adalah [] Konfigurasi Android Lint yang harus diterapkan ke grup paket yang ditentukan.
android_lint_runner	Label; default-nya adalah None Label runner Android Lint, jika ada.
bootclasspath	Daftar label; default-nya adalah [] Entri bootclasspath target Java. Sesuai dengan flag -bootclasspath javac.
compatible_javacopts	null; default-nya adalah {} API internal, jangan gunakan!
deps_checker	Label; default-nya adalah None Label jar deployment ImportDepsChecker.
forcibly_disable_header_compilation	Boolean; default-nya adalah False Mengganti --java_header_compilation untuk menonaktifkan kompilasi header di platform yang tidak mendukungnya, misalnya JDK 7 Bazel.
genclass	Label; default-nya adalah None Label jar deployment GenClass.
header_compiler	Label; default-nya adalah None Label compiler header. Wajib jika --java_header_compilation diaktifkan.
header_compiler_builtin_processors	Daftar string; default-nya adalah [] API internal, jangan gunakan!
header_compiler_direct	Label; default-nya adalah None Label opsional compiler header yang akan digunakan untuk tindakan classpath langsung yang tidak menyertakan pemroses anotasi yang menghasilkan API. Alat ini tidak mendukung pemrosesan anotasi.
ijar	Label; default-nya adalah None Label file ijar yang dapat dieksekusi.
jacocorunner	Label; default-nya adalah None Label jar deployment JacocoCoverageRunner.
java_runtime	Label; default-nya adalah None java_runtime yang akan digunakan dengan toolchain ini. Secara default, nilainya adalah java_runtime dalam konfigurasi eksekusi.
javabuilder	Label; default-nya adalah None Label jar deployment JavaBuilder.
javabuilder_data	Daftar label; default-nya adalah [] Label data yang tersedia untuk perluasan label di javabuilder_jvm_opts.
javabuilder_jvm_opts	Daftar string; default-nya adalah [] Daftar argumen untuk JVM saat memanggil JavaBuilder.
javac_supports_multiplex_workers	Boolean; default-nya adalah True Benar jika JavaBuilder mendukung berjalan sebagai pekerja persisten multipleks, salah jika tidak.
javac_supports_worker_cancellation	Boolean; default-nya adalah True Benar jika JavaBuilder mendukung pembatalan pekerja persisten, salah jika tidak.
javac_supports_worker_multiplex_sandboxing	Boolean; default-nya adalah False Benar jika JavaBuilder mendukung berjalan sebagai pekerja persisten multipleks dengan sandboxing, salah jika tidak.
javac_supports_workers	Boolean; default-nya adalah True Benar jika JavaBuilder mendukung berjalan sebagai pekerja persisten, salah jika tidak.
javacopts	Daftar string; default-nya adalah [] Daftar argumen tambahan untuk compiler Java. Silakan baca dokumentasi compiler Java untuk mengetahui daftar lengkap kemungkinan flag compiler Java.
jspecify_implicit_deps	Label; default-nya adalah None Eksperimental, jangan gunakan.
jspecify_javacopts	Daftar string; default-nya adalah [] Eksperimental, jangan gunakan.
jspecify_packages	Daftar label; default-nya adalah [] Eksperimental, jangan gunakan.
jspecify_processor	Label; default-nya adalah None Eksperimental, jangan gunakan.
jspecify_processor_class	String; default-nya adalah "" Eksperimental, jangan gunakan.
jspecify_stubs	Daftar label; default-nya adalah [] Eksperimental, jangan gunakan.
jvm_opts	Daftar string; default-nya adalah [] Daftar argumen untuk JVM saat memanggil compiler Java. Lihat dokumentasi virtual machine Java untuk mengetahui daftar lengkap kemungkinan flag untuk opsi ini.
misc	Daftar string; default-nya adalah [] Tidak digunakan lagi: gunakan javacopts sebagai gantinya
oneversion	Label; default-nya adalah None Label biner penegakan satu versi.
oneversion_allowlist	Label; default-nya adalah None Label daftar yang diizinkan satu versi.
oneversion_allowlist_for_tests	Label; default-nya adalah None Label daftar yang diizinkan satu versi untuk pengujian.
oneversion_whitelist	Label; default-nya adalah None Tidak digunakan lagi: gunakan oneversion_allowlist sebagai gantinya
package_configuration	Daftar label; default-nya adalah [] Konfigurasi yang harus diterapkan ke grup paket yang ditentukan.
proguard_allowlister	Label; default-nya adalah "@bazel_tools//tools/jdk:proguard_whitelister" Label daftar yang diizinkan Proguard.
reduced_classpath_incompatible_processors	Daftar string; default-nya adalah [] API internal, jangan gunakan!
singlejar	Label; default-nya adalah None Label jar deployment SingleJar.
source_version	String; default-nya adalah "" Versi sumber Java (misalnya, '6' atau '7'). File ini menentukan kumpulan struktur kode yang diizinkan dalam kode sumber Java.
target_version	String; default-nya adalah "" Versi target Java (mis., '6' atau '7'). Ini menentukan runtime Java yang akan digunakan untuk membangun class.
timezone_data	Label; default-nya adalah None Label jar resource yang berisi data zona waktu. Jika ditetapkan, data zona waktu akan ditambahkan sebagai dependensi runtime implisit dari semua aturan java_binary.
tools	Daftar label; default-nya adalah [] Label alat yang tersedia untuk perluasan label di jvm_opts.
turbine_data	Daftar label; default-nya adalah [] Label data yang tersedia untuk perluasan label di turbine_jvm_opts.
turbine_jvm_opts	Daftar string; default-nya adalah [] Daftar argumen untuk JVM saat memanggil turbin.
xlint	Daftar string; default-nya adalah [] Daftar peringatan yang akan ditambahkan atau dihapus dari daftar default. Didahului dengan tanda hubung untuk menghapusnya. Lihat dokumentasi Javac tentang opsi -Xlint untuk mengetahui informasi selengkapnya.