quy tắc kho lưu trữ git

Bạn có thể tải các hàm sau từ @bazel_tools//tools/build_defs/repo:git.bzl.

Quy tắc sao chép kho lưu trữ git bên ngoài.

git_repository

load("@bazel//tools/build_defs/repo:git.bzl", "git_repository")

git_repository(name, branch, build_file, build_file_content, commit, init_submodules, patch_args,
               patch_cmds, patch_cmds_win, patch_tool, patches, recursive_init_submodules, remote,
               repo_mapping, shallow_since, strip_prefix, tag, verbose, workspace_file,
               workspace_file_content)

Sao chép kho lưu trữ git bên ngoài.

Sao chép kho lưu trữ Git, kiểm tra thẻ hoặc cam kết đã chỉ định và cung cấp các mục tiêu để liên kết. Ngoài ra, hãy xác định mã của thay đổi thực sự được kiểm tra và ngày của thay đổi đó, đồng thời trả về một từ điển có các tham số cung cấp phiên bản có thể tái tạo của quy tắc này (không nhất thiết phải là thẻ).

Trước tiên, Bazel sẽ cố gắng thực hiện một lượt tìm nạp nông chỉ của thay đổi đã chỉ định. Nếu không thành công (thường là do thiếu tính năng hỗ trợ máy chủ), thì quá trình này sẽ quay lại phương thức tìm nạp toàn bộ kho lưu trữ.

Ưu tiên http_archive hơn git_repository. Lý do là:

Các quy tắc của kho lưu trữ Git phụ thuộc vào git(1) của hệ thống, trong khi trình tải xuống HTTP được tích hợp vào Bazel và không có phần phụ thuộc hệ thống.
http_archive hỗ trợ danh sách urls dưới dạng bản sao và git_repository chỉ hỗ trợ một remote.
http_archive hoạt động với bộ nhớ đệm kho lưu trữ, nhưng không hoạt động với git_repository. Hãy xem #5116 để biết thêm thông tin.

THUỘC TÍNH

`name`	Tên; bắt buộc Tên duy nhất cho kho lưu trữ này.
`branch`	Chuỗi; không bắt buộc nhánh trong kho lưu trữ từ xa để kiểm tra. Bạn phải chỉ định chính xác một trong các nhánh, thẻ hoặc thay đổi.
`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ên là BUILD, nhưng có thể là (tên như BUILD.new-repo-name có thể phù hợp để phân biệt tệp này với các tệp BUILD thực tế của kho lưu trữ.
`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.
`commit`	Chuỗi; không bắt buộc thay đổi cụ thể cần kiểm tra. Bạn phải chỉ định chính xác một trong các nhánh, thẻ hoặc thay đổi.
`init_submodules`	Boolean; không bắt buộc Liệu có sao chép các mô-đun con trong kho lưu trữ hay không.
`patch_args`	Danh sách 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 bạn chỉ định các đối số khác ngoài -p, thì Bazel sẽ quay lại sử dụng công cụ dòng lệnh bản vá thay vì triển khai bản vá gốc Bazel. Khi quay lại công cụ dòng lệnh vá và không chỉ định thuộc tính patch_tool, hệ thống sẽ sử dụng "patch".
`patch_cmds`	Danh sách 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 các bản vá.
`patch_cmds_win`	Danh sách 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 các 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, yêu cầu tệp nhị phân Bash phải tồn tại.
`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 giá trị 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 tệp 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, nhưng Bazel sẽ quay lại sử dụng công cụ dòng lệnh bản vá nếu thuộc tính `patch_tool` được chỉ định hoặc có các đối số khác ngoài `-p` trong thuộc tính `patch_args`.
`recursive_init_submodules`	Boolean; không bắt buộc Liệu có sao chép các mô-đun con đệ quy trong kho lưu trữ hay không.
`remote`	Chuỗi; bắt buộc URI của kho lưu trữ Git từ xa
`repo_mapping`	Từ điển: Chuỗi -> Chuỗi; không bắt buộc Chỉ trong ngữ cảnh `WORKSPACE`: một từ điển từ tên kho lưu trữ cục bộ đến tên kho lưu trữ toàn cục. Điều này cho phép kiểm soát việc phân giải phần phụ thuộc của 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ục nhập "@foo": "@bar" khai báo rằng, bất cứ khi nào 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ì kho lưu trữ này thực sự sẽ phân giải phần phụ thuộc đó trong "@bar" được khai báo trên toàn cầu ("@bar//some:target"). Thuộc tính này _không_ được hỗ trợ trong ngữ cảnh `MODULE.bazel` (khi gọi quy tắc kho lưu trữ bên trong hàm triển khai của tiện ích mô-đun).
`shallow_since`	Chuỗi; không bắt buộc ngày không bắt buộc, không phải sau lệnh xác nhận được chỉ định; không cho phép đối số nếu một thẻ hoặc nhánh được chỉ định (luôn có thể được sao chép bằng --depth=1). Việc đặt ngày gần với thay đổi cụ thể có thể cho phép sao chép nông của kho lưu trữ ngay cả khi máy chủ không hỗ trợ tính năng tìm nạp nông của các thay đổi tuỳ ý. Do các lỗi trong quá trình triển khai --shallow-since của git, bạn không nên sử dụng thuộc tính này vì có thể dẫn đến lỗi tìm nạp.
`strip_prefix`	Chuỗi; không bắt buộc Tiền tố thư mục cần xoá khỏi các tệp đã trích xuất.
`tag`	Chuỗi; không bắt buộc thẻ trong kho lưu trữ từ xa để kiểm tra. Bạn phải chỉ định chính xác một trong số các nhánh, thẻ hoặc cam kết.
`verbose`	Boolean; không bắt buộc
`workspace_file`	Nhãn; không bắt buộc Tệp 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 cả hai, nhưng không được 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.

new_git_repository

load("@bazel//tools/build_defs/repo:git.bzl", "new_git_repository")

new_git_repository(name, branch, build_file, build_file_content, commit, init_submodules,
                   patch_args, patch_cmds, patch_cmds_win, patch_tool, patches,
                   recursive_init_submodules, remote, repo_mapping, shallow_since, strip_prefix, tag,
                   verbose, workspace_file, workspace_file_content)

Sao chép kho lưu trữ git bên ngoài.

Trước tiên, Bazel sẽ cố gắng thực hiện một tìm nạp nông chỉ đối với lệnh xác nhận đã chỉ định. Nếu không thành công (thường là do thiếu tính năng hỗ trợ máy chủ), thì quá trình này sẽ quay lại phương thức tìm nạp toàn bộ kho lưu trữ.

Ưu tiên http_archive hơn git_repository. Lý do là:

Các quy tắc của kho lưu trữ Git phụ thuộc vào git(1) của hệ thống, trong khi trình tải xuống HTTP được tích hợp vào Bazel và không có phần phụ thuộc hệ thống.
http_archive hỗ trợ danh sách urls dưới dạng bản sao và git_repository chỉ hỗ trợ một remote.
http_archive hoạt động với bộ nhớ đệm kho lưu trữ, nhưng không hoạt động với git_repository. Hãy xem #5116 để biết thêm thông tin.

ĐẶC ĐIỂM

`name`	Tên; bắt buộc Tên duy nhất cho kho lưu trữ này.
`branch`	Chuỗi; không bắt buộc trong kho lưu trữ từ xa để kiểm tra. Bạn phải chỉ định chính xác một trong các nhánh, thẻ hoặc thay đổi.
`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ên là BUILD, nhưng có thể là (tên như BUILD.new-repo-name có thể phù hợp để phân biệt tệp này với các tệp BUILD thực tế của kho lưu trữ.
`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.
`commit`	Chuỗi; không bắt buộc thay đổi cụ thể cần kiểm tra. Bạn phải chỉ định chính xác một trong các nhánh, thẻ hoặc thay đổi.
`init_submodules`	Boolean; không bắt buộc Liệu có sao chép các mô-đun con trong kho lưu trữ hay không.
`patch_args`	Danh sách 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 bạn chỉ định các đối số khác ngoài -p, thì Bazel sẽ quay lại sử dụng công cụ dòng lệnh bản vá thay vì triển khai bản vá gốc Bazel. Khi quay lại công cụ dòng lệnh vá và không chỉ định thuộc tính patch_tool, hệ thống sẽ sử dụng "patch".
`patch_cmds`	Danh sách 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 các bản vá.
`patch_cmds_win`	Danh sách 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 các 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, yêu cầu tệp nhị phân Bash phải tồn tại.
`patch_tool`	Chuỗi; không bắt buộc Tiện ích bản vá(1) để 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 tệp 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".
`recursive_init_submodules`	Boolean; không bắt buộc Liệu có sao chép các mô-đun con đệ quy trong kho lưu trữ hay không.
`remote`	Chuỗi; bắt buộc URI của kho lưu trữ Git từ xa
`repo_mapping`	Từ điển: Chuỗi -> Chuỗi; không bắt buộc Chỉ trong ngữ cảnh `WORKSPACE`: một từ điển từ tên kho lưu trữ cục bộ đến 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ục nhập "@foo": "@bar" khai báo rằng, bất cứ khi nào 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ì kho lưu trữ này thực sự sẽ phân giải phần phụ thuộc đó trong "@bar" được khai báo trên toàn cầu ("@bar//some:target"). Thuộc tính này _không_ được hỗ trợ trong ngữ cảnh `MODULE.bazel` (khi gọi quy tắc kho lưu trữ bên trong hàm triển khai của tiện ích mô-đun).
`shallow_since`	Chuỗi; không bắt buộc ngày không bắt buộc, không phải sau lệnh xác nhận được chỉ định; không cho phép đối số nếu một thẻ hoặc nhánh được chỉ định (luôn có thể được sao chép bằng --depth=1). Việc đặt ngày gần với thay đổi cụ thể có thể cho phép sao chép nông của kho lưu trữ ngay cả khi máy chủ không hỗ trợ tính năng tìm nạp nông của các thay đổi tuỳ ý. Do các lỗi trong quá trình triển khai --shallow-since của git, bạn không nên sử dụng thuộc tính này vì có thể dẫn đến lỗi tìm nạp.
`strip_prefix`	Chuỗi; không bắt buộc Tiền tố thư mục cần xoá khỏi các tệp đã trích xuất.
`tag`	Chuỗi; không bắt buộc thẻ trong kho lưu trữ từ xa để kiểm tra. Bạn phải chỉ định chính xác một trong số các nhánh, thẻ hoặc cam kết.
`verbose`	Boolean; không bắt buộc
`workspace_file`	Nhãn; không bắt buộc Tệp 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 cả hai, nhưng không được 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.