Cài đặt Bazel trên Windows

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Báo cáo sự cố Xem nguồn

Trang này mô tả các yêu cầu và bước cài đặt Bazel trên Windows. Hướng dẫn này cũng bao gồm cách 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 Sô cô la hoặc Scom.

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

Khuyến nghị: Windows 10 64 bit, phiên bản 1703 (Bản cập nhật 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 Start (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 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: Dùng Bazelisk

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

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

Để Bazel dễ dàng truy cập được từ lời 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 đườ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 vĩnh viễn. Hãy xem cách đặt biến môi trường.

Xong

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

Để kiểm tra xem bản cài đặt đã chính xác chưa, hãy thử chạy:

bazel version

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

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

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

  • MSS2 x86_64

    MSYS2 là một nền tảng phần mềm và xây dựng phần mềm cho Windows. Gói này 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, các thuộc tính này có thể 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 hiển thị lỗi nếu mục tiêu bản dựng cần Bash nhưng Bazel không thể xác định vị trí.

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

    Bạn có thể sẽ cần những phần tử 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 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ở thiết bị đầu cuối MSYS2 và chạy lệnh sau:

    pacman -S zip unzip patch diffutils git
    

    Không bắt buộc: Nếu bạn muốn sử dụng Bazel qua 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.

  • Công cụ xây dựng cho Visual Studio 2019

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

    Đồng thời được hỗ trợ:

    • Công cụ xây dựng Visual C++ 2017 (hoặc mới hơn) và Windows 10 SDK
  • Bộ phát triển Java SE 11 (JDK) dành cho Windows x64

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

    Cũng được hỗ trợ: Java 8, 9 và 10

  • Python 3.6 cho Windows x86-64

    Bạn sẽ cần mã 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

Lý do có thể xảy ra:

  • bạn đã cài đặt MSYS2 không ở trong đườ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 đó không có tác dụng:

  1. Chuyển đến Trình đơn Start > Settings.

  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 ("Biến người dùng cho <tên người dùng>") và nhấp vào nút "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 thư mục đó.

    Ví dụ: giá trị nà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. Trường "Giá trị biến" hiệ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ờ, ứng dụng sẽ tìm thấy Bash.

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

Lý do có thể xảy ra:

  • 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 SDK Windows

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

Giải pháp:

  1. Chuyển đến Trình đơn Start > Settings.

  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 ("Biến người dùng cho <tên người dùng>") và nhấp vào nút "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 qua thư mục..."

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

    Ví dụ: giá trị nà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. Trường "Giá trị biến" hiệ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ờ, thiết bị sẽ tìm thấy Visual C++.

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

Sử dụng sô cô la

  1. Cài đặt trình quản lý gói Sô cô la

  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 lệnh đó, chẳng hạn như vỏ MSYS2. Tuy nhiên, thao tác này sẽ không cài đặt Visual C++.

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

Sử dụng muỗng

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

    iex (new-object net.webclient).downloadstring('https://get.scoop.sh')
    
  2. Cài đặt gói Bazel:

    scoop install bazel
    

Xem Hướng dẫn cài đặt uỷ quyền và bảo trì gói để biết thêm thông tin về gói Scom.

Xây dựng từ nguồn

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