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 có hai 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 trình cài đặt nhị phân
Trình cài đặt nhị phân đang ở trên trang web của Bazel Trang bản phát hành GitHub.
Trình cài đặt này chứa tệp nhị phân Bazel. Một số thư viện bổ sung Bạn cũng phải cài đặt ứng dụng Bazel để 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 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ó Xcode 6.1 trở lên với iOS
SDK 8.1 được cài đặt trên hệ thống của bạn.
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 có sau đây:
sudo xcodebuild -license accept
Bước 2: Tải trình cài đặt Bazel xuống
Tiếp theo, tải xuống trình cài đặt nhị phân Bazel có tên
bazel-<version>-installer-darwin-x86_64.sh từ
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ừ cửa sổ dòng lệnh bằng cách sử dụng curl, thay thế
biến phiên bản có phiên bản Bazel bạn muốn tải xuống:
export BAZEL_VERSION=5.2.0curl -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 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. Dùng lệnh --help để xem
các lựa chọn cài đặt bổ sung.
Nếu bạn dùng macOS Catalina trở lên (macOS >= 11) và gặp lỗi “bazel-real” không thể
được mở vì không thể xác minh nhà phát triển, bạn cần tải xuống lại
trình cài đặt từ thiết bị đầu cuối bằng cách sử dụng curl làm giải pháp; 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 với cờ --user như trên, thì trình cài đặt Bazel
tệp thực thi sẽ được cài đặt trong thư mục HOME/bin của bạn.
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 ~/.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 sau đây:
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.
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/master/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 sau đây:
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 sau đây:
brew upgrade bazel