Bạn có thể tải các hàm sau từ @bazel_tools//tools/build_defs/repo:http.bzl
.
Quy tắc tải tệp và lưu trữ xuống qua HTTP.
Thiết lập
Để sử dụng các quy tắc này, hãy tải trong tệp WORKSPACE
như sau:
load(
"@bazel_tools//tools/build_defs/repo:http.bzl",
"http_archive",
"http_file",
"http_jar",
)
Các quy tắc này là phiên bản cải tiến của các quy tắc http gốc và sẽ thay thế các quy tắc gốc.
http_archive
http_archive(name, add_prefix, auth_patterns, build_file, build_file_content, canonical_id, integrity, netrc, patch_args, patch_cmds, patch_cmds_win, patch_tool, patches, remote_file_integrity, remote_file_urls, remote_patch_strip, remote_patches, repo_mapping, sha256, strip_prefix, type, url, urls, workspace_file, workspace_file_content)
Tải kho lưu trữ Bazel xuống dưới dạng tệp lưu trữ nén, giải nén tệp đó và cung cấp các mục tiêu của kho lưu trữ đó để liên kết.
Bộ công cụ này hỗ trợ các đuôi tệp sau: "zip"
, "jar"
, "war"
, "aar"
, "tar"
, "tar.gz"
, "tgz"
, "tar.xz"
, "txz"
, "tar.zst"
, "tzst"
, tar.bz2
, "ar"
, hoặc "deb"
.
Ví dụ: Giả sử kho lưu trữ hiện tại chứa mã nguồn của một chương trình trò chuyện, bị can thiệp vào hệ thống tại thư mục ~/chat-app
. Ứng dụng này cần phụ thuộc vào thư viện SSL có tại http://example.com/openssl.zip. Tệp .zip
này chứa cấu trúc thư mục sau:
WORKSPACE
src/
openssl.cc
openssl.h
Trong kho lưu trữ cục bộ, người dùng tạo một tệp openssl.BUILD
có chứa định nghĩa mục tiêu sau đây:
cc_library(
name = "openssl-lib",
srcs = ["src/openssl.cc"],
hdrs = ["src/openssl.h"],
)
Các mục tiêu trong kho lưu trữ ~/chat-app
có thể phụ thuộc vào mục tiêu này nếu các dòng sau được thêm vào ~/chat-app/WORKSPACE
:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
name = "my_ssl",
url = "http://example.com/openssl.zip",
sha256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
build_file = "@//:openssl.BUILD",
)
Khi đó, các mục tiêu sẽ chỉ định @my_ssl//:openssl-lib
làm phần phụ thuộc.
Thuộc tính
name |
Tên; bắt buộc
Tên riêng biệt cho kho lưu trữ này. |
add_prefix |
Chuỗi; không bắt buộc
Thư mục đích liên quan đến thư mục kho lưu trữ. Tệp lưu trữ sẽ được giải nén vào thư mục này, sau khi áp dụng `strip_prefix` (nếu có) cho các đường dẫn tệp trong tệp lưu trữ. Ví dụ: tệp "foo-1.2.3/src/foo.h" sẽ được giải nén thành "bar/src/foo.h" nếu "add_prefix = "bar"" và "strip_prefix = "foo-1.2.3"". |
auth_patterns |
Từ điển: Chuỗi -> Chuỗi; không bắt buộc
Một lệnh chính tả không bắt buộc ánh xạ tên máy chủ lưu trữ tới mẫu uỷ quyền tuỳ chỉnh.
Nếu tên máy chủ của URL xuất hiện trong lệnh này, thì giá trị sẽ được dùng làm mẫu khi tạo tiêu đề uỷ quyền cho yêu cầu http. Điều này cho phép sử dụng các giao thức uỷ quyền tuỳ chỉnh được dùng trong nhiều nhà cung cấp bộ nhớ trên đám mây phổ biến.
Mẫu này hiện hỗ trợ 2 mã thông báo: auth_patterns = { "storage.cloudprovider.com": "Bearer <password>" }netrc: machine storage.cloudprovider.com password RANDOM-TOKENYêu cầu HTTP cuối cùng sẽ có tiêu đề sau: Authorization: Bearer RANDOM-TOKEN |
build_file |
Nhãn; không bắt buộc
Tệp để sử dụng làm tệp BUILD cho kho lưu trữ này.Thuộc tính này là nhãn tuyệt đối (sử dụng '@//' cho kho lưu trữ chính). Tệp này không cần phải được đặt tên là BUILD, nhưng có thể là (chẳng hạn như BUILD.new-repo-name có thể hoạt động tốt để phân biệt với các tệp BUILD thực tế của kho lưu trữ. Bạn có thể chỉ định build_file hoặc build_file_content nhưng không được chỉ định cả hai. |
build_file_content |
Chuỗi; không bắt buộc
Nội dung của tệp BUILD cho kho lưu trữ này. Bạn có thể chỉ định build_file hoặc build_file_content nhưng không được chỉ định cả hai. |
canonical_id |
Chuỗi; không bắt buộc
Mã nhận dạng chính tắc của tệp được tải xuống. Nếu tệp được chỉ định và không được để trống, Bazel sẽ không lấy tệp từ bộ nhớ đệm, trừ phi tệp đó được thêm vào bộ nhớ đệm bằng một yêu cầu có cùng mã chính tắc. Nếu không được chỉ định hoặc trống, thì theo mặc định, Bazel sẽ sử dụng URL của tệp làm mã nhận dạng chính tắc. Điều này giúp bạn phát hiện lỗi phổ biến khi cập nhật URL mà không cập nhật hàm băm, dẫn đến các bản dựng thành công cục bộ nhưng không thành công trên máy nếu không có tệp trong bộ nhớ đệm. Bạn có thể vô hiệu hoá hành vi này bằng --repo_env=BAZEL_HTTP_QUS_URL_AS_DEFAULT_CANONICS_ID=0. |
integrity |
Chuỗi; không bắt buộc
Giá trị tổng kiểm dự kiến ở định dạng Tính toàn vẹn của tài nguyên phụ của tệp đã tải xuống. Giá trị này phải khớp với tổng kiểm của tệp đã tải xuống. _Bạn sẽ gặp rủi ro về bảo mật nếu bỏ qua giá trị tổng kiểm vì các tệp từ xa có thể thay đổi._ Tốt nhất là nếu bỏ qua trường này, bản dựng của bạn sẽ không bị đóng. Bạn không bắt buộc phải tạo quy trình phát triển dễ dàng hơn. Tuy nhiên, bạn nên đặt thuộc tính này hoặc "sha256" trước khi vận chuyển. |
netrc |
Chuỗi; không bắt buộc
Vị trí của tệp .netrc dùng để xác thực |
patch_args |
Danh sách các chuỗi; không bắt buộc
Các đối số được cung cấp cho công cụ vá. Mặc định là -p0, tuy nhiên, -p1 thường sẽ cần thiết cho các bản vá được git tạo. Nếu bạn chỉ định nhiều đối số -p, thì đối số cuối cùng sẽ có hiệu lực.Nếu các đối số khác không phải -p được chỉ định, Bazel sẽ quay lại sử dụng công cụ dòng lệnh vá thay vì triển khai bản vá gốc Bazel. Khi quay lại dùng công cụ dòng lệnh vá và thuộc tính patch_tool không được chỉ định, "patch" sẽ được sử dụng. Vấn đề này chỉ ảnh hưởng đến các tệp bản vá trong thuộc tính "bản vá". |
patch_cmds |
Danh sách các chuỗi; không bắt buộc
Trình tự các lệnh Bash sẽ được áp dụng trên Linux/Macos sau khi áp dụng bản vá. |
patch_cmds_win |
Danh sách các chuỗi; không bắt buộc
Trình tự các lệnh Powershell sẽ được áp dụng trên Windows sau khi áp dụng bản vá. Nếu bạn không đặt thuộc tính này, patch_cmds sẽ được thực thi trên Windows và buộc phải có tệp nhị phân Bash. |
patch_tool |
Chuỗi; không bắt buộc
Tiện ích patch(1) nên sử dụng. Nếu bạn chỉ định điều này, Bazel sẽ sử dụng công cụ vá được chỉ định thay vì triển khai bản vá gốc Bazel. |
patches |
Danh sách nhãn; không bắt buộc
Danh sách các tệp sẽ được áp dụng dưới dạng bản vá sau khi giải nén bản lưu trữ. Theo mặc định, công cụ này sử dụng phương thức triển khai bản vá gốc Bazel không hỗ trợ tính năng so khớp mờ và bản vá nhị phân. Tuy nhiên, Bazel sẽ quay lại sử dụng công cụ dòng lệnh của bản vá nếu thuộc tính "patch_tool" được chỉ định hoặc có các đối số khác "-p" trong thuộc tính "patch_args". |
remote_file_integrity |
Từ điển: Chuỗi -> Chuỗi; không bắt buộc
Ánh xạ các đường dẫn tương đối của tệp (khoá) với giá trị tính toàn vẹn (giá trị) của tệp. Các đường dẫn tương đối này phải ánh xạ đến các tệp (khoá) trong thuộc tính "remote_file_urls". |
remote_file_urls |
Từ điển: Chuỗi -> Danh sách chuỗi; không bắt buộc
Sơ đồ ánh xạ các đường dẫn tương đối (khoá) đến danh sách URL (giá trị) sẽ được tải xuống và xuất hiện dưới dạng các tệp được phủ trong kho lưu trữ. Thao tác này rất hữu ích khi bạn muốn thêm các tệp WORKSPACE hoặc BUILD.bazel phía trên kho lưu trữ hiện có. Các tệp được tải xuống trước khi áp dụng bản vá trong thuộc tính "bản vá" và danh sách URL đều phải là bản sao của cùng một tệp. Các URL được thử theo thứ tự cho đến khi thành công. |
remote_patch_strip |
Số nguyên; không bắt buộc
Số dấu gạch chéo ở đầu cần xóa khỏi tên tệp trong bản vá từ xa. |
remote_patches |
Từ điển: Chuỗi -> Chuỗi; không bắt buộc
Sơ đồ liên kết URL của tệp bản vá với giá trị tính toàn vẹn. Các URL này được áp dụng sau khi trích xuất bản lưu trữ và trước khi áp dụng tệp bản vá từ thuộc tính "bản vá". Công cụ này sử dụng phương thức triển khai bản vá gốc Bazel, bạn có thể chỉ định số dải bản vá bằng `remote_patch_strip` |
repo_mapping |
Từ điển: Chuỗi -> Chuỗi; bắt buộc
Một từ điển từ tên kho lưu trữ cục bộ thành tên kho lưu trữ toàn cục. Điều này cho phép bạn kiểm soát quá trình phân giải phần phụ thuộc không gian làm việc cho các phần phụ thuộc của kho lưu trữ này. Ví dụ: một mục "@foo": "@bar"" khai báo rằng mỗi khi kho lưu trữ này phụ thuộc vào "@foo" (chẳng hạn như phần phụ thuộc trên "@foo//some:target", thì phần phụ thuộc đó sẽ thực sự giải quyết phần phụ thuộc đó trong "@bar" được khai báo trên toàn cầu ("@bar//some:target"). |
sha256 |
Chuỗi; không bắt buộc
SHA-256 dự kiến của tệp được tải xuống. Mã này phải khớp với SHA-256 của tệp được tải xuống. _Bạn sẽ gặp rủi ro về bảo mật nếu bỏ qua SHA-256 vì các tệp từ xa có thể thay đổi._ Tốt nhất là nếu bỏ qua trường này, bản dựng của bạn sẽ không bị ngắt quãng. Không bắt buộc phải giúp quá trình phát triển dễ dàng hơn, nhưng bạn phải đặt thuộc tính này hoặc "tính toàn vẹn" trước khi vận chuyển. |
strip_prefix |
Chuỗi; không bắt buộc
Tiền tố thư mục để xóa khỏi các tệp đã giải nén. Nhiều tệp lưu trữ có một thư mục cấp cao nhất chứa mọi tệp hữu ích trong kho lưu trữ. Thay vì cần chỉ định nhiều lần tiền tố này trong "build_file", bạn có thể dùng trường này để loại bỏ trường này khỏi tất cả các tệp đã trích xuất. Ví dụ: giả sử bạn đang sử dụng "foo-lib-Latest.zip", chứa thư mục "foo-lib-1.2.3/" trong đó có một tệp "WORKSPACE" và các thư mục "src/", "lib/" và "test/" chứa mã thực mà bạn muốn tạo. Chỉ định "strip_prefix = "foo-lib-1.2.3"" để dùng thư mục "foo-lib-1.2.3" làm thư mục cấp cao nhất. Xin lưu ý rằng nếu có các tệp bên ngoài thư mục này, thì các tệp đó sẽ bị loại bỏ và không thể truy cập được (ví dụ: tệp giấy phép cấp cao nhất). Bao gồm cả các tệp/thư mục bắt đầu bằng tiền tố nhưng không nằm trong thư mục đó (ví dụ: "foo-lib-1.2.3.release-notes`). Nếu tiền tố được chỉ định không khớp với một thư mục trong kho lưu trữ, Bazel sẽ trả về lỗi. |
type |
Chuỗi; không bắt buộc
Loại lưu trữ của tệp đã tải xuống. Theo mặc định, loại tệp lưu trữ được xác định từ đuôi tệp của URL. Nếu tệp không có đuôi, bạn có thể chỉ định rõ một trong các giá trị sau: ""zip"", ""jar"", ""war"", `"aar"`, `"tar"`, `"tar.gz"`, `"tgz"`, `"tar.xz"`, `"txz"`, `"tar.zst"`, `"tzst", `"tar.zst"`, `"tzst". |
url |
Chuỗi; không bắt buộc
URL đến một tệp sẽ được cung cấp cho Bazel. Đây phải là tệp, URL http hoặc https. Đã thực hiện lệnh chuyển hướng. Không hỗ trợ tính năng xác thực. Bạn có thể sử dụng tham số url linh hoạt hơn để chỉ định các URL thay thế để tìm nạp. |
urls |
Danh sách các chuỗi; không bắt buộc
Danh sách URL dẫn đến một tệp sẽ được cung cấp cho Bazel. Mỗi mục nhập phải là một tệp, URL http hoặc https. Đã thực hiện lệnh chuyển hướng. Không hỗ trợ tính năng xác thực. Các URL được thử theo thứ tự cho đến khi thành công, vì vậy trước tiên bạn nên liệt kê các bản sao cục bộ. Nếu tất cả các lượt tải xuống đều không thành công, thì quy tắc này sẽ không thành công. |
workspace_file |
Nhãn; không bắt buộc
Tệp này để sử dụng làm tệp "WORKSPACE" cho kho lưu trữ này. Bạn có thể chỉ định "workspace_file" hoặc "workspace_file_content" hoặc không chỉ định, nhưng không thể chỉ định cả hai. |
workspace_file_content |
Chuỗi; không bắt buộc
Nội dung của tệp WORKSPACE cho kho lưu trữ này. Bạn có thể chỉ định "workspace_file" hoặc "workspace_file_content" hoặc không chỉ định, nhưng không thể chỉ định cả hai. |
http_file
http_file(name, auth_patterns, canonical_id, downloaded_file_path, executable, integrity, netrc, repo_mapping, sha256, url, urls)
Tải tệp xuống từ một URL và cung cấp tệp đó để sử dụng dưới dạng nhóm tệp.
Ví dụ: Giả sử bạn cần có một gói debian cho các quy tắc tuỳ chỉnh của mình. Gói này có tại http://example.com/package.deb. Sau đó, bạn có thể thêm vào tệp WORKSPACE:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_file")
http_file(
name = "my_deb",
url = "http://example.com/package.deb",
sha256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
)
Các mục tiêu sẽ chỉ định @my_deb//file
làm phần phụ thuộc để phụ thuộc vào tệp này.
Thuộc tính
name |
Tên; bắt buộc
Tên riêng biệt cho kho lưu trữ này. |
auth_patterns |
Từ điển: Chuỗi -> Chuỗi; không bắt buộc
Một lệnh chính tả không bắt buộc ánh xạ tên máy chủ lưu trữ tới mẫu uỷ quyền tuỳ chỉnh.
Nếu tên máy chủ của URL xuất hiện trong lệnh này, thì giá trị sẽ được dùng làm mẫu khi tạo tiêu đề uỷ quyền cho yêu cầu http. Điều này cho phép sử dụng các giao thức uỷ quyền tuỳ chỉnh được dùng trong nhiều nhà cung cấp bộ nhớ trên đám mây phổ biến.
Mẫu này hiện hỗ trợ 2 mã thông báo: auth_patterns = { "storage.cloudprovider.com": "Bearer <password>" }netrc: machine storage.cloudprovider.com password RANDOM-TOKENYêu cầu HTTP cuối cùng sẽ có tiêu đề sau: Authorization: Bearer RANDOM-TOKEN |
canonical_id |
Chuỗi; không bắt buộc
Mã nhận dạng chính tắc của tệp được tải xuống. Nếu tệp được chỉ định và không được để trống, Bazel sẽ không lấy tệp từ bộ nhớ đệm, trừ phi tệp đó được thêm vào bộ nhớ đệm bằng một yêu cầu có cùng mã chính tắc. Nếu không được chỉ định hoặc trống, thì theo mặc định, Bazel sẽ sử dụng URL của tệp làm mã nhận dạng chính tắc. Điều này giúp bạn phát hiện lỗi phổ biến khi cập nhật URL mà không cập nhật hàm băm, dẫn đến các bản dựng thành công cục bộ nhưng không thành công trên máy nếu không có tệp trong bộ nhớ đệm. Bạn có thể vô hiệu hoá hành vi này bằng --repo_env=BAZEL_HTTP_QUS_URL_AS_DEFAULT_CANONICS_ID=0. |
downloaded_file_path |
Chuỗi; không bắt buộc
Đường dẫn được gán cho tệp được tải xuống |
executable |
Boolean; không bắt buộc
Liệu tệp đã tải xuống có phải là tệp thực thi hay không. |
integrity |
Chuỗi; không bắt buộc
Giá trị tổng kiểm dự kiến ở định dạng Tính toàn vẹn của tài nguyên phụ của tệp đã tải xuống. Giá trị này phải khớp với tổng kiểm của tệp đã tải xuống. _Bạn sẽ gặp rủi ro về bảo mật nếu bỏ qua giá trị tổng kiểm vì các tệp từ xa có thể thay đổi._ Tốt nhất là nếu bỏ qua trường này, bản dựng của bạn sẽ không bị đóng. Bạn không bắt buộc phải tạo quy trình phát triển dễ dàng hơn. Tuy nhiên, bạn nên đặt thuộc tính này hoặc "sha256" trước khi vận chuyển. |
netrc |
Chuỗi; không bắt buộc
Vị trí của tệp .netrc dùng để xác thực |
repo_mapping |
Từ điển: Chuỗi -> Chuỗi; bắt buộc
Một từ điển từ tên kho lưu trữ cục bộ thành tên kho lưu trữ toàn cục. Điều này cho phép bạn kiểm soát quá trình phân giải phần phụ thuộc không gian làm việc cho các phần phụ thuộc của kho lưu trữ này. Ví dụ: một mục "@foo": "@bar"" khai báo rằng mỗi khi kho lưu trữ này phụ thuộc vào "@foo" (chẳng hạn như phần phụ thuộc trên "@foo//some:target", thì phần phụ thuộc đó sẽ thực sự giải quyết phần phụ thuộc đó trong "@bar" được khai báo trên toàn cầu ("@bar//some:target"). |
sha256 |
Chuỗi; không bắt buộc
SHA-256 dự kiến của tệp được tải xuống. Mã này phải khớp với SHA-256 của tệp được tải xuống. _Bạn sẽ gặp rủi ro về bảo mật nếu bỏ qua SHA-256 vì các tệp từ xa có thể thay đổi._ Tốt nhất là nếu bỏ qua trường này, bản dựng của bạn sẽ không bị ngắt quãng. Bạn không bắt buộc phải thiết lập để quá trình phát triển dễ dàng hơn, nhưng nên thiết lập trước khi vận chuyển. |
url |
Chuỗi; không bắt buộc
URL đến một tệp sẽ được cung cấp cho Bazel. Đây phải là tệp, URL http hoặc https. Đã thực hiện lệnh chuyển hướng. Không hỗ trợ tính năng xác thực. Bạn có thể sử dụng tham số url linh hoạt hơn để chỉ định các URL thay thế để tìm nạp. |
urls |
Danh sách các chuỗi; không bắt buộc
Danh sách URL dẫn đến một tệp sẽ được cung cấp cho Bazel. Mỗi mục nhập phải là một tệp, URL http hoặc https. Đã thực hiện lệnh chuyển hướng. Không hỗ trợ tính năng xác thực. Các URL được thử theo thứ tự cho đến khi thành công, vì vậy trước tiên bạn nên liệt kê các bản sao cục bộ. Nếu tất cả các lượt tải xuống đều không thành công, thì quy tắc này sẽ không thành công. |
http_jar
http_jar(name, auth_patterns, canonical_id, downloaded_file_name, integrity, netrc, repo_mapping, sha256, url, urls)
Tải tệp jar xuống từ một URL và cung cấp tệp này dưới dạng java_import
Tệp được tải xuống phải có đuôi .jar.
Ví dụ: Giả sử kho lưu trữ hiện tại chứa mã nguồn của một chương trình trò chuyện, đã được can thiệp vào hệ thống tại thư mục ~/chat-app
. Giao diện này cần phụ thuộc vào một thư viện SSL có trên
http://example.com/openssl-0.2.jar
.
Các mục tiêu trong kho lưu trữ ~/chat-app
có thể phụ thuộc vào mục tiêu này nếu các dòng sau được thêm vào ~/chat-app/WORKSPACE
:
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_jar")
http_jar(
name = "my_ssl",
url = "http://example.com/openssl-0.2.jar",
sha256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
)
Các mục tiêu sẽ chỉ định @my_ssl//jar
làm phần phụ thuộc để phụ thuộc vào jar này.
Bạn cũng có thể tham chiếu các tệp trên hệ thống hiện tại (localhost) bằng cách sử dụng "file:///path/to/file" nếu bạn đang sử dụng các hệ thống dựa trên Unix. Nếu bạn đang dùng Windows, hãy sử dụng "file:///c:/path/to/file". Trong cả hai ví dụ, hãy lưu ý 3 dấu gạch chéo (/
) – 2 dấu gạch chéo đầu tiên thuộc về file://
và 2 dấu gạch chéo thứ ba thuộc về đường dẫn tuyệt đối đến tệp.
Thuộc tính
name |
Tên; bắt buộc
Tên riêng biệt cho kho lưu trữ này. |
auth_patterns |
Từ điển: Chuỗi -> Chuỗi; không bắt buộc
Một lệnh chính tả không bắt buộc ánh xạ tên máy chủ lưu trữ tới mẫu uỷ quyền tuỳ chỉnh.
Nếu tên máy chủ của URL xuất hiện trong lệnh này, thì giá trị sẽ được dùng làm mẫu khi tạo tiêu đề uỷ quyền cho yêu cầu http. Điều này cho phép sử dụng các giao thức uỷ quyền tuỳ chỉnh được dùng trong nhiều nhà cung cấp bộ nhớ trên đám mây phổ biến.
Mẫu này hiện hỗ trợ 2 mã thông báo: auth_patterns = { "storage.cloudprovider.com": "Bearer <password>" }netrc: machine storage.cloudprovider.com password RANDOM-TOKENYêu cầu HTTP cuối cùng sẽ có tiêu đề sau: Authorization: Bearer RANDOM-TOKEN |
canonical_id |
Chuỗi; không bắt buộc
Mã nhận dạng chính tắc của tệp được tải xuống. Nếu tệp được chỉ định và không được để trống, Bazel sẽ không lấy tệp từ bộ nhớ đệm, trừ phi tệp đó được thêm vào bộ nhớ đệm bằng một yêu cầu có cùng mã chính tắc. Nếu không được chỉ định hoặc trống, thì theo mặc định, Bazel sẽ sử dụng URL của tệp làm mã nhận dạng chính tắc. Điều này giúp bạn phát hiện lỗi phổ biến khi cập nhật URL mà không cập nhật hàm băm, dẫn đến các bản dựng thành công cục bộ nhưng không thành công trên máy nếu không có tệp trong bộ nhớ đệm. Bạn có thể vô hiệu hoá hành vi này bằng --repo_env=BAZEL_HTTP_QUS_URL_AS_DEFAULT_CANONICS_ID=0. |
downloaded_file_name |
Chuỗi; không bắt buộc
Tên tệp được chỉ định cho tệp đã tải xuống |
integrity |
Chuỗi; không bắt buộc
Giá trị tổng kiểm dự kiến ở định dạng Tính toàn vẹn của tài nguyên phụ của tệp đã tải xuống. Giá trị này phải khớp với tổng kiểm của tệp đã tải xuống. _Bạn sẽ gặp rủi ro về bảo mật nếu bỏ qua giá trị tổng kiểm vì các tệp từ xa có thể thay đổi._ Tốt nhất là nếu bỏ qua trường này, bản dựng của bạn sẽ không bị đóng. Bạn không bắt buộc phải tạo quy trình phát triển dễ dàng hơn. Tuy nhiên, bạn nên đặt thuộc tính này hoặc "sha256" trước khi vận chuyển. |
netrc |
Chuỗi; không bắt buộc
Vị trí của tệp .netrc dùng để xác thực |
repo_mapping |
Từ điển: Chuỗi -> Chuỗi; bắt buộc
Một từ điển từ tên kho lưu trữ cục bộ thành tên kho lưu trữ toàn cục. Điều này cho phép bạn kiểm soát quá trình phân giải phần phụ thuộc không gian làm việc cho các phần phụ thuộc của kho lưu trữ này. Ví dụ: một mục "@foo": "@bar"" khai báo rằng mỗi khi kho lưu trữ này phụ thuộc vào "@foo" (chẳng hạn như phần phụ thuộc trên "@foo//some:target", thì phần phụ thuộc đó sẽ thực sự giải quyết phần phụ thuộc đó trong "@bar" được khai báo trên toàn cầu ("@bar//some:target"). |
sha256 |
Chuỗi; không bắt buộc
SHA-256 dự kiến của tệp được tải xuống. Mã này phải khớp với SHA-256 của tệp được tải xuống. _Bạn sẽ gặp rủi ro về bảo mật nếu bỏ qua SHA-256 vì các tệp từ xa có thể thay đổi._ Tốt nhất là nếu bỏ qua trường này, bản dựng của bạn sẽ không bị ngắt quãng. Không bắt buộc phải giúp quá trình phát triển dễ dàng hơn, nhưng bạn phải đặt thuộc tính này hoặc "tính toàn vẹn" trước khi vận chuyển. |
url |
Chuỗi; không bắt buộc
URL đến một tệp sẽ được cung cấp cho Bazel. Đây phải là tệp, URL http hoặc https. Đã thực hiện lệnh chuyển hướng. Không hỗ trợ tính năng xác thực. Bạn có thể sử dụng tham số url linh hoạt hơn để chỉ định các URL thay thế để tìm nạp. URL phải kết thúc bằng.jar`. |
urls |
Danh sách các chuỗi; không bắt buộc
Danh sách URL dẫn đến một tệp sẽ được cung cấp cho Bazel. Mỗi mục nhập phải là một tệp, URL http hoặc https. Đã thực hiện lệnh chuyển hướng. Không hỗ trợ tính năng xác thực. Các URL được thử theo thứ tự cho đến khi thành công, vì vậy trước tiên bạn nên liệt kê các bản sao cục bộ. Nếu tất cả các lượt tải xuống đều không thành công, thì quy tắc này sẽ không thành công. Tất cả URL phải kết thúc bằng.jar. |