Bazel xây dựng phần mềm từ mã nguồn được sắp xếp trong cây thư mục gọi là kho lưu trữ. Một nhóm kho lưu trữ đã xác định sẽ bao gồm không gian làm việc. Các tệp nguồn trong kho lưu trữ được sắp xếp theo hệ phân cấp gói lồng nhau, trong đó mỗi gói là một thư mục chứa một tập hợp các tệp nguồn có liên quan và một tệp BUILD. Tệp BUILD chỉ định những đầu ra phần mềm có thể được tạo từ nguồn.
Kho lưu trữ
Các tệp nguồn dùng trong một bản dựng Bazel được sắp xếp trong kho lưu trữ (thường được viết tắt thành repos). Kho lưu trữ là một cây thư mục có tệp đánh dấu ranh giới ở gốc; tệp đánh dấu ranh giới như vậy có thể là MODULE.bazel, REPO.bazel hoặc trong ngữ cảnh cũ, WORKSPACE hoặc WORKSPACE.bazel.
Kho lưu trữ mà lệnh Bazel hiện tại đang chạy được gọi là kho lưu trữ chính. Các kho lưu trữ (bên ngoài) khác được xác định theo quy tắc kho lưu trữ; hãy xem bài viết tổng quan về các phần phụ thuộc bên ngoài để biết thêm thông tin.
Workspace
Không gian làm việc là môi trường dùng chung cho tất cả các lệnh Bazel chạy từ cùng một kho lưu trữ chính. Tệp này bao gồm kho lưu trữ chính và tập hợp tất cả các kho lưu trữ bên ngoài đã xác định.
Xin lưu ý rằng trước đây, các khái niệm "kho lưu trữ" và "không gian làm việc" đã được kết hợp với nhau. Thuật ngữ "không gian làm việc" thường được dùng để chỉ kho lưu trữ chính. Đôi khi, thuật ngữ này còn được dùng để chỉ "kho lưu trữ" chính.
Gói
Đơn vị chính để sắp xếp mã trong kho lưu trữ là gói. Gói là một tập hợp các tệp có liên quan và thông số kỹ thuật về cách dùng các tệp đó để tạo ra cấu phần phần mềm đầu ra.
Gói được định nghĩa là một thư mục chứa tệp BUILD có tên là BUILD hoặc BUILD.bazel. Một gói bao gồm tất cả tệp trong thư mục của gói đó, cùng với tất cả các thư mục con bên dưới, ngoại trừ những thư mục con chứa tệp BUILD. Theo định nghĩa này, không có tệp hoặc thư mục nào có thể thuộc hai gói khác nhau.
Ví dụ: trong cây thư mục sau đây, có hai gói là my/app và gói con my/app/tests. Xin lưu ý my/app/data không phải là một gói mà là một thư mục thuộc gói my/app.
src/my/app/BUILD
src/my/app/app.cc
src/my/app/data/input.txt
src/my/app/tests/BUILD
src/my/app/tests/test.cc
Mục tiêu
Gói là một vùng chứa các mục tiêu, được xác định trong tệp BUILD của gói. Hầu hết mục tiêu là một trong hai loại chính, tệp và quy tắc.
Tệp được chia thành hai loại. Tệp nguồn thường được viết bằng nỗ lực của mọi người và được đăng ký vào kho lưu trữ. Tệp đã tạo (đôi khi được gọi là tệp phái sinh hoặc tệp đầu ra) không được xác nhận mà chỉ được tạo từ các tệp nguồn.
Loại mục tiêu thứ hai được khai báo bằng một quy tắc. Mỗi thực thể quy tắc chỉ định mối quan hệ giữa một tập hợp các tệp đầu vào và một tập hợp các tệp đầu ra. Dữ liệu đầu vào cho một quy tắc có thể là tệp nguồn, nhưng cũng có thể là đầu ra của các quy tắc khác.
Trong hầu hết các trường hợp, cho dù đầu vào cho quy tắc là tệp nguồn hay tệp được tạo đều là không quan trọng; điều quan trọng chỉ là nội dung của tệp đó. Thực tế này giúp bạn dễ dàng thay thế một tệp nguồn phức tạp bằng một tệp được tạo theo quy tắc, chẳng hạn như khi gánh nặng của việc duy trì một tệp có cấu trúc cao trở nên quá mệt mỏi và có người viết một chương trình để lấy nó. Người dùng của tệp đó không bắt buộc phải thay đổi. Ngược lại, tệp đã tạo có thể dễ dàng được thay thế bằng tệp nguồn chỉ có những thay đổi cục bộ.
Dữ liệu đầu vào cho một quy tắc cũng có thể bao gồm các quy tắc khác. Ý nghĩa chính xác của các mối quan hệ như vậy thường khá phức tạp và phụ thuộc vào ngôn ngữ hoặc quy tắc, nhưng về mặt trực quan thì đơn giản: quy tắc thư viện C++ A có thể có một quy tắc B khác của thư viện C++ cho dữ liệu đầu vào. Tác động của phần phụ thuộc này là các tệp tiêu đề của B sẽ được cung cấp cho A trong quá trình biên dịch, các biểu tượng của B sẽ được cung cấp cho A trong quá trình liên kết và dữ liệu thời gian chạy của B được cung cấp cho A trong quá trình thực thi.
Một điểm bất biến của mọi quy tắc là các tệp do quy tắc tạo ra luôn thuộc cùng một gói với chính quy tắc đó; bạn không thể tạo tệp vào một gói khác. Mặc dù vậy, nhiều trường hợp dữ liệu đầu vào của một quy tắc lại đến từ một gói khác.
Nhóm gói là tập hợp các gói có mục đích giới hạn khả năng hỗ trợ tiếp cận của một số quy tắc nhất định. Nhóm gói được xác định bằng hàm package_group. Các đối tượng này có 3 thuộc tính: danh sách các gói chứa trong đó, tên và các nhóm gói khác có trong đó. Bạn chỉ được phép sử dụng thuộc tính visibility của các quy tắc hoặc thuộc tính default_visibility của hàm package để tham chiếu đến các API này. Các cách này không tạo hoặc sử dụng tệp. Để biết thêm thông tin, hãy tham khảo tài liệu về package_group.