Cài đặt Bazel trên Windows

Báo cáo vấn đề Xem nguồn Hằng đêm · 7,3 · 7.2 · 7.1 · 7 · 6,5

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

Cài đặt Bazel

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

Kiểm tra hệ thống của bạn

Nên dùng: Windows 10 64 bit, phiên bản 1703 (Bản cập nhật của 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 và 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ủa mình.

Cài đặt đ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 Bazel 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 rồi 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 để đặt biến này thành vĩnh viễn. Tìm hiểu cách đặt biến môi trường.

Xong

"Success: You've installed Bazel" (Thành công: Bạn đã cài đặt Bazel).

Để kiểm tra xem đã cài đặt chính xác chưa, 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 tạo, bạn sẽ cần:

  • MSYS2 x86_64

    MSYS2 là bản phân phối phần mềm và nền tảng xây dựng cho Windows. Ứng dụng này chứa Bash và Unix thông thường (như grep, tar, git).

    Bạn sẽ cần có 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, genrule, sh_binary, sh_test, nhưng có thể còn có nhiều quy tắc khác (chẳng hạn như quy tắc Starlark). Bazel cho thấy một nếu mục tiêu bản dựng cần Bash nhưng Bazel không tìm được mục tiêu đó.

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

    Bạn có thể sẽ cần những dữ liệ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, nên 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ở cửa sổ dòng lệnh 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 từ CMD hoặc Powershell mà vẫn có thể để sử dụng 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.

    Cũng được hỗ trợ:

    • Công cụ xây dựng Visual C++ 2017 (trở lên) và SDK Windows 10
  • Bộ phát triển Java SE 11 (JDK) dành cho Windows x64

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

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

  • Python 3.6 dành 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

Những nguyên nhân có thể xảy ra:

  • bạn đã cài đặt MSYS2 không nằm 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 này không hiệu quả, hãy làm như sau:

  1. Chuyển đến Trình đơn Start (Bắt đầu) > Cài đặt.

  2. Tìm chế độ cài đặt "Chỉnh sửa các 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>") rồi nhấp vào "Mới..." nút 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 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á trị biến" trường 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ở cửa sổ dòng lệnh cmd.exe hoặc PowerShell mới và chạy Bazel ngay bây giờ, hệ thống sẽ tìm thấy Bash.

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

Những nguyên nhân có thể xảy ra:

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

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

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

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

Giải pháp:

  1. Chuyển đến Trình đơn Start (Bắt đầu) > Cài đặt.

  2. Tìm chế độ cài đặt "Chỉnh sửa các 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>") rồi nhấp vào "Mới..." nút 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ụ: đâ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á trị biến" trường hiện có đường dẫn đến VC. Nhấp vào OK để đóng cửa sổ.

  9. Xong.

    Nếu bạn mở cửa sổ dòng lệnh cmd.exe hoặc PowerShell mới và chạy Bazel ngay bây giờ, hệ thống sẽ tìm thấy Visual C++.

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

Sử dụng sô cô la

  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 Bazel mới nhất hiện có và các phần phụ thuộc của nó, chẳng hạn như shell MSYS2. Thao tác này sẽ không cài đặt Visual C++ nhưng.

Xem bài viết Lắp đặt và bảo trì gói Chocolatey hướng dẫn để biết thêm thông tin thông tin về gói Chocolatey.

Sử dụng Muỗng

  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
    

Xem phần Cài đặt Muỗng và bảo trì gói hướng dẫn để 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 bài viết Biên dịch từ nguồn.