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 của bạn.

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

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

Cài đặt bằng Homebrew

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

Cài đặt Homebrew (bước 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 tệp nhị phân

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

Trình cài đặt này 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ác 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, để hỗ trợ quy tắc ios_*, bạn phải cài đặt Xcode 6.1 trở lên với SDK iOS 8.1 trên hệ thống.

Tải Xcode xuống từ App Store hoặc trang web dành cho nhà phát triển của 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 từ trang Bản 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ừ dòng lệnh bằ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ợ tính năng 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 và đặt đường dẫn .bazelrc thành $HOME/.bazelrc. Sử dụng lệnh --help để xem các tuỳ 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 từ dòng lệnh bằng curl để khắc phục; 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 đã cài đặt thành công Bazel 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 Bazel mới hơn, hãy tải xuống và cài đặt phiên bản mong muốn.