Cài đặt Bazel trên macOS

Trang này mô tả cách cài đặt Bazel trên macOS và thiết lập môi trường.

Bạn có thể cài đặt Bazel trên macOS bằng một trong những phương thức sau:

• Nên dùng: Sử dụng Bazelisk
• Sử dụng Homebrew
• Sử dụng trình cài đặt nhị phân
• Biên dịch Bazel từ nguồn

Bazel đi kèm với 2 tập lệnh hoàn thành. Sau khi cài đặt Bazel, bạn có thể:

• Truy cập vào tập lệnh hoàn thành bash
• Cài đặt tập lệnh hoàn thành zsh

Cài đặt bằng Homebrew

Bước 1: Cài đặt Homebrew trên macOS

Cài đặt Homebrew (bước thực hiện một lần):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Bước 2: Cài đặt Bazel thông qua Homebrew

Cài đặt gói Bazel thông qua Homebrew như sau:

brew install bazel

Đã hoàn tất! Bạn có thể xác nhận rằng Bazel đã được cài đặt thành công bằng cách chạy lệnh sau:

bazel --version

Sau khi cài đặt, bạn có thể nâng cấp lên phiên bản Bazel mới hơn bằng lệnh sau:

brew upgrade bazel

Cài đặt bằng trình cài đặt nhị phân

Trình cài đặt nhị phân nằm trên trang phát hành của Bazel trên GitHub.

Trình cài đặt chứa tệp nhị phân Bazel. Bạn cũng phải cài đặt một số thư viện bổ sung để Bazel hoạt động.

Bước 1: Cài đặt công cụ dòng lệnh Xcode

Nếu không có ý định sử dụng các quy tắc ios_*, bạn chỉ cần cài đặt gói công cụ dòng lệnh Xcode bằng cách sử dụng xcode-select:

xcode-select --install

Nếu không, để được hỗ trợ quy tắc ios_*, bạn phải cài đặt Xcode 6.1 trở lên có iOS SDK 8.1 trên hệ thống của mình.

Tải Xcode xuống từ App Store hoặc trang web của Nhà phát triển Apple.

Sau khi cài đặt Xcode, hãy chấp nhận thoả thuận cấp phép cho tất cả người dùng bằng lệnh sau:

sudo xcodebuild -license accept

Bước 2: Tải trình cài đặt Bazel xuống

Tiếp theo, hãy tải trình cài đặt nhị phân Bazel có tên bazel-<version>-installer-darwin-x86_64.sh xuống qua trang phát hành Bazel trên GitHub.

Trên macOS Catalina trở lên (macOS >= 11), do các yêu cầu mới của Apple về việc ký ứng dụng, bạn cần tải trình cài đặt xuống từ thiết bị đầu cuối bằng cách sử dụng curl, thay thế biến phiên bản bằng phiên bản Bazel mà bạn muốn tải xuống:

export BAZEL_VERSION=5.2.0
curl -fLO "https://github.com/bazelbuild/bazel/releases/download/$BAZEL_VERSION/bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"

Đây là giải pháp tạm thời cho đến khi quy trình phát hành macOS hỗ trợ việc ký (#9304).

Bước 3: Chạy trình cài đặt

Chạy trình cài đặt Bazel như sau:

chmod +x "bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"
./bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh --user

Cờ --user sẽ cài đặt Bazel vào thư mục $HOME/bin trên hệ thống của bạn và đặt đường dẫn .bazelrc thành $HOME/.bazelrc. Sử dụng lệnh --help để xem các lựa chọn cài đặt khác.

Nếu bạn đang dùng macOS Catalina trở lên (macOS >= 11) và gặp lỗi "không thể mở bazel-real vì không xác minh được nhà phát triển", bạn cần tải lại trình cài đặt xuống từ thiết bị đầu cuối bằng cách dùng curl làm giải pháp thay thế; hãy xem Bước 2 ở trên.

Bước 4: Thiết lập môi trường

Nếu bạn chạy trình cài đặt Bazel bằng cờ --user như trên, thì tệp thực thi Bazel sẽ được cài đặt trong thư mục HOME/bin. Bạn nên thêm thư mục này vào các đường dẫn mặc định, như sau:

export PATH="PATH:HOME/bin"

Bạn cũng có thể thêm lệnh này vào tệp ~/.bashrc, ~/.zshrc hoặc ~/.profile.

Đã hoàn tất! Bạn có thể xác nhận rằng Bazel đã được cài đặt thành công bằng cách chạy lệnh sau:

bazel --version

Để cập nhật lên một bản phát hành mới hơn của Bazel, hãy tải xuống và cài đặt phiên bản bạn muốn.