Sau đây là một số vấn đề và câu hỏi thường gặp về tiện ích viết.
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 thi?
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 tệp đó trực tiếp:
bazel build //pkg:myfile.txtNếu tệp nằm trong một 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 được tạo tự động bất cứ khi nào mục tiêu của bạn được đề cập trên dòng lệnh, hãy thêm tệp đó vào đầu ra mặc định của quy tắc bằng cách trả về trì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 một nội dung nào đó phụ thuộc vào mục tiêu.
Thiếu tệp khi thực thi thao tác hoặc tệp nhị phân
Đảm bảo rằng 1) tệp đã được đăng ký làm dữ liệu đầu vào cho thao tác 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 bằng đường dẫn chính xác.
Đối với các hành động, bạn khai báo dữ liệu đầu vào bằng cách truyền dữ liệu đó vào 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 do lệnh bazel run hoặc bazel test chạy), bạn khai báo dữ liệu đầu vào bằng cách đưa dữ liệu đó vào runfiles. Thay vì sử dụng trường path, hãy sử dụng File.short_path. Đây là đường dẫn của tệp tương ứng với thư mục runfiles (tệp chạy) nơi tệp nhị phân thực thi.
Làm cách nào để kiểm soát những tệp nào được tạo bằng bazel build //pkg:mytarget?
Sử dụng trình cung cấp DefaultInfo để đặt đầu ra mặc định.
Làm cách nào để chạy một chương trình hoặc thực hiện I/O tệp trong bản dựng?
Bạn có thể khai báo một công cụ dưới dạng mục tiêu, giống như bất kỳ phần nào khác trong 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 một công cụ, hãy sử dụng ctx.actions.run và truyền công cụ đó dưới dạng tham số executable.
Trong các giai đoạn tải và phân tích, 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 dữ liệu có cấu trú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ưới dạng tệp .bzl. Bạn có thể load() tệp để truy cập vào tệp đó trong các 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 thao tác và tệp thực thi cần tệp này 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ể truyền một chuỗi ký tự cố định (có thể được trích dẫn ba lần) đến tham số doc của rule hoặc attr.*(). Đối với các hàm và macro trợ giúp, hãy sử dụng chuỗi ký tự docstring được trích dẫn ba lần theo định dạng được cung cấp tại đây.
Các hàm triển khai quy tắc thường không cần docstring riêng.
Việc sử dụng chuỗi cố định ở những vị trí dự kiến sẽ giúp công cụ tự động dễ dàng trích xuất tài liệu hơn. Bạn có thể sử dụng chú thích không phải chuỗi tiêu chuẩn bất cứ khi nào chú thích đó có thể giúp ích cho người đọc mã của bạn.