Chương trình đăng ký tham gia sự kiện BazelCon 2024 đã bắt đầu!

Trang này được dịch bởi Cloud Translation API.

Biên dịch Bazel từ nguồn

Báo cáo vấn đề Xem nguồn Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Trang này mô tả cách cài đặt Bazel từ nguồn và cung cấp các mẹo khắc phục sự cố thường gặp.

Để tạo Bazel từ nguồn, bạn có thể làm theo một trong những cách sau:

Tạo bằng tệp nhị phân Bazel hiện có
Tạo mà không cần tệp nhị phân Bazel hiện có, còn gọi là khởi động.

Tạo Bazel bằng Bazel

Tóm tắt

Tải bản phát hành Bazel mới nhất trên trang phát hành GitHub hoặc thông qua Bazelisk.
Tải các nguồn của Bazel xuống từ GitHub rồi trích xuất ở một nơi nào đó. Ngoài ra, bạn có thể sao chép cây nguồn từ https://github.com/bazelbuild/bazel
Cài đặt các điều kiện tiên quyết giống như khi khởi động (xem phần dành cho các hệ thống giống Unix hoặc dành cho Windows)
Tạo bản phát triển của Bazel bằng Bazel: bazel build //src:bazel-dev (hoặc bazel build //src:bazel-dev.exe trên Windows)
Tệp nhị phân thu được nằm ở bazel-bin/src/bazel-dev (hoặc bazel-bin\src\bazel-dev.exe trên Windows). Bạn có thể sao chép tệp này bất cứ nơi nào bạn muốn và sử dụng ngay mà không cần cài đặt thêm.

Hãy xem hướng dẫn chi tiết bên dưới.

Bước 1: Tải bản phát hành Bazel mới nhất

Mục tiêu: Cài đặt hoặc tải phiên bản phát hành của Bazel xuống. Đảm bảo bạn có thể chạy ứng dụng này bằng cách nhập bazel vào một thiết bị đầu cuối.

Lý do: Để tạo Bazel từ cây nguồn GitHub, bạn cần có sẵn tệp nhị phân Bazel. Bạn có thể cài đặt một ứng dụng trên trình quản lý gói hoặc tải xuống từ GitHub. Hãy xem phần Cài đặt Bazel. (Hoặc bạn có thể tạo từ đầu (bootstrap).)

Khắc phục sự cố:

Nếu bạn không thể chạy Bazel bằng cách nhập bazel vào một thiết bị đầu cuối:
- Có thể thư mục của tệp nhị phân Bazel không có trong PATH.
  
  Đây không phải là vấn đề lớn. Thay vì nhập bazel, bạn cần nhập đường dẫn đầy đủ.
- Có thể chính tệp nhị phân Bazel không được gọi là bazel (trên Unix) hoặc bazel.exe (trên Windows).
  
  Đây không phải là vấn đề lớn. Bạn có thể đổi tên tệp nhị phân hoặc nhập tên của tệp nhị phân thay vì bazel.
- Có thể tệp nhị phân không thực thi được (trên Unix).
  
  Bạn phải làm cho tệp nhị phân này có thể thực thi bằng cách chạy chmod +x /path/to/bazel.

Bước 2: Tải nguồn của Bazel xuống từ GitHub

Nếu bạn quen thuộc với Git, thì chỉ cần git Nhân bản https://github.com/bazelbuild/bazel

Nếu không thì:

Tải các nguồn mới nhất xuống dưới dạng tệp zip.
Giải nén nội dung ở một nơi nào đó.

Ví dụ: tạo thư mục bazel-src trong thư mục gốc và giải nén tại đó.

Bước 3: Cài đặt các điều kiện tiên quyết

Cài đặt các điều kiện tiên quyết giống như khi khởi động (xem bên dưới) – JDK, trình biên dịch C++, MSYS2 (nếu bạn đang xây dựng trên Windows), v.v.

Bước 4a: Xây dựng Bazel trên Ubuntu Linux, macOS và các hệ thống tương tự Unix khác

Để biết hướng dẫn dành cho Windows, hãy xem bài viết Tạo Bazel trên Windows.

Mục tiêu: Chạy Bazel để tạo một tệp nhị phân Bazel tuỳ chỉnh (bazel-bin/src/bazel-dev).

Hướng dẫn:

Khởi động một thiết bị đầu cuối Bash
cd vào thư mục bạn đã trích xuất (hoặc sao chép) các nguồn của Bazel.

Ví dụ: nếu bạn đã trích xuất các nguồn trong thư mục gốc, hãy chạy:
```
cd ~/bazel-src
```
Tạo Bazel từ nguồn:
```
bazel build //src:bazel-dev
```
Ngoài ra, bạn có thể chạy bazel build //src:bazel --compilation_mode=opt để tạo một tệp nhị phân nhỏ hơn nhưng quá trình tạo sẽ chậm hơn.
Kết quả sẽ xuất hiện tại bazel-bin/src/bazel-dev (hoặc bazel-bin/src/bazel).

Bước 4b: Tạo Bazel trên Windows

Để biết hướng dẫn về các hệ thống giống Unix, hãy xem phần Ubuntu Linux, macOS và các hệ thống giống Unix khác.

Mục tiêu: Chạy Bazel để tạo tệp nhị phân Bazel tuỳ chỉnh (bazel-bin\src\bazel-dev.exe).

Hướng dẫn:

Khởi động Dấu nhắc lệnh (Start Menu > Run > "cmd.exe")
cd vào thư mục mà bạn đã trích xuất (hoặc nhân bản) các nguồn của Bazel.

Ví dụ: nếu bạn đã trích xuất các nguồn trong thư mục gốc, hãy chạy:
```
cd %USERPROFILE%\bazel-src
```
Tạo Bazel từ nguồn:
```
bazel build //src:bazel-dev.exe
```
Ngoài ra, bạn có thể chạy bazel build //src:bazel.exe --compilation_mode=opt để tạo một tệp nhị phân nhỏ hơn nhưng quá trình tạo sẽ chậm hơn.
Kết quả sẽ xuất hiện tại bazel-bin\src\bazel-dev.exe (hoặc bazel-bin\src\bazel.exe).

Bước 5: Cài đặt tệp nhị phân đã tạo

Thực ra, bạn không cần cài đặt gì cả.

Kết quả của bước trước là một tệp nhị phân Bazel độc lập. Bạn có thể sao chép tệp này vào bất kỳ thư mục nào và sử dụng ngay lập tức. (Sẽ rất hữu ích nếu thư mục đó nằm trên PATH để bạn có thể chạy "bazel" ở mọi nơi.)

Tạo Bazel từ đầu (khởi động)

Bạn cũng có thể tạo Bazel từ đầu mà không cần sử dụng tệp nhị phân Bazel hiện có.

Bước 1: Tải nguồn của Bazel (bản lưu trữ phân phối)

(Bước này giống nhau đối với tất cả nền tảng.)

Tải bazel-<version>-dist.zip xuống từ GitHub, ví dụ: bazel-0.28.1-dist.zip.

Chú ý:
- Có một tệp lưu trữ phân phối duy nhất, độc lập với cấu trúc. Không có bản lưu trữ phân phối dành riêng cho cấu trúc hoặc hệ điều hành.
- Các nguồn này không giống với cây nguồn GitHub. Bạn phải sử dụng bản lưu trữ phân phối để khởi động Bazel. Bạn không thể sử dụng cây nguồn được nhân bản từ GitHub. (Bản lưu trữ phân phối chứa các tệp nguồn đã tạo cần thiết để khởi động và không thuộc cây nguồn Git thông thường.)
Giải nén tệp lưu trữ phân phối vào đâu đó trên ổ đĩa.

Bạn nên xác minh chữ ký do khoá phát hành 3D5919B448457EE0 của Bazel tạo.

Bước 2a: Khởi động Bazel trên Ubuntu Linux, macOS và các hệ thống giống Unix khác

Để biết hướng dẫn dành cho Windows, hãy xem bài viết Khởi động Bazel trên Windows.

2.1. Cài đặt các điều kiện tiên quyết

Bash
nén, giải nén
Chuỗi công cụ bản dựng C++
JDK. Bắt buộc phải có phiên bản 21.
Python. Phiên bản 2 và 3 được hỗ trợ, bạn chỉ cần cài đặt một trong hai phiên bản này.

Ví dụ: trên Ubuntu Linux, bạn có thể cài đặt các yêu cầu này bằng lệnh sau:

sudo apt-get install build-essential openjdk-21-jdk python zip unzip

2.2. Khởi động Bazel trên Unix

Mở một cửa sổ shell hoặc Terminal (Dòng lệnh).
cd vào thư mục bạn đã giải nén tệp lưu trữ phân phối.
Chạy tập lệnh biên dịch: env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" bash ./compile.sh.

Kết quả biên dịch được đặt vào output/bazel. Đây là một tệp nhị phân Bazel độc lập, không có JDK được nhúng. Bạn có thể sao chép mã này ở bất cứ đâu hoặc sử dụng ngay tại chỗ. Để thuận tiện, hãy sao chép tệp nhị phân này vào một thư mục trên PATH của bạn (chẳng hạn như /usr/local/bin trên Linux).

Để tạo tệp nhị phân bazel theo cách có thể tái tạo, hãy đặt cả SOURCE_DATE_EPOCH trong bước "Chạy tập lệnh biên dịch".

Bước 2b: Khởi động Bazel trên Windows

Để biết hướng dẫn dành cho các hệ thống giống Unix, hãy xem bài viết Bootstrap Bazel trên Ubuntu Linux, macOS và các hệ thống giống Unix khác.

2.1. Cài đặt các điều kiện tiên quyết

Vỏ MsYS2
Các gói MSYS2 để zip và giải nén. Chạy lệnh sau trong shell MSYS2:
```
pacman -S zip unzip patch
```
Trình biên dịch Visual C++. Cài đặt trình biên dịch Visual C++ trong Visual Studio 2015 trở lên hoặc bằng cách cài đặt Công cụ xây dựng mới nhất cho Visual Studio 2017.
JDK. Phải dùng phiên bản 21.
Python. Phiên bản 2 và 3 được hỗ trợ, bạn chỉ cần cài đặt một trong hai phiên bản này là đủ. Bạn cần phiên bản gốc dành cho Windows (có thể tải xuống từ https://www.python.org). Các phiên bản được cài đặt thông qua pacman trong MSYS2 sẽ không hoạt động.

2.2. Khởi động Bazel trên Windows

Mở shell MSYS2.
Thiết lập các biến môi trường sau:
- BAZEL_VS hoặc BAZEL_VC (chúng không giống nhau): Đặt thành đường dẫn đến thư mục Visual Studio (BAZEL_VS) hoặc thư mục Visual C++ (BAZEL_VC). Bạn chỉ cần thiết lập một trong số các giá trị này.
- BAZEL_SH: Đường dẫn của bash.exe MSYS2. Xem lệnh trong các ví dụ bên dưới.
  
  Đừng đặt giá trị này thành C:\Windows\System32\bash.exe. (Bạn có tệp đó nếu đã cài đặt Hệ thống con Windows dành cho Linux.) Bazel không hỗ trợ phiên bản bash.exe này.
- PATH: Thêm thư mục Python.
- JAVA_HOME: Đặt thành thư mục JDK.
Ví dụ (sử dụng BAZEL_VS):
```
export BAZEL_VS="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools"
export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))"
export PATH="/c/python27:$PATH"
export JAVA_HOME="C:/Program Files/Java/jdk-21"
```
hoặc (sử dụng BAZEL_VC):
```
export BAZEL_VC="C:/Program Files (x86)/Microsoft Visual Studio/2017/BuildTools/VC"
export BAZEL_SH="$(cygpath -m $(realpath $(which bash)))"
export PATH="/c/python27:$PATH"
export JAVA_HOME="C:/Program Files/Java/jdk-21"
```
cd vào thư mục mà bạn đã giải nén bản lưu trữ phân phối.
Chạy tập lệnh biên dịch: env EXTRA_BAZEL_ARGS="--tool_java_runtime_version=local_jdk" ./compile.sh

Kết quả biên dịch được đặt vào output/bazel.exe. Đây là tệp nhị phân Bazel độc lập, không có JDK được nhúng. Bạn có thể sao chép mã này ở bất cứ đâu hoặc sử dụng ngay tại chỗ. Để thuận tiện, hãy sao chép tệp nhị phân này vào một thư mục trên PATH.

Để tạo tệp nhị phân bazel.exe theo cách có thể tái tạo, hãy đặt cả SOURCE_DATE_EPOCH trong bước "Chạy tập lệnh biên dịch".

Bạn không cần chạy Bazel từ shell MSYS2. Bạn có thể chạy Bazel từ Dấu nhắc lệnh (cmd.exe) hoặc PowerShell.