Cài đặt Bazel trên macOS

Báo cáo sự cố Xem nguồn

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 2 tập lệnh hoàn thành. 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 qua Homebrew

Cài đặt gói Bazel 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 cách sử dụ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 có trên trang phát hành GitHub của Bazel.

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 của Xcode

Nếu không có ý định sử dụng 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à cài đặt 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 tệp nhị phân Bazel có tên là bazel-<version>-installer-darwin-x86_64.sh xuống từ trang phát hành của 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ề ký ứng dụng, bạn cần tải trình cài đặt xuống qua thiết bị đầu cuối 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ợ 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. Hãy dùng lệnh --help để xem các tuỳ chọn cài đặt khác.

Nếu đang dùng macOS Catalina trở lên (macOS >= 11) và gặp lỗi "bazel-real" không mở được do không thể xác minh nhà phát triển, thì bạn cần tải lại trình cài đặt từ thiết bị đầu cuối xuống bằng cách sử dụng curl để khắc phục; 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 đường dẫn mặc định của mì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 phiên bản Bazel mới hơn, hãy tải xuống và cài đặt phiên bản bạn muốn.