Cài đặt Bazel trên Windows

Báo cáo vấn đề Xem nguồn Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

Trang này mô tả các yêu cầu và bước để cài đặt Bazel trên Windows. Tài liệu này cũng bao gồm thông tin khắc phục sự cố và các cách khác để cài đặt Bazel, chẳng hạn như sử dụng Chocolatey hoặc Scoop.

Cài đặt Bazel

Phần này trình bày các điều kiện tiên quyết, thiết lập môi trường và các bước chi tiết trong quá trình cài đặt trên Windows.

Kiểm tra hệ thống

Đề xuất: Windows 10 64 bit, phiên bản 1703 (Bản cập nhật dành cho nhà sáng tạo) trở lên

Cách kiểm tra phiên bản Windows:

  • Nhấp vào nút Bắt đầu.
  • Nhập winver vào hộp tìm kiếm rồi nhấn Enter.
  • Bạn sẽ thấy hộp Giới thiệu về Windows cùng với thông tin về phiên bản Windows.

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

Tải Bazel xuống

Nên dùng: Sử dụng Bazelisk

Ngoài ra, bạn có thể:

Thiết lập môi trường

Để dễ dàng truy cập vào Bazel từ dấu nhắc lệnh hoặc PowerShell theo mặc định, bạn có thể đổi tên tệp nhị phân Bazel thành bazel.exe và thêm tệp này vào các đường dẫn mặc định.

set PATH=%PATH%;path to the Bazel binary

Bạn cũng có thể thay đổi biến môi trường PATH của hệ thống để biến đổi này có hiệu lực vĩnh viễn. Hãy xem cách thiết lập biến môi trường.

Xong

"Thành công: Bạn đã cài đặt Bazel."

Để kiểm tra xem quá trình cài đặt có chính xác hay không, hãy thử chạy:

bazel version

Tiếp theo, bạn có thể xem thêm các mẹo và hướng dẫn tại đây:

Cài đặt trình biên dịch và thời gian chạy ngôn ngữ

Tuỳ thuộc vào ngôn ngữ bạn muốn xây dựng, bạn sẽ cần:

  • MSYS2 x86_64

    MSYS2 là một nền tảng xây dựng và bản phân phối phần mềm dành cho Windows. Nó chứa Bash và các công cụ Unix phổ biến (như grep, tar, git).

    Bạn sẽ cần MSYS2 để tạo, kiểm thử hoặc chạy các mục tiêu phụ thuộc vào Bash. Thông thường, đây là genrule, sh_binary, sh_test, nhưng có thể có nhiều hơn (chẳng hạn như các quy tắc Starlark). Bazel sẽ cho thấy lỗi nếu mục tiêu xây dựng cần Bash nhưng Bazel không tìm thấy Bash.

  • Các gói MSYS2 phổ biến

    Bạn có thể cần những mục tiêu này để tạo và chạy các mục tiêu phụ thuộc vào Bash. MSYS2 không cài đặt các công cụ này theo mặc định, vì vậy, bạn cần phải cài đặt chúng theo cách thủ công. Các dự án phụ thuộc vào công cụ Bash trong PATH cần bước này (ví dụ: TensorFlow).

    Mở cửa sổ dòng lệnh MSYS2 rồi chạy lệnh này:

    pacman -S zip unzip patch diffutils git

    Không bắt buộc: Nếu bạn muốn sử dụng Bazel từ CMD hoặc Powershell và vẫn có thể sử dụng các công cụ Bash, hãy nhớ thêm MSYS2_INSTALL_PATH/usr/bin vào biến môi trường PATH.

  • Build Tools for Visual Studio 2019

    Bạn sẽ cần công cụ này để tạo mã C++ trên Windows.

    Các loại tệp được hỗ trợ khác:

    • Visual C++ Build Tools 2017 (hoặc phiên bản mới hơn) và Windows 10 SDK

  • Java SE Development Kit 11 (JDK) cho Windows x64

    Bạn sẽ cần có công cụ này để tạo mã Java trên Windows.

    Các phiên bản được hỗ trợ khác: Java 8, 9 và 10

  • Python 3.6 cho Windows x86-64

    Bạn sẽ cần có công cụ này để tạo mã Python trên Windows.

    Cũng được hỗ trợ: Python 2.7 trở lên cho Windows x86-64

Khắc phục sự cố

Bazel không tìm thấy Bash hoặc bash.exe

Nguyên nhân có thể:

  • bạn đã cài đặt MSYS2 không theo đường dẫn cài đặt mặc định

  • bạn đã cài đặt MSYS2 i686 thay vì MSYS2 x86_64

  • bạn đã cài đặt MSYS thay vì MSYS2

Giải pháp:

Đảm bảo bạn đã cài đặt MSYS2 x86_64.

Nếu cách này không hiệu quả, hãy:

  1. Chuyển đến trình đơn Start > Cài đặt.

  2. Tìm chế độ cài đặt "Chỉnh sửa biến môi trường cho tài khoản của bạn"

  3. Xem danh sách ở trên cùng ("User variables for <username>" (Biến người dùng cho <username>)), rồi nhấp vào nút "New..." (Mới...) bên dưới.

  4. Đối với "Tên biến", hãy nhập BAZEL_SH

  5. Nhấp vào "Duyệt qua tệp..."

  6. Chuyển đến thư mục MSYS2, sau đó chuyển đến usr\bin bên dưới.

    Ví dụ: đây có thể là C:\msys64\usr\bin trên hệ thống của bạn.

  7. Chọn tệp bash.exe hoặc bash rồi nhấp vào OK

  8. Giờ đây, trường "Giá trị biến" có đường dẫn đến bash.exe. Nhấp vào OK để đóng cửa sổ.

  9. Xong.

    Nếu bạn mở một thiết bị đầu cuối cmd.exe hoặc PowerShell mới và chạy Bazel ngay bây giờ, thì Bazel sẽ tìm thấy Bash.

Bazel không tìm thấy Visual Studio hoặc Visual C++

Nguyên nhân có thể:

  • bạn đã cài đặt nhiều phiên bản Visual Studio

  • bạn đã cài đặt và gỡ bỏ nhiều phiên bản Visual Studio

  • bạn đã cài đặt nhiều phiên bản Windows SDK

  • bạn đã cài đặt Visual Studio không theo đường dẫn cài đặt mặc định

Giải pháp:

  1. Chuyển đến trình đơn Start > Cài đặt.

  2. Tìm chế độ cài đặt "Chỉnh sửa biến môi trường cho tài khoản của bạn"

  3. Xem danh sách ở trên cùng ("User variables for <username>" (Biến người dùng cho <username>)), rồi nhấp vào nút "New..." (Mới...) bên dưới.

  4. Đối với "Tên biến", hãy nhập BAZEL_VC

  5. Nhấp vào "Duyệt thư mục..."

  6. Chuyển đến thư mục VC của Visual Studio.

    Ví dụ: đây có thể là C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC trên hệ thống của bạn.

  7. Chọn thư mục VC rồi nhấp vào OK

  8. Giờ đây, trường "Giá trị biến" có đường dẫn đến VC. Nhấp vào OK để đóng cửa sổ.

  9. Xong.

    Nếu bạn mở một thiết bị đầu cuối cmd.exe hoặc PowerShell mới và chạy Bazel ngay bây giờ, thì Bazel sẽ tìm thấy Visual C++.

Các cách khác để cài đặt Bazel

Sử dụng Chocolatey

  1. Cài đặt trình quản lý gói Chocolatey

  2. Cài đặt gói Bazel:

    choco install bazel

    Lệnh này sẽ cài đặt phiên bản mới nhất hiện có của Bazel và các phần phụ thuộc của phiên bản đó, chẳng hạn như trình bao MSYS2. Tuy nhiên, thao tác này sẽ không cài đặt Visual C++.

Hãy xem hướng dẫn về cách cài đặt Chocolatey và bảo trì gói để biết thêm thông tin về gói Chocolatey.

Sử dụng Scoop

  1. Cài đặt trình quản lý gói Scoop bằng lệnh PowerShell sau:

    iex (new-object net.webclient).downloadstring('https://get.scoop.sh')

  2. Cài đặt gói Bazel:

    scoop install bazel

Hãy xem Hướng dẫn cài đặt Scoop và bảo trì gói để biết thêm thông tin về gói Scoop.

Tạo từ nguồn

Để tạo Bazel từ đầu thay vì cài đặt, hãy xem phần Biên dịch từ nguồn.