Trang này được dịch bởi Cloud Translation API.

Quy tắc Java

Quy tắc

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)

Tạo một kho lưu trữ Java ("tệp jar") cùng với tập lệnh shell bao bọc có cùng tên với quy tắc. Tập lệnh shell bao bọc sử dụng một đường dẫn lớp, trong đó có một tệp jar cho mỗi thư viện mà tệp nhị phân phụ thuộc vào. Khi chạy tập lệnh shell trình bao bọc, mọi biến môi trường JAVABIN không trống sẽ được ưu tiên hơn phiên bản được chỉ định thông qua cờ --java_runtime_version của Bazel.

Tập lệnh trình bao bọc chấp nhận một số cờ duy nhất. Tham khảo //src/main/java/com/google/devtools/build/lib/bazel/rules/java/java_stub_template.txt để biết danh sách cờ có thể định cấu hình và biến môi trường mà trình bao bọc chấp nhận.

Các mục tiêu đầu ra ngầm ẩn

name.jar: Một kho lưu trữ Java, chứa các tệp lớp và các tài nguyên khác tương ứng với các phần phụ thuộc trực tiếp của tệp nhị phân.
name-src.jar: Một tệp lưu trữ chứa các nguồn ("tệp nguồn").
name_deploy.jar: Một kho lưu trữ Java phù hợp cho việc triển khai (chỉ được tạo khi có yêu cầu rõ ràng).
Khi tạo mục tiêu <name>_deploy.jar cho quy tắc, bạn sẽ tạo một tệp jar độc lập có tệp kê khai cho phép chạy tệp này bằng lệnh java -jar hoặc bằng tuỳ chọn --singlejar của tập lệnh trình bao bọc. Bạn nên ưu tiên sử dụng tập lệnh trình bao bọc hơn là java -jar vì tập lệnh này cũng truyền cờ JVM và các tuỳ chọn để tải thư viện gốc.

Tệp triển khai chứa tất cả các lớp mà một trình tải lớp sẽ tìm thấy từ đầu đến cuối trong tập lệnh trình bao bọc của tệp nhị phân. Tệp này cũng chứa các thư viện gốc cần thiết cho các phần phụ thuộc. Các cảnh báo này sẽ tự động được tải vào JVM trong thời gian chạy.

Nếu mục tiêu của bạn chỉ định thuộc tính trình chạy, thì thay vì là một tệp JAR thông thường, _Deploy.jar sẽ là một tệp nhị phân gốc. Đối tượng này sẽ chứa trình chạy cùng với mọi phần phụ thuộc gốc (C++) của quy tắc, tất cả được liên kết thành một tệp nhị phân tĩnh. Các byte của tệp jar thực tế sẽ được thêm vào tệp nhị phân gốc đó, tạo ra một blob nhị phân duy nhất chứa cả tệp thực thi và mã Java. Bạn có thể trực tiếp thực thi tệp jar thu được như cách bạn thực thi bất kỳ tệp nhị phân gốc nào.
name_deploy-src.jar: Tệp lưu trữ chứa các nguồn được thu thập từ quá trình đóng bắc cầu của mục tiêu. Các tệp này sẽ khớp với các lớp trong deploy.jar, ngoại trừ trường hợp các tệp jar không có tệp nguồn phù hợp.

Không được phép sử dụng thuộc tính deps trong quy tắc java_binary nếu không có srcs; quy tắc như vậy yêu cầu thuộc tính main_class do runtime_deps cung cấp.

Đoạn mã sau minh hoạ một lỗi thường gặp:

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

Hãy làm như sau:

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

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này. Bạn nên sử dụng tên của tệp nguồn là điểm truy cập chính của ứng dụng (trừ phần mở rộng). Ví dụ: nếu điểm truy cập có tên là `Main.java`, thì tên của bạn có thể là `Main`.
`deps`	Danh sách nhãn; mặc định là `[]` Danh sách thư viện khác sẽ được liên kết với mục tiêu. Xem nhận xét chung về `deps` tại phần Các thuộc tính điển hình được xác định theo hầu hết các quy tắc xây dựng.
`srcs`	Danh sách nhãn; mặc định là `[]` Danh sách tệp nguồn được xử lý để tạo mục tiêu. Thuộc tính này hầu như luôn bắt buộc; hãy xem các trường hợp ngoại lệ dưới đây. Các tệp nguồn thuộc loại `.java` sẽ được biên dịch. Trong trường hợp tệp `.java` được tạo, bạn nên đặt tên của quy tắc tạo ở đây thay vì tên của tệp. Điều này không chỉ cải thiện khả năng đọc mà còn giúp quy tắc này linh hoạt hơn trước những thay đổi trong tương lai: nếu quy tắc tạo tạo nhiều tệp trong tương lai, thì bạn chỉ cần sửa một vị trí: `outs` của quy tắc tạo. Bạn không nên liệt kê quy tắc tạo trong `deps` vì quy tắc này không hoạt động. Các tệp nguồn thuộc loại `.srcjar` sẽ được giải nén và biên dịch. (Cách này rất hữu ích nếu bạn cần tạo một tập hợp các tệp `.java` bằng một quy tắc gen.) Quy tắc: nếu quy tắc (thường là `genrule` hoặc `filegroup`) tạo ra bất kỳ tệp nào nêu trên, thì các quy tắc đó sẽ được sử dụng theo cách tương tự như được mô tả cho tệp nguồn. Đối số này hầu như luôn bắt buộc, ngoại trừ khi thuộc tính `main_class` chỉ định một lớp trên đường dẫn lớp thời gian chạy hoặc bạn chỉ định đối số `runtime_deps`.
`resources`	Danh sách nhãn; mặc định là `[]` Danh sách các tệp dữ liệu cần đưa vào tệp Java. Nếu được chỉ định, các tài nguyên sẽ được nhóm lại trong jar cùng với các tệp `.class` thông thường do quá trình biên dịch tạo ra. Vị trí của các tài nguyên bên trong tệp jar được xác định theo cấu trúc dự án. Trước tiên, Bazel sẽ tìm bố cục thư mục chuẩn của Maven (một thư mục "src", theo sau là một thư mục con của thư mục "resources" (tài nguyên). Nếu không tìm thấy tài nguyên đó, Bazel sẽ tìm thư mục trên cùng có tên là "java" hoặc "javatests" (ví dụ: nếu tài nguyên nằm tại `<workspace root>/x/java/y/java/z`, đường dẫn của tài nguyên sẽ là `y/java/z`. Không thể ghi đè phương pháp phỏng đoán này. Tuy nhiên, bạn có thể sử dụng thuộc tính `resource_strip_prefix` để chỉ định một thư mục thay thế cụ thể cho các tệp tài nguyên. Tài nguyên có thể là tệp nguồn hoặc tệp đã tạo.
`classpath_resources`	Danh sách nhãn; mặc định là `[]` ĐỪNG SỬ DỤNG LỰA CHỌN NÀY TRỪ KHI KHÔNG CÓ CÁCH NÀO KHÁC) Danh sách các tài nguyên phải được đặt ở gốc của cây java. Mục đích duy nhất của thuộc tính này là để hỗ trợ các thư viện của bên thứ ba yêu cầu tài nguyên của các tài nguyên đó phải được tìm thấy chính xác trên đường dẫn lớp là `"myconfig.xml"`. Bạn chỉ được phép sử dụng thuộc tính này trên tệp nhị phân, chứ không phải thư viện, do nguy cơ xung đột không gian tên.
`create_executable`	Boolean; không thể định cấu hình; giá trị mặc định là `True` Không dùng nữa, chuyển sang dùng `java_single_jar`.
`deploy_env`	Danh sách nhãn; mặc định là `[]` Danh sách các mục tiêu `java_binary` khác đại diện cho môi trường triển khai cho tệp nhị phân này. Đặt thuộc tính này khi tạo một trình bổ trợ sẽ được một `java_binary` khác tải. Việc đặt thuộc tính này sẽ loại trừ tất cả phần phụ thuộc khỏi đường dẫn lớp thời gian chạy (và ngăn triển khai) của tệp nhị phân này (được dùng chung giữa tệp nhị phân này và các mục tiêu được chỉ định trong `deploy_env`).
`deploy_manifest_lines`	Danh sách chuỗi; mặc định là `[]` Danh sách các dòng cần thêm vào tệp `META-INF/manifest.mf` được tạo cho mục tiêu `_deploy.jar`. Nội dung của thuộc tính này không* chịu sự thay thế "Tạo biến".
`javacopts`	Danh sách chuỗi; mặc định là `[]` Các tuỳ chọn bổ sung của trình biên dịch cho thư viện này. Áp dụng tuỳ chọn thay thế "Tạo biến" và tạo mã thông báo shell Bourne. Các tuỳ chọn trình biên dịch này được chuyển đến javac sau các tuỳ chọn của trình biên dịch chung.
`jvm_flags`	Danh sách chuỗi; mặc định là `[]` Danh sách cờ để nhúng vào tập lệnh trình bao bọc được tạo để chạy tệp nhị phân này. Tuân theo việc thay thế $(location) và "Tạo biến" cũng như mã hoá bằng mã thông báo shell Bourne. Tập lệnh trình bao bọc cho một tệp nhị phân Java bao gồm định nghĩa CLASSPATH (để tìm tất cả các tệp phụ thuộc) và gọi trình thông dịch Java phù hợp. Dòng lệnh do tập lệnh trình bao bọc tạo ra bao gồm tên của lớp chính, theo sau là `"$@"` để bạn có thể truyền các đối số khác sau tên lớp. Tuy nhiên, các đối số dùng để phân tích cú pháp của JVM phải được chỉ định trước tên lớp trên dòng lệnh. Nội dung của `jvm_flags` được thêm vào tập lệnh trình bao bọc trước khi tên lớp được liệt kê. Lưu ý rằng thuộc tính này không ảnh hưởng đến dữ liệu đầu ra `*_deploy.jar`.
`launcher`	Nhãn; mặc định là `None` Chỉ định một tệp nhị phân sẽ được dùng để chạy chương trình Java thay vì chương trình `bin/java` thông thường đi kèm với JDK. Mục tiêu phải là `cc_binary`. Bạn có thể chỉ định bất kỳ `cc_binary` nào triển khai API gọi Java làm giá trị cho thuộc tính này. Theo mặc định, Bazel sẽ sử dụng trình chạy JDK thông thường (bin/java hoặc java.exe). Cờ Bazel `--java_launcher` liên quan chỉ ảnh hưởng đến các mục tiêu `java_binary` và `java_test` chưa chỉ định thuộc tính `launcher`. Lưu ý rằng các phần phụ thuộc gốc (C++, SWIG, JNI) sẽ được tạo theo cách khác nhau tuỳ thuộc vào việc bạn đang sử dụng trình chạy JDK hay một trình chạy khác: Nếu bạn đang dùng trình chạy JDK thông thường (mặc định), thì các phần phụ thuộc gốc sẽ được tạo dưới dạng thư viện dùng chung có tên là `{name}_nativedeps.so`, trong đó `{name}` là thuộc tính `name` của quy tắc java_binary này. Trình liên kết không xoá mã không sử dụng trong cấu hình này. Nếu bạn đang sử dụng bất kỳ trình chạy nào khác, thì các phần phụ thuộc gốc (C++) sẽ được liên kết tĩnh với một tệp nhị phân có tên `{name}_nativedeps`, trong đó `{name}` là thuộc tính `name` của quy tắc java_binary này. Trong trường hợp này, trình liên kết sẽ xoá mọi mã mà nó cho là không dùng đến khỏi tệp nhị phân kết quả, tức là có thể không liên kết được mã C++ nào chỉ được truy cập thông qua JNI trừ phi mục tiêu `cc_library` đó chỉ định `alwayslink = 1`. Khi sử dụng bất kỳ trình chạy nào khác với trình chạy JDK mặc định, định dạng của đầu ra `*_deploy.jar` sẽ thay đổi. Hãy xem các tài liệu chính về java_binary để biết thông tin chi tiết.
`main_class`	Chuỗi; giá trị mặc định là `""` Tên của lớp có phương thức `main()` dùng làm điểm truy cập. Nếu một quy tắc sử dụng chế độ này, thì quy tắc không cần danh sách `srcs=[...]`. Do đó, với thuộc tính này, bạn có thể tạo tệp thực thi từ thư viện Java đã chứa một hoặc nhiều phương thức `main()`. Giá trị của thuộc tính này là tên lớp chứ không phải tệp nguồn. Lớp phải có sẵn trong thời gian chạy: lớp này có thể được biên dịch theo quy tắc này (từ `srcs`) hoặc được cung cấp bởi các phần phụ thuộc trực tiếp hoặc bắc cầu (thông qua `runtime_deps` hoặc `deps`). Nếu không có lớp, tệp nhị phân sẽ không thành công trong thời gian chạy; không cần kiểm tra thời gian xây dựng.
`plugins`	Danh sách nhãn; mặc định là `[]` Các trình bổ trợ trình biên dịch Java để chạy vào thời gian biên dịch. Mọi `java_plugin` được chỉ định trong thuộc tính này sẽ chạy bất cứ khi nào quy tắc này được tạo. Một thư viện cũng có thể kế thừa trình bổ trợ từ các phần phụ thuộc sử dụng `exported_plugins`. Các tài nguyên do trình bổ trợ tạo ra sẽ được đưa vào tệp jar kết quả của quy tắc này.
`resource_jars`	Danh sách nhãn; mặc định là `[]` Không dùng nữa: Thay vào đó, hãy sử dụng java_import và deps hoặc hay Runtime_deps.
`resource_strip_prefix`	Chuỗi; giá trị mặc định là `""` Tiền tố đường dẫn để loại bỏ khỏi tài nguyên Java. Nếu được chỉ định, tiền tố đường dẫn này sẽ bị xoá khỏi mọi tệp trong thuộc tính `resources`. Nếu tệp tài nguyên không nằm trong thư mục này thì xảy ra lỗi. Nếu không được chỉ định (mặc định), đường dẫn của tệp tài nguyên sẽ được xác định theo cùng một logic như gói Java của các tệp nguồn. Ví dụ: tệp nguồn tại `stuff/java/foo/bar/a.txt` sẽ nằm ở `foo/bar/a.txt`.
`runtime_deps`	Danh sách nhãn; mặc định là `[]` Các thư viện chỉ cung cấp cho tệp nhị phân cuối cùng hoặc kiểm thử trong thời gian chạy. Giống như `deps` thông thường, các thành phần này sẽ xuất hiện trên đường dẫn lớp thời gian chạy, nhưng không giống như các đường dẫn lớp này, không xuất hiện trên đường dẫn lớp thời gian biên dịch. Bạn phải liệt kê các phần phụ thuộc chỉ cần thiết trong thời gian chạy tại đây. Các công cụ phân tích phần phụ thuộc nên bỏ qua các mục tiêu xuất hiện trong cả `runtime_deps` và `deps`.
`stamp`	Số nguyên; giá trị mặc định là `-1` Liệu có mã hoá thông tin bản dựng thành tệp nhị phân hay không. Có thể dùng các giá trị sau: `stamp = 1`: Luôn đóng dấu thông tin bản dựng vào tệp nhị phân, ngay cả trong các bản dựng `--nostamp`. Bạn nên tránh chế độ cài đặt này, vì chế độ này có thể tắt chức năng lưu vào bộ nhớ đệm từ xa đối với tệp nhị phân và mọi thao tác hạ nguồn phụ thuộc vào tệp nhị phân đó. `stamp = 0`: Luôn thay thế thông tin bản dựng bằng các giá trị hằng số. Điều này giúp lưu kết quả bản dựng tốt vào bộ nhớ đệm. `stamp = -1`: Bạn có thể kiểm soát việc nhúng thông tin bản dựng bằng cờ `--[no]stamp`. Tệp nhị phân đã đóng dấu không được tạo lại trừ phi các phần phụ thuộc của chúng thay đổi.
`use_launcher`	Boolean; giá trị mặc định là `True` Liệu tệp nhị phân có sử dụng trình chạy tuỳ chỉnh hay không. Nếu bạn đặt thuộc tính này thành false, thì thuộc tính trình chạy và cờ `--java_launcher` có liên quan sẽ bị bỏ qua đối với mục tiêu này.
`use_testrunner`	Boolean; giá trị mặc định là `False` Sử dụng lớp trình chạy kiểm thử (theo mặc định `com.google.testing.junit.runner.BazelTestRunner`) làm điểm truy cập chính cho chương trình Java và cung cấp lớp kiểm thử cho trình chạy kiểm thử dưới dạng giá trị của thuộc tính hệ thống `bazel.test_suite`. Bạn có thể sử dụng phương thức này để ghi đè hành vi mặc định, tức là sử dụng trình chạy kiểm thử cho các quy tắc `java_test` và không sử dụng trình chạy này cho các quy tắc `java_binary`. Bạn không chắc sẽ muốn làm việc này. Một cách sử dụng là cho các quy tắc `AllTest` được gọi bởi một quy tắc khác (ví dụ: để thiết lập cơ sở dữ liệu trước khi chạy kiểm thử). Quy tắc `AllTest` phải được khai báo là `java_binary`, nhưng vẫn nên sử dụng trình chạy kiểm thử làm điểm truy cập chính. Bạn có thể ghi đè tên của một lớp trình chạy kiểm thử bằng thuộc tính `main_class`.

java_import

Xem nguồn quy tắc

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)

Quy tắc này cho phép sử dụng các tệp .jar được biên dịch trước làm thư viện cho các quy tắc java_library và java_binary.

Ví dụ

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

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`deps`	Danh sách nhãn; mặc định là `[]` Danh sách thư viện khác sẽ được liên kết với mục tiêu. Hãy xem java_library.deps.
`constraints`	Danh sách chuỗi; không thể định cấu hình; giá trị mặc định là `[]` Các hạn chế bổ sung được đặt ra cho quy tắc này dưới dạng thư viện Java.
`exports`	Danh sách nhãn; mặc định là `[]` Các mục tiêu để cung cấp cho người dùng quy tắc này. Hãy xem java_library.exports.
`jars`	Danh sách nhãn; bắt buộc Danh sách tệp JAR được cung cấp cho các mục tiêu Java phụ thuộc vào mục tiêu này.
`neverlink`	Boolean; giá trị mặc định là `False` Chỉ dùng thư viện này để biên dịch chứ không dùng trong thời gian chạy. Hữu ích nếu môi trường thời gian chạy cung cấp thư viện trong quá trình thực thi. Ví dụ về các thư viện như vậy là API IDE cho các trình bổ trợ IDE hoặc `tools.jar` cho bất kỳ nội dung nào chạy trên JDK tiêu chuẩn.
`proguard_specs`	Danh sách nhãn; mặc định là `[]` Các tệp dùng làm thông số kỹ thuật Proguard. Phần này mô tả tập hợp thông số kỹ thuật mà Proguard sử dụng. Nếu được chỉ định, các mục này sẽ được thêm vào bất kỳ mục tiêu `android_binary` nào tuỳ thuộc vào thư viện này. Các tệp được đưa vào đây chỉ được có các quy tắc giá trị không thay đổi, cụ thể là -dontnote, -dontwarn, giả định và các quy tắc bắt đầu bằng -keep. Các tuỳ chọn khác chỉ có thể xuất hiện trong proguard_specs của `android_binary` để đảm bảo hợp nhất không tự động hoá.
`runtime_deps`	Danh sách nhãn; mặc định là `[]` Các thư viện chỉ cung cấp cho tệp nhị phân cuối cùng hoặc kiểm thử trong thời gian chạy. Hãy xem java_library.runtime_deps.
`srcjar`	Nhãn; mặc định là `None` Tệp JAR chứa mã nguồn cho các tệp JAR đã biên dịch.

java_library

Xem nguồn quy tắc

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)

Quy tắc này biên dịch và liên kết các nguồn thành một tệp .jar.

Các mục tiêu đầu ra ngầm ẩn

libname.jar: Một kho lưu trữ Java chứa các tệp lớp.
libname-src.jar: Một tệp lưu trữ chứa các nguồn ("tệp nguồn").

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`deps`	Danh sách nhãn; mặc định là `[]` Danh sách thư viện để liên kết với thư viện này. Xem nhận xét chung về `deps` tại phần Các thuộc tính điển hình được xác định theo hầu hết các quy tắc xây dựng. Các tệp jar được tạo theo các quy tắc `java_library` liệt kê trong `deps` sẽ nằm trên đường dẫn lớp thời gian biên dịch của quy tắc này. Ngoài ra, quá trình đóng bắc cầu của `deps`, `runtime_deps` và `exports` sẽ nằm trên đường dẫn lớp thời gian chạy. Ngược lại, các mục tiêu trong thuộc tính `data` được đưa vào các tệp chạy nhưng không nằm trên đường dẫn thời gian biên dịch hay đường dẫn lớp thời gian chạy.
`srcs`	Danh sách nhãn; mặc định là `[]` Danh sách tệp nguồn được xử lý để tạo mục tiêu. Thuộc tính này hầu như luôn bắt buộc; hãy xem các trường hợp ngoại lệ dưới đây. Các tệp nguồn thuộc loại `.java` sẽ được biên dịch. Trong trường hợp tệp `.java` được tạo, bạn nên đặt tên của quy tắc tạo ở đây thay vì tên của tệp. Điều này không chỉ cải thiện khả năng đọc mà còn giúp quy tắc này linh hoạt hơn trước những thay đổi trong tương lai: nếu quy tắc tạo tạo nhiều tệp trong tương lai, thì bạn chỉ cần sửa một vị trí: `outs` của quy tắc tạo. Bạn không nên liệt kê quy tắc tạo trong `deps` vì quy tắc này không hoạt động. Các tệp nguồn thuộc loại `.srcjar` sẽ được giải nén và biên dịch. (Cách này rất hữu ích nếu bạn cần tạo một tập hợp các tệp `.java` bằng một quy tắc gen.) Quy tắc: nếu quy tắc (thường là `genrule` hoặc `filegroup`) tạo ra bất kỳ tệp nào nêu trên, thì các quy tắc đó sẽ được sử dụng theo cách tương tự như được mô tả cho tệp nguồn. Đối số này hầu như luôn bắt buộc, ngoại trừ khi thuộc tính `main_class` chỉ định một lớp trên đường dẫn lớp thời gian chạy hoặc bạn chỉ định đối số `runtime_deps`.
`data`	Danh sách nhãn; mặc định là `[]` Danh sách các tệp mà thư viện này cần trong thời gian chạy. Xem nhận xét chung về `data` tại phần Các thuộc tính điển hình được xác định theo hầu hết các quy tắc xây dựng. Khi tạo `java_library`, Bazel không đặt các tệp này vào bất cứ nơi nào. Nếu các tệp `data` là tệp được tạo thì Bazel sẽ tạo các tệp đó. Khi tạo một chương trình kiểm thử phụ thuộc vào Bazel `java_library` này, bạn sẽ sao chép hoặc liên kết các tệp `data` vào vùng chạy tệp.
`resources`	Danh sách nhãn; mặc định là `[]` Danh sách các tệp dữ liệu cần đưa vào tệp Java. Nếu được chỉ định, các tài nguyên sẽ được nhóm lại trong jar cùng với các tệp `.class` thông thường do quá trình biên dịch tạo ra. Vị trí của các tài nguyên bên trong tệp jar được xác định theo cấu trúc dự án. Trước tiên, Bazel sẽ tìm bố cục thư mục chuẩn của Maven (một thư mục "src", theo sau là một thư mục con của thư mục "resources" (tài nguyên). Nếu không tìm thấy tài nguyên đó, Bazel sẽ tìm thư mục trên cùng có tên là "java" hoặc "javatests" (ví dụ: nếu tài nguyên nằm tại `<workspace root>/x/java/y/java/z`, đường dẫn của tài nguyên sẽ là `y/java/z`. Không thể ghi đè phương pháp phỏng đoán này. Tuy nhiên, bạn có thể sử dụng thuộc tính `resource_strip_prefix` để chỉ định một thư mục thay thế cụ thể cho các tệp tài nguyên. Tài nguyên có thể là tệp nguồn hoặc tệp đã tạo.
`exported_plugins`	Danh sách nhãn; mặc định là `[]` Danh sách các `java_plugin` (ví dụ: trình xử lý chú giải) để xuất sang các thư viện phụ thuộc trực tiếp vào thư viện này. Danh sách `java_plugin` được chỉ định sẽ được áp dụng cho mọi thư viện trực tiếp phụ thuộc vào thư viện này, giống như khi thư viện đó đã khai báo rõ ràng các nhãn này trong `plugins`.
`exports`	Danh sách nhãn; mặc định là `[]` Thư viện đã xuất. Các quy tắc liệt kê ở đây sẽ áp dụng cho các quy tắc mẹ, như thể quy tắc mẹ phụ thuộc rõ ràng vào các quy tắc này. Điều này không đúng với `deps` thông thường (không được xuất). Tóm tắt: một quy tắc X có thể truy cập vào mã trong Y nếu tồn tại một đường dẫn phần phụ thuộc bắt đầu bằng cạnh `deps`, theo sau là số không hoặc nhiều cạnh `exports`. Hãy cùng xem một số ví dụ để minh hoạ điều này. Giả sử A phụ thuộc vào B và B phụ thuộc vào C. Trong trường hợp này, C là phần phụ thuộc chuyển tiếp của A, vì vậy, việc thay đổi các nguồn của C và tạo lại A sẽ tạo lại đúng mọi thứ. Tuy nhiên, A sẽ không thể sử dụng các lớp trong C. Để cho phép điều đó, A phải khai báo C trong `deps` hoặc B có thể giúp A (và mọi nội dung có thể phụ thuộc vào A) dễ dàng hơn bằng cách khai báo C trong thuộc tính `exports` của (B). Tất cả quy tắc gốc trực tiếp đều áp dụng thao tác đóng thư viện đã xuất. Hãy lấy một ví dụ hơi khác: A phụ thuộc vào B, B phụ thuộc vào C và D, đồng thời xuất khẩu C nhưng không xuất D. Bây giờ, A có quyền truy cập vào C nhưng không có quyền truy cập vào D. Hiện tại, nếu C và D xuất một số thư viện, C' và D' tương ứng, thì A chỉ có thể truy cập vào C' chứ không thể truy cập D'. Lưu ý quan trọng: quy tắc được xuất không phải là phần phụ thuộc thông thường. Tiếp tục với ví dụ trước, nếu B xuất dữ liệu C và cũng muốn sử dụng C, thì B cũng phải liệt kê C trong `deps` riêng của mình.
`javacopts`	Danh sách chuỗi; mặc định là `[]` Các tuỳ chọn bổ sung của trình biên dịch cho thư viện này. Áp dụng tuỳ chọn thay thế "Tạo biến" và tạo mã thông báo shell Bourne. Các tuỳ chọn trình biên dịch này được chuyển đến javac sau các tuỳ chọn của trình biên dịch chung.
`neverlink`	Boolean; giá trị mặc định là `False` Liệu thư viện này chỉ được dùng để biên dịch chứ không phải trong thời gian chạy hay không. Hữu ích nếu môi trường thời gian chạy cung cấp thư viện trong quá trình thực thi. Ví dụ về những thư viện như vậy là API IDE cho các trình bổ trợ IDE hoặc `tools.jar` cho bất kỳ nội dung nào chạy trên JDK tiêu chuẩn. Xin lưu ý rằng `neverlink = 1` không ngăn trình biên dịch cùng dòng nội dung từ thư viện này vào các mục tiêu biên dịch phụ thuộc vào tài liệu đó, khi được cho phép trong Thông số kỹ thuật ngôn ngữ Java (ví dụ: Hằng số `static final` của `String` hoặc kiểu dữ liệu nguyên thuỷ). Do đó, trường hợp sử dụng ưu tiên là khi thư viện thời gian chạy giống hệt với thư viện biên dịch. Nếu thư viện thời gian chạy khác với thư viện biên dịch, bạn phải đảm bảo rằng thư viện này chỉ khác ở những vị trí mà JLS cấm trình biên dịch xuất hiện cùng dòng (và thư viện đó phải được áp dụng cho tất cả các phiên bản sau này của JLS).
`plugins`	Danh sách nhãn; mặc định là `[]` Các trình bổ trợ trình biên dịch Java để chạy vào thời gian biên dịch. Mọi `java_plugin` được chỉ định trong thuộc tính này sẽ chạy bất cứ khi nào quy tắc này được tạo. Một thư viện cũng có thể kế thừa trình bổ trợ từ các phần phụ thuộc sử dụng `exported_plugins`. Các tài nguyên do trình bổ trợ tạo ra sẽ được đưa vào tệp jar kết quả của quy tắc này.
`proguard_specs`	Danh sách nhãn; mặc định là `[]` Các tệp dùng làm thông số kỹ thuật Proguard. Phần này mô tả tập hợp thông số kỹ thuật mà Proguard sử dụng. Nếu được chỉ định, các mục này sẽ được thêm vào bất kỳ mục tiêu `android_binary` nào tuỳ thuộc vào thư viện này. Các tệp được đưa vào đây chỉ được có các quy tắc giá trị không thay đổi, cụ thể là -dontnote, -dontwarn, giả định và các quy tắc bắt đầu bằng -keep. Các tuỳ chọn khác chỉ có thể xuất hiện trong proguard_specs của `android_binary` để đảm bảo hợp nhất không tự động hoá.
`resource_jars`	Danh sách nhãn; mặc định là `[]` Không dùng nữa: Thay vào đó, hãy sử dụng java_import và deps hoặc hay Runtime_deps.
`resource_strip_prefix`	Chuỗi; giá trị mặc định là `""` Tiền tố đường dẫn để loại bỏ khỏi tài nguyên Java. Nếu được chỉ định, tiền tố đường dẫn này sẽ bị xoá khỏi mọi tệp trong thuộc tính `resources`. Nếu tệp tài nguyên không nằm trong thư mục này thì xảy ra lỗi. Nếu không được chỉ định (mặc định), đường dẫn của tệp tài nguyên sẽ được xác định theo cùng một logic như gói Java của các tệp nguồn. Ví dụ: tệp nguồn tại `stuff/java/foo/bar/a.txt` sẽ nằm ở `foo/bar/a.txt`.
`runtime_deps`	Danh sách nhãn; mặc định là `[]` Các thư viện chỉ cung cấp cho tệp nhị phân cuối cùng hoặc kiểm thử trong thời gian chạy. Giống như `deps` thông thường, các thành phần này sẽ xuất hiện trên đường dẫn lớp thời gian chạy, nhưng không giống như các đường dẫn lớp này, không xuất hiện trên đường dẫn lớp thời gian biên dịch. Bạn phải liệt kê các phần phụ thuộc chỉ cần thiết trong thời gian chạy tại đây. Các công cụ phân tích phần phụ thuộc nên bỏ qua các mục tiêu xuất hiện trong cả `runtime_deps` và `deps`.

java_lite_proto_library

Xem nguồn quy tắc

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 tạo mã Java từ các tệp .proto.

deps phải trỏ đến các quy tắc proto_library.

Ví dụ:

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

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

proto_library(
    name = "bar",
)

Đối số

Thuộc tính

name

Tên; bắt buộc

Tên duy nhất cho mục tiêu này.

deps

Danh sách nhãn; mặc định là []

Danh sách các quy tắc proto_library để tạo mã Java.

java_proto_library

Xem nguồn quy tắc

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 tạo mã Java từ các tệp .proto.

deps phải trỏ đến các quy tắc proto_library.

Ví dụ:

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

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

proto_library(
    name = "foo_proto",
)

Đối số

Thuộc tính

name

Tên; bắt buộc

Tên duy nhất cho mục tiêu này.

deps

Danh sách nhãn; mặc định là []

Danh sách các quy tắc proto_library để tạo mã Java.

java_test

Xem nguồn quy tắc

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)

Quy tắc java_test() biên dịch một chương trình kiểm thử Java. Kiểm thử là một trình bao bọc nhị phân xung quanh mã kiểm thử. Phương thức chính của trình chạy kiểm thử được gọi thay vì lớp chính được biên dịch.

Các mục tiêu đầu ra ngầm ẩn

name.jar: Một tệp lưu trữ Java.
name_deploy.jar: Một kho lưu trữ Java phù hợp để triển khai. (Chỉ được tạo khi có yêu cầu rõ ràng.) Hãy xem nội dung mô tả về dữ liệu đầu ra name_deploy.jar của java_binary để biết thêm thông tin.

Xem phần về đối số java_binary(). Quy tắc này cũng hỗ trợ mọi thuộc tính chung cho mọi quy tắc kiểm thử (*_test).

Ví dụ

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

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`deps`	Danh sách nhãn; mặc định là `[]` Danh sách thư viện khác sẽ được liên kết với mục tiêu. Xem nhận xét chung về `deps` tại phần Các thuộc tính điển hình được xác định theo hầu hết các quy tắc xây dựng.
`srcs`	Danh sách nhãn; mặc định là `[]` Danh sách tệp nguồn được xử lý để tạo mục tiêu. Thuộc tính này hầu như luôn bắt buộc; hãy xem các trường hợp ngoại lệ dưới đây. Các tệp nguồn thuộc loại `.java` sẽ được biên dịch. Trong trường hợp tệp `.java` được tạo, bạn nên đặt tên của quy tắc tạo ở đây thay vì tên của tệp. Điều này không chỉ cải thiện khả năng đọc mà còn giúp quy tắc này linh hoạt hơn trước những thay đổi trong tương lai: nếu quy tắc tạo tạo nhiều tệp trong tương lai, thì bạn chỉ cần sửa một vị trí: `outs` của quy tắc tạo. Bạn không nên liệt kê quy tắc tạo trong `deps` vì quy tắc này không hoạt động. Các tệp nguồn thuộc loại `.srcjar` sẽ được giải nén và biên dịch. (Cách này rất hữu ích nếu bạn cần tạo một tập hợp các tệp `.java` bằng một quy tắc gen.) Quy tắc: nếu quy tắc (thường là `genrule` hoặc `filegroup`) tạo ra bất kỳ tệp nào nêu trên, thì các quy tắc đó sẽ được sử dụng theo cách tương tự như được mô tả cho tệp nguồn. Đối số này hầu như luôn bắt buộc, ngoại trừ khi thuộc tính `main_class` chỉ định một lớp trên đường dẫn lớp thời gian chạy hoặc bạn chỉ định đối số `runtime_deps`.
`resources`	Danh sách nhãn; mặc định là `[]` Danh sách các tệp dữ liệu cần đưa vào tệp Java. Nếu được chỉ định, các tài nguyên sẽ được nhóm lại trong jar cùng với các tệp `.class` thông thường do quá trình biên dịch tạo ra. Vị trí của các tài nguyên bên trong tệp jar được xác định theo cấu trúc dự án. Trước tiên, Bazel sẽ tìm bố cục thư mục chuẩn của Maven (một thư mục "src", theo sau là một thư mục con của thư mục "resources" (tài nguyên). Nếu không tìm thấy tài nguyên đó, Bazel sẽ tìm thư mục trên cùng có tên là "java" hoặc "javatests" (ví dụ: nếu tài nguyên nằm tại `<workspace root>/x/java/y/java/z`, đường dẫn của tài nguyên sẽ là `y/java/z`. Không thể ghi đè phương pháp phỏng đoán này. Tuy nhiên, bạn có thể sử dụng thuộc tính `resource_strip_prefix` để chỉ định một thư mục thay thế cụ thể cho các tệp tài nguyên. Tài nguyên có thể là tệp nguồn hoặc tệp đã tạo.
`classpath_resources`	Danh sách nhãn; mặc định là `[]` ĐỪNG SỬ DỤNG LỰA CHỌN NÀY TRỪ KHI KHÔNG CÓ CÁCH NÀO KHÁC) Danh sách các tài nguyên phải được đặt ở gốc của cây java. Mục đích duy nhất của thuộc tính này là để hỗ trợ các thư viện của bên thứ ba yêu cầu tài nguyên của các tài nguyên đó phải được tìm thấy chính xác trên đường dẫn lớp là `"myconfig.xml"`. Bạn chỉ được phép sử dụng thuộc tính này trên tệp nhị phân, chứ không phải thư viện, do nguy cơ xung đột không gian tên.
`create_executable`	Boolean; không thể định cấu hình; giá trị mặc định là `True` Không dùng nữa, chuyển sang dùng `java_single_jar`.
`deploy_manifest_lines`	Danh sách chuỗi; mặc định là `[]` Danh sách các dòng cần thêm vào tệp `META-INF/manifest.mf` được tạo cho mục tiêu `_deploy.jar`. Nội dung của thuộc tính này không* chịu sự thay thế "Tạo biến".
`javacopts`	Danh sách chuỗi; mặc định là `[]` Các tuỳ chọn bổ sung của trình biên dịch cho thư viện này. Áp dụng tuỳ chọn thay thế "Tạo biến" và tạo mã thông báo shell Bourne. Các tuỳ chọn trình biên dịch này được chuyển đến javac sau các tuỳ chọn của trình biên dịch chung.
`jvm_flags`	Danh sách chuỗi; mặc định là `[]` Danh sách cờ để nhúng vào tập lệnh trình bao bọc được tạo để chạy tệp nhị phân này. Tuân theo việc thay thế $(location) và "Tạo biến" cũng như mã hoá bằng mã thông báo shell Bourne. Tập lệnh trình bao bọc cho một tệp nhị phân Java bao gồm định nghĩa CLASSPATH (để tìm tất cả các tệp phụ thuộc) và gọi trình thông dịch Java phù hợp. Dòng lệnh do tập lệnh trình bao bọc tạo ra bao gồm tên của lớp chính, theo sau là `"$@"` để bạn có thể truyền các đối số khác sau tên lớp. Tuy nhiên, các đối số dùng để phân tích cú pháp của JVM phải được chỉ định trước tên lớp trên dòng lệnh. Nội dung của `jvm_flags` được thêm vào tập lệnh trình bao bọc trước khi tên lớp được liệt kê. Lưu ý rằng thuộc tính này không ảnh hưởng đến dữ liệu đầu ra `*_deploy.jar`.
`launcher`	Nhãn; mặc định là `None` Chỉ định một tệp nhị phân sẽ được dùng để chạy chương trình Java thay vì chương trình `bin/java` thông thường đi kèm với JDK. Mục tiêu phải là `cc_binary`. Bạn có thể chỉ định bất kỳ `cc_binary` nào triển khai API gọi Java làm giá trị cho thuộc tính này. Theo mặc định, Bazel sẽ sử dụng trình chạy JDK thông thường (bin/java hoặc java.exe). Cờ Bazel `--java_launcher` liên quan chỉ ảnh hưởng đến các mục tiêu `java_binary` và `java_test` chưa chỉ định thuộc tính `launcher`. Lưu ý rằng các phần phụ thuộc gốc (C++, SWIG, JNI) sẽ được tạo theo cách khác nhau tuỳ thuộc vào việc bạn đang sử dụng trình chạy JDK hay một trình chạy khác: Nếu bạn đang dùng trình chạy JDK thông thường (mặc định), thì các phần phụ thuộc gốc sẽ được tạo dưới dạng thư viện dùng chung có tên là `{name}_nativedeps.so`, trong đó `{name}` là thuộc tính `name` của quy tắc java_binary này. Trình liên kết không xoá mã không sử dụng trong cấu hình này. Nếu bạn đang sử dụng bất kỳ trình chạy nào khác, thì các phần phụ thuộc gốc (C++) sẽ được liên kết tĩnh với một tệp nhị phân có tên `{name}_nativedeps`, trong đó `{name}` là thuộc tính `name` của quy tắc java_binary này. Trong trường hợp này, trình liên kết sẽ xoá mọi mã mà nó cho là không dùng đến khỏi tệp nhị phân kết quả, tức là có thể không liên kết được mã C++ nào chỉ được truy cập thông qua JNI trừ phi mục tiêu `cc_library` đó chỉ định `alwayslink = 1`. Khi sử dụng bất kỳ trình chạy nào khác với trình chạy JDK mặc định, định dạng của đầu ra `*_deploy.jar` sẽ thay đổi. Hãy xem các tài liệu chính về java_binary để biết thông tin chi tiết.
`main_class`	Chuỗi; giá trị mặc định là `""` Tên của lớp có phương thức `main()` dùng làm điểm truy cập. Nếu một quy tắc sử dụng chế độ này, thì quy tắc không cần danh sách `srcs=[...]`. Do đó, với thuộc tính này, bạn có thể tạo tệp thực thi từ thư viện Java đã chứa một hoặc nhiều phương thức `main()`. Giá trị của thuộc tính này là tên lớp chứ không phải tệp nguồn. Lớp phải có sẵn trong thời gian chạy: lớp này có thể được biên dịch theo quy tắc này (từ `srcs`) hoặc được cung cấp bởi các phần phụ thuộc trực tiếp hoặc bắc cầu (thông qua `runtime_deps` hoặc `deps`). Nếu không có lớp, tệp nhị phân sẽ không thành công trong thời gian chạy; không cần kiểm tra thời gian xây dựng.
`plugins`	Danh sách nhãn; mặc định là `[]` Các trình bổ trợ trình biên dịch Java để chạy vào thời gian biên dịch. Mọi `java_plugin` được chỉ định trong thuộc tính này sẽ chạy bất cứ khi nào quy tắc này được tạo. Một thư viện cũng có thể kế thừa trình bổ trợ từ các phần phụ thuộc sử dụng `exported_plugins`. Các tài nguyên do trình bổ trợ tạo ra sẽ được đưa vào tệp jar kết quả của quy tắc này.
`resource_jars`	Danh sách nhãn; mặc định là `[]` Không dùng nữa: Thay vào đó, hãy sử dụng java_import và deps hoặc hay Runtime_deps.
`resource_strip_prefix`	Chuỗi; giá trị mặc định là `""` Tiền tố đường dẫn để loại bỏ khỏi tài nguyên Java. Nếu được chỉ định, tiền tố đường dẫn này sẽ bị xoá khỏi mọi tệp trong thuộc tính `resources`. Nếu tệp tài nguyên không nằm trong thư mục này thì xảy ra lỗi. Nếu không được chỉ định (mặc định), đường dẫn của tệp tài nguyên sẽ được xác định theo cùng một logic như gói Java của các tệp nguồn. Ví dụ: tệp nguồn tại `stuff/java/foo/bar/a.txt` sẽ nằm ở `foo/bar/a.txt`.
`runtime_deps`	Danh sách nhãn; mặc định là `[]` Các thư viện chỉ cung cấp cho tệp nhị phân cuối cùng hoặc kiểm thử trong thời gian chạy. Giống như `deps` thông thường, các thành phần này sẽ xuất hiện trên đường dẫn lớp thời gian chạy, nhưng không giống như các đường dẫn lớp này, không xuất hiện trên đường dẫn lớp thời gian biên dịch. Bạn phải liệt kê các phần phụ thuộc chỉ cần thiết trong thời gian chạy tại đây. Các công cụ phân tích phần phụ thuộc nên bỏ qua các mục tiêu xuất hiện trong cả `runtime_deps` và `deps`.
`stamp`	Số nguyên; giá trị mặc định là `0` Liệu có mã hoá thông tin bản dựng thành tệp nhị phân hay không. Có thể dùng các giá trị sau: `stamp = 1`: Luôn đóng dấu thông tin bản dựng vào tệp nhị phân, ngay cả trong các bản dựng `--nostamp`. Bạn nên tránh chế độ cài đặt này, vì chế độ này có thể tắt chức năng lưu vào bộ nhớ đệm từ xa đối với tệp nhị phân và mọi thao tác hạ nguồn phụ thuộc vào tệp nhị phân đó. `stamp = 0`: Luôn thay thế thông tin bản dựng bằng các giá trị hằng số. Điều này giúp lưu kết quả bản dựng tốt vào bộ nhớ đệm. `stamp = -1`: Bạn có thể kiểm soát việc nhúng thông tin bản dựng bằng cờ `--[no]stamp`. Tệp nhị phân đã đóng dấu không được tạo lại trừ phi các phần phụ thuộc của chúng thay đổi.
`test_class`	Chuỗi; giá trị mặc định là `""` Lớp Java sẽ được tải bởi trình chạy kiểm thử. Theo mặc định, nếu đối số này không được xác định thì chế độ cũ sẽ được sử dụng và các đối số kiểm thử sẽ được sử dụng. Thiết lập cờ `--nolegacy_bazel_java_test` thành không dự phòng cho đối số đầu tiên. Thuộc tính này chỉ định tên của lớp Java mà chương trình kiểm thử này sẽ chạy. Việc thiết lập chế độ này hiếm khi xảy ra. Nếu bạn bỏ qua đối số này, thì hệ thống sẽ suy luận đối số này bằng cách sử dụng `name` của mục tiêu và đường dẫn nguồn-gốc tương đối. Nếu quy trình kiểm thử nằm bên ngoài một gốc nguồn đã biết, Bazel sẽ báo cáo lỗi nếu bạn không đặt `test_class`. Đối với JUnit3, lớp kiểm thử cần phải là lớp con của `junit.framework.TestCase` hoặc cần có một phương thức `suite()` tĩnh công khai trả về `junit.framework.Test` (hoặc một lớp con của `Test`). Đối với JUnit4, lớp này cần được chú thích bằng `org.junit.runner.RunWith`. Thuộc tính này cho phép một số quy tắc `java_test` chia sẻ cùng một `Test` (`TestCase`, `TestSuite`, ...). Thông thường, thông tin bổ sung được truyền đến thuộc tính đó (ví dụ: qua `jvm_flags=['-Dkey=value']`) để hành vi của quy tắc đó sẽ khác nhau trong từng trường hợp, chẳng hạn như chạy một tập hợp con kiểm thử khác. Thuộc tính này cũng cho phép sử dụng các bài kiểm thử Java bên ngoài cây `javatests`.
`use_launcher`	Boolean; giá trị mặc định là `True` Liệu tệp nhị phân có sử dụng trình chạy tuỳ chỉnh hay không. Nếu bạn đặt thuộc tính này thành false, thì thuộc tính trình chạy và cờ `--java_launcher` có liên quan sẽ bị bỏ qua đối với mục tiêu này.
`use_testrunner`	Boolean; giá trị mặc định là `True` Sử dụng lớp trình chạy kiểm thử (theo mặc định `com.google.testing.junit.runner.BazelTestRunner`) làm điểm truy cập chính cho chương trình Java và cung cấp lớp kiểm thử cho trình chạy kiểm thử dưới dạng giá trị của thuộc tính hệ thống `bazel.test_suite`. Bạn có thể sử dụng phương thức này để ghi đè hành vi mặc định, tức là sử dụng trình chạy kiểm thử cho các quy tắc `java_test` và không sử dụng trình chạy này cho các quy tắc `java_binary`. Bạn không chắc sẽ muốn làm việc này. Một cách sử dụng là cho các quy tắc `AllTest` được gọi bởi một quy tắc khác (ví dụ: để thiết lập cơ sở dữ liệu trước khi chạy kiểm thử). Quy tắc `AllTest` phải được khai báo là `java_binary`, nhưng vẫn nên sử dụng trình chạy kiểm thử làm điểm truy cập chính. Bạn có thể ghi đè tên của một lớp trình chạy kiểm thử bằng thuộc tính `main_class`.

java_package_configuration

Xem nguồn quy tắc

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

Cấu hình để áp dụng cho một tập hợp các gói. Bạn có thể thêm cấu hình vào java_toolchain.javacopts.

Ví dụ:

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

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`data`	Danh sách nhãn; mặc định là `[]` Danh sách các tệp mà cấu hình này cần trong thời gian chạy.
`javacopts`	Danh sách chuỗi; mặc định là `[]` Cờ của trình biên dịch Java.
`packages`	Danh sách nhãn; mặc định là `[]` Tập hợp `package_group` mà cấu hình sẽ được áp dụng.

java_plugin

Xem nguồn quy tắc

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 xác định các trình bổ trợ cho trình biên dịch Java do Bazel chạy. Hiện tại, loại trình bổ trợ duy nhất được hỗ trợ là trình xử lý chú giải. Quy tắc java_library hoặc java_binary có thể chạy các trình bổ trợ thông qua thuộc tính plugins, tuỳ thuộc vào các trình bổ trợ đó. java_library cũng có thể tự động xuất trình bổ trợ sang các thư viện phụ thuộc trực tiếp vào trình bổ trợ đó bằng cách sử dụng exported_plugins.

Các mục tiêu đầu ra ngầm ẩn

libname.jar: Một tệp lưu trữ Java.

Các đối số giống với java_library, ngoại trừ việc có thêm đối số processor_class.

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`deps`	Danh sách nhãn; mặc định là `[]` Danh sách thư viện để liên kết với thư viện này. Xem nhận xét chung về `deps` tại phần Các thuộc tính điển hình được xác định theo hầu hết các quy tắc xây dựng. Các tệp jar được tạo theo các quy tắc `java_library` liệt kê trong `deps` sẽ nằm trên đường dẫn lớp thời gian biên dịch của quy tắc này. Ngoài ra, quá trình đóng bắc cầu của `deps`, `runtime_deps` và `exports` sẽ nằm trên đường dẫn lớp thời gian chạy. Ngược lại, các mục tiêu trong thuộc tính `data` được đưa vào các tệp chạy nhưng không nằm trên đường dẫn thời gian biên dịch hay đường dẫn lớp thời gian chạy.
`srcs`	Danh sách nhãn; mặc định là `[]` Danh sách tệp nguồn được xử lý để tạo mục tiêu. Thuộc tính này hầu như luôn bắt buộc; hãy xem các trường hợp ngoại lệ dưới đây. Các tệp nguồn thuộc loại `.java` sẽ được biên dịch. Trong trường hợp tệp `.java` được tạo, bạn nên đặt tên của quy tắc tạo ở đây thay vì tên của tệp. Điều này không chỉ cải thiện khả năng đọc mà còn giúp quy tắc này linh hoạt hơn trước những thay đổi trong tương lai: nếu quy tắc tạo tạo nhiều tệp trong tương lai, thì bạn chỉ cần sửa một vị trí: `outs` của quy tắc tạo. Bạn không nên liệt kê quy tắc tạo trong `deps` vì quy tắc này không hoạt động. Các tệp nguồn thuộc loại `.srcjar` sẽ được giải nén và biên dịch. (Cách này rất hữu ích nếu bạn cần tạo một tập hợp các tệp `.java` bằng một quy tắc gen.) Quy tắc: nếu quy tắc (thường là `genrule` hoặc `filegroup`) tạo ra bất kỳ tệp nào nêu trên, thì các quy tắc đó sẽ được sử dụng theo cách tương tự như được mô tả cho tệp nguồn. Đối số này hầu như luôn bắt buộc, ngoại trừ khi thuộc tính `main_class` chỉ định một lớp trên đường dẫn lớp thời gian chạy hoặc bạn chỉ định đối số `runtime_deps`.
`data`	Danh sách nhãn; mặc định là `[]` Danh sách các tệp mà thư viện này cần trong thời gian chạy. Xem nhận xét chung về `data` tại phần Các thuộc tính điển hình được xác định theo hầu hết các quy tắc xây dựng. Khi tạo `java_library`, Bazel không đặt các tệp này vào bất cứ nơi nào. Nếu các tệp `data` là tệp được tạo thì Bazel sẽ tạo các tệp đó. Khi tạo một chương trình kiểm thử phụ thuộc vào Bazel `java_library` này, bạn sẽ sao chép hoặc liên kết các tệp `data` vào vùng chạy tệp.
`resources`	Danh sách nhãn; mặc định là `[]` Danh sách các tệp dữ liệu cần đưa vào tệp Java. Nếu được chỉ định, các tài nguyên sẽ được nhóm lại trong jar cùng với các tệp `.class` thông thường do quá trình biên dịch tạo ra. Vị trí của các tài nguyên bên trong tệp jar được xác định theo cấu trúc dự án. Trước tiên, Bazel sẽ tìm bố cục thư mục chuẩn của Maven (một thư mục "src", theo sau là một thư mục con của thư mục "resources" (tài nguyên). Nếu không tìm thấy tài nguyên đó, Bazel sẽ tìm thư mục trên cùng có tên là "java" hoặc "javatests" (ví dụ: nếu tài nguyên nằm tại `<workspace root>/x/java/y/java/z`, đường dẫn của tài nguyên sẽ là `y/java/z`. Không thể ghi đè phương pháp phỏng đoán này. Tuy nhiên, bạn có thể sử dụng thuộc tính `resource_strip_prefix` để chỉ định một thư mục thay thế cụ thể cho các tệp tài nguyên. Tài nguyên có thể là tệp nguồn hoặc tệp đã tạo.
`generates_api`	Boolean; giá trị mặc định là `False` Thuộc tính này đánh dấu những trình xử lý chú giải tạo mã API. Nếu một quy tắc sử dụng trình xử lý chú giải tạo API, thì các quy tắc khác tuỳ thuộc vào trình xử lý chú giải đó chỉ có thể tham chiếu đến mã được tạo nếu hành động biên dịch của các quy tắc đó được lên lịch sau quy tắc tạo. Thuộc tính này hướng dẫn Bazel đưa ra các quy tắc ràng buộc về việc lập lịch khi bật --java_header_compilation. CẢNH BÁO: Thuộc tính này ảnh hưởng đến hiệu suất của bản dựng, chỉ sử dụng nếu cần.
`javacopts`	Danh sách chuỗi; mặc định là `[]` Các tuỳ chọn bổ sung của trình biên dịch cho thư viện này. Áp dụng tuỳ chọn thay thế "Tạo biến" và tạo mã thông báo shell Bourne. Các tuỳ chọn trình biên dịch này được chuyển đến javac sau các tuỳ chọn của trình biên dịch chung.
`neverlink`	Boolean; giá trị mặc định là `False` Liệu thư viện này chỉ được dùng để biên dịch chứ không phải trong thời gian chạy hay không. Hữu ích nếu môi trường thời gian chạy cung cấp thư viện trong quá trình thực thi. Ví dụ về những thư viện như vậy là API IDE cho các trình bổ trợ IDE hoặc `tools.jar` cho bất kỳ nội dung nào chạy trên JDK tiêu chuẩn. Xin lưu ý rằng `neverlink = 1` không ngăn trình biên dịch cùng dòng nội dung từ thư viện này vào các mục tiêu biên dịch phụ thuộc vào tài liệu đó, khi được cho phép trong Thông số kỹ thuật ngôn ngữ Java (ví dụ: Hằng số `static final` của `String` hoặc kiểu dữ liệu nguyên thuỷ). Do đó, trường hợp sử dụng ưu tiên là khi thư viện thời gian chạy giống hệt với thư viện biên dịch. Nếu thư viện thời gian chạy khác với thư viện biên dịch, bạn phải đảm bảo rằng thư viện này chỉ khác ở những vị trí mà JLS cấm trình biên dịch xuất hiện cùng dòng (và thư viện đó phải được áp dụng cho tất cả các phiên bản sau này của JLS).
`output_licenses`	Loại giấy phép; mặc định là `["none"]` Xem `common attributes`
`plugins`	Danh sách nhãn; mặc định là `[]` Các trình bổ trợ trình biên dịch Java để chạy vào thời gian biên dịch. Mọi `java_plugin` được chỉ định trong thuộc tính này sẽ chạy bất cứ khi nào quy tắc này được tạo. Một thư viện cũng có thể kế thừa trình bổ trợ từ các phần phụ thuộc sử dụng `exported_plugins`. Các tài nguyên do trình bổ trợ tạo ra sẽ được đưa vào tệp jar kết quả của quy tắc này.
`processor_class`	Chuỗi; giá trị mặc định là `""` Lớp bộ xử lý là loại lớp đủ điều kiện mà trình biên dịch Java nên dùng làm điểm truy cập đến trình xử lý chú giải. Nếu không được chỉ định, quy tắc này sẽ không đóng góp trình xử lý chú giải vào quá trình xử lý chú giải của trình biên dịch Java, nhưng đường dẫn lớp thời gian chạy của quy tắc sẽ vẫn được đưa vào đường dẫn trình xử lý chú giải của trình biên dịch. (Trình bổ trợ này chủ yếu dành cho các trình bổ trợ Error Prone được tải qua đường dẫn trình xử lý chú giải bằng java.util.ServiceLoader.)
`proguard_specs`	Danh sách nhãn; mặc định là `[]` Các tệp dùng làm thông số kỹ thuật Proguard. Phần này mô tả tập hợp thông số kỹ thuật mà Proguard sử dụng. Nếu được chỉ định, các mục này sẽ được thêm vào bất kỳ mục tiêu `android_binary` nào tuỳ thuộc vào thư viện này. Các tệp được đưa vào đây chỉ được có các quy tắc giá trị không thay đổi, cụ thể là -dontnote, -dontwarn, giả định và các quy tắc bắt đầu bằng -keep. Các tuỳ chọn khác chỉ có thể xuất hiện trong proguard_specs của `android_binary` để đảm bảo hợp nhất không tự động hoá.
`resource_jars`	Danh sách nhãn; mặc định là `[]` Không dùng nữa: Thay vào đó, hãy sử dụng java_import và deps hoặc hay Runtime_deps.
`resource_strip_prefix`	Chuỗi; giá trị mặc định là `""` Tiền tố đường dẫn để loại bỏ khỏi tài nguyên Java. Nếu được chỉ định, tiền tố đường dẫn này sẽ bị xoá khỏi mọi tệp trong thuộc tính `resources`. Nếu tệp tài nguyên không nằm trong thư mục này thì xảy ra lỗi. Nếu không được chỉ định (mặc định), đường dẫn của tệp tài nguyên sẽ được xác định theo cùng một logic như gói Java của các tệp nguồn. Ví dụ: tệp nguồn tại `stuff/java/foo/bar/a.txt` sẽ nằm ở `foo/bar/a.txt`.

java_runtime

Xem nguồn quy tắc

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

Chỉ định cấu hình cho môi trường thời gian chạy Java.

Ví dụ:

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

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`srcs`	Danh sách nhãn; mặc định là `[]` Tất cả tệp trong thời gian chạy.
`default_cds`	Nhãn; mặc định là `None` Kho lưu trữ CDS mặc định cho `java_runtime` kín. Khi bạn bật tính năng ẩn cho mục tiêu `java_binary` và nếu mục tiêu đó không cung cấp kho lưu trữ CDS riêng bằng cách chỉ định thuộc tính `classlist`, thì đĩa CDS mặc định `java_runtime` sẽ được đóng gói trong tệp JAR triển khai kín.
`hermetic_srcs`	Danh sách nhãn; mặc định là `[]` Các tệp trong thời gian chạy cần thiết để triển khai khép kín.
`java`	Nhãn; mặc định là `None` Đường dẫn đến tệp thực thi java.
`java_home`	Chuỗi; giá trị mặc định là `""` Đường dẫn đến thư mục gốc của thời gian chạy. Phải tuân theo thay thế biến"Make". Nếu đường dẫn này là tuyệt đối, thì quy tắc này biểu thị một môi trường thời gian chạy Java không khép kín bằng một đường dẫn đã biết. Trong trường hợp đó, thuộc tính `srcs` và `java` phải trống.
`lib_ct_sym`	Nhãn; mặc định là `None` Tệp lib/ct.sym cần để biên dịch bằng `--release`. Nếu không được chỉ định và có đúng một tệp trong `srcs` có đường dẫn kết thúc bằng `/lib/ct.sym`, thì tệp đó sẽ được sử dụng.
`lib_modules`	Nhãn; mặc định là `None` Tệp lib/modules cần thiết cho hoạt động triển khai khép kín.
`version`	Số nguyên; giá trị mặc định là `0` Phiên bản tính năng của môi trường thời gian chạy Java. Tức là số nguyên do `Runtime.version().feature()` trả về.

java_toolchain

Xem nguồn quy tắc

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

Chỉ định cấu hình cho trình biên dịch Java. Bạn có thể thay đổi chuỗi công cụ nào đang được sử dụng thông qua đối số --java_toolchain. Thông thường, bạn không nên viết các loại quy tắc đó trừ phi muốn điều chỉnh trình biên dịch Java.

Ví dụ

Một ví dụ đơn giản:

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

Đối số

Thuộc tính
`name`	Tên; bắt buộc Tên duy nhất cho mục tiêu này.
`android_lint_data`	Danh sách nhãn; mặc định là `[]` Nhãn của những công cụ có sẵn để mở rộng nhãn trong android_lint_jvm_opts.
`android_lint_jvm_opts`	Danh sách chuỗi; mặc định là `[]` Danh sách các đối số cho JVM khi gọi Android Lint.
`android_lint_opts`	Danh sách chuỗi; mặc định là `[]` Danh sách các đối số Android Lint.
`android_lint_package_configuration`	Danh sách nhãn; mặc định là `[]` Cấu hình tìm lỗi mã nguồn của Android sẽ được áp dụng cho các nhóm gói đã chỉ định.
`android_lint_runner`	Nhãn; mặc định là `None` Nhãn của trình chạy tìm lỗi mã nguồn Android, nếu có.
`bootclasspath`	Danh sách nhãn; mặc định là `[]` Các mục đường dẫn lớp khởi động nhắm mục tiêu đến Java. Tương ứng với cờ -bootclasspath của javac.
`deps_checker`	Danh sách nhãn; mặc định là `[]` Nhãn của ngăn triển khai ImportDepsChecker.
`forcibly_disable_header_compilation`	Boolean; giá trị mặc định là `False` Ghi đè --java_header_compilation để tắt tính năng biên dịch tiêu đề trên những nền tảng không hỗ trợ, ví dụ: JDK 7 Bazel.
`genclass`	Danh sách nhãn; bắt buộc Nhãn của ngăn triển khai GenClass.
`header_compiler`	Danh sách nhãn; mặc định là `[]` Nhãn của trình biên dịch tiêu đề. Bắt buộc nếu --java_header_compilation được bật.
`header_compiler_direct`	Danh sách nhãn; mặc định là `[]` Nhãn không bắt buộc của trình biên dịch tiêu đề để sử dụng cho các thao tác classpath trực tiếp không bao gồm bất kỳ trình xử lý chú giải nào tạo API. Công cụ này không hỗ trợ xử lý chú giải.
`ijar`	Danh sách nhãn; bắt buộc Nhãn của tệp thực thi ijar.
`jacocorunner`	Nhãn; mặc định là `None` Nhãn của tệp triển khai JacocoCoverageRunner.
`java_runtime`	Nhãn; bắt buộc java_runtime để sử dụng với chuỗi công cụ này. Thuộc tính này mặc định là java_runtime trong cấu hình thực thi.
`javabuilder`	Danh sách nhãn; bắt buộc Nhãn của JavaBuilder triển khai jar.
`javabuilder_data`	Danh sách nhãn; mặc định là `[]` Các nhãn của dữ liệu có sẵn để mở rộng nhãn trong javabuilder_jvm_opts.
`javabuilder_jvm_opts`	Danh sách chuỗi; mặc định là `[]` Danh sách các đối số cho JVM khi gọi JavaBuilder.
`javac_supports_multiplex_workers`	Boolean; giá trị mặc định là `True` "True" nếu JavaBuilder hỗ trợ chạy dưới dạng một worker liên tục đa điểm, là false nếu không hỗ trợ.
`javac_supports_workers`	Boolean; giá trị mặc định là `True` "True" nếu JavaBuilder hỗ trợ chạy dưới dạng một worker ổn định, giá trị "false" nếu không hỗ trợ.
`javacopts`	Danh sách chuỗi; mặc định là `[]` Danh sách các đối số bổ sung cho trình biên dịch Java. Vui lòng tham khảo tài liệu về trình biên dịch Java để biết danh sách đầy đủ các cờ trình biên dịch Java có thể có.
`jvm_opts`	Danh sách chuỗi; mặc định là `[]` Danh sách các đối số cho JVM khi gọi trình biên dịch Java. Vui lòng tham khảo tài liệu về máy ảo Java để biết danh sách đầy đủ các cờ có thể có cho tuỳ chọn này.
`oneversion`	Nhãn; mặc định là `None` Nhãn của tệp nhị phân thực thi một phiên bản.
`oneversion_allowlist_for_tests`	Nhãn; mặc định là `None` Nhãn danh sách cho phép gồm một phiên bản dành cho các thử nghiệm.
`oneversion_whitelist`	Nhãn; mặc định là `None` Nhãn của danh sách cho phép gồm một phiên bản.
`package_configuration`	Danh sách nhãn; mặc định là `[]` Cấu hình sẽ được áp dụng cho các nhóm gói đã chỉ định.
`proguard_allowlister`	Nhãn; mặc định là `"@bazel_tools//tools/jdk:proguard_whitelister"` Nhãn của trình quản lý danh sách cho phép Proguard.
`resourcejar`	Danh sách nhãn; mặc định là `[]` Nhãn của trình tạo jar tài nguyên có thể thực thi.
`singlejar`	Danh sách nhãn; bắt buộc Nhãn của ngăn triển khai SingleJar.
`source_version`	Chuỗi; giá trị mặc định là `""` Phiên bản nguồn Java (ví dụ: "6" hoặc "7"). Trường này chỉ định tập hợp cấu trúc mã được cho phép trong mã nguồn Java.
`target_version`	Chuỗi; giá trị mặc định là `""` Phiên bản đích Java (ví dụ: "6" hoặc "7"). Trường này chỉ định môi trường thời gian chạy Java mà lớp sẽ được tạo.
`timezone_data`	Nhãn; mặc định là `None` Nhãn của một tệp tài nguyên chứa dữ liệu múi giờ. Nếu được đặt, dữ liệu múi giờ sẽ được thêm dưới dạng phần phụ thuộc hoàn toàn trong thời gian chạy của tất cả các quy tắc java_binary.
`tools`	Danh sách nhãn; mặc định là `[]` Nhãn của những công cụ có thể mở rộng nhãn trong jvm_opts.
`turbine_data`	Danh sách nhãn; mặc định là `[]` Các nhãn của dữ liệu có sẵn cho việc mở rộng nhãn trong turbine_jvm_opts.
`turbine_jvm_opts`	Danh sách chuỗi; mặc định là `[]` Danh sách các đối số cho JVM khi gọi tuabin.
`xlint`	Danh sách chuỗi; mặc định là `[]` Danh sách cảnh báo cần thêm hoặc xoá khỏi danh sách mặc định. Đặt dấu gạch ngang ở trước để xoá. Vui lòng xem tài liệu Javac về các tuỳ chọn -Xlint để biết thêm thông tin.