Sau đây là một số vấn đề và câu hỏi thường gặp về việc viết phần mở rộng.
Tại sao tệp của tôi không được tạo / hành động của tôi không bao giờ được thực hiện?
Bazel chỉ thực thi các hành động cần thiết để tạo tệp đầu ra được yêu cầu.
Nếu tệp bạn muốn có nhãn, bạn có thể yêu cầu trực tiếp:
bazel build //pkg:myfile.txtNếu tệp nằm trong nhóm đầu ra của mục tiêu, bạn có thể cần chỉ định nhóm đầu ra đó trên dòng lệnh:
bazel build //pkg:mytarget --output_groups=fooNếu bạn muốn tệp này được tạo tự động bất cứ khi nào mục tiêu được đề cập trên dòng lệnh, hãy thêm mục tiêu đó vào kết quả mặc định của quy tắc bằng cách trả về một nhà cung cấp
DefaultInfo.
Hãy xem trang Quy tắc để biết thêm thông tin.
Tại sao hàm triển khai của tôi không được thực thi?
Bazel chỉ phân tích các mục tiêu được yêu cầu cho bản dựng. Bạn nên đặt tên cho mục tiêu trên dòng lệnh hoặc tên nào đó phụ thuộc vào mục tiêu.
Tệp bị thiếu khi hành động hoặc tệp nhị phân của tôi được thực thi
Hãy đảm bảo rằng 1) tệp đã được đăng ký làm dữ liệu đầu vào cho hành động hoặc tệp nhị phân và 2) tập lệnh hoặc công cụ đang được thực thi đang truy cập vào tệp theo đường dẫn chính xác.
Đối với hành động, bạn khai báo dữ liệu đầu vào bằng cách truyền dữ liệu đó đến hàm ctx.actions.* tạo hành động đó. Bạn có thể lấy đường dẫn thích hợp cho tệp bằng cách sử dụng File.path.
Đối với tệp nhị phân (đầu ra có thể thực thi chạy bằng lệnh bazel run hoặc bazel test), bạn khai báo dữ liệu đầu vào bằng cách đưa dữ liệu đầu vào đó vào runfiles. Thay vì sử dụng trường path, hãy dùng File.short_path. Đây là đường dẫn của tệp tương ứng với thư mục runfiles mà tệp nhị phân thực thi.
Làm cách nào để kiểm soát tệp do bazel build //pkg:mytarget tạo?
Sử dụng trình cung cấp DefaultInfo để đặt kết quả đầu ra mặc định.
Làm cách nào để chạy chương trình hoặc tạo tệp I/O trong bản dựng?
Một công cụ có thể được khai báo làm mục tiêu, giống như bất kỳ phần nào khác của bản dựng, và chạy trong giai đoạn thực thi để giúp tạo các mục tiêu khác. Để tạo một thao tác chạy công cụ, hãy sử dụng ctx.actions.run và truyền vào công cụ dưới dạng tham số executable.
Trong các giai đoạn tải và phân tích, một công cụ không thể chạy và bạn cũng không thể thực hiện I/O tệp. Điều này có nghĩa là các công cụ và nội dung tệp (ngoại trừ nội dung của tệp BUILD và .bzl) không thể ảnh hưởng đến cách tạo biểu đồ mục tiêu và hành động.
Nếu tôi cần truy cập vào cùng một loại dữ liệu có cấu trúc cả trước và trong giai đoạn thực thi thì sao?
Bạn có thể định dạng dữ liệu có cấu trúc ở dạng tệp .bzl. Bạn có thể load() tệp để truy cập trong giai đoạn tải và phân tích. Bạn có thể truyền tệp này dưới dạng tệp đầu vào hoặc tệp chạy cho các hành động và tệp thực thi cần đến trong giai đoạn thực thi.
Tôi nên ghi lại mã Starlark như thế nào?
Đối với các quy tắc và thuộc tính quy tắc, bạn có thể chuyển một giá trị cố định dạng chuỗi tài liệu (có thể được trích dẫn ba lần) tới tham số doc của rule hoặc attr.*(). Đối với các hàm trợ giúp và macro, hãy sử dụng một giá trị cố định chuỗi tài liệu được trích dẫn ba lần theo định dạng được nêu tại đây.
Các hàm triển khai quy tắc thường không cần chuỗi tài liệu riêng.
Việc sử dụng giá trị cố định dạng chuỗi ở các vị trí dự kiến giúp công cụ tự động trích xuất tài liệu dễ dàng hơn. Bạn có thể dùng các nhận xét tiêu chuẩn không phải dạng chuỗi ở bất cứ đâu có thể giúp ích cho người đọc mã.