การติดตั้ง Bazel บน Windows

รายงานปัญหา ดูแหล่งที่มา

หน้านี้อธิบายข้อกําหนดและขั้นตอนการติดตั้ง Bazel บน Windows นอกจากนี้ยังรวมถึงการแก้ปัญหาและวิธีอื่นๆ ในการติดตั้ง Bazel เช่น การใช้ช็อกโกแลตหรือสกู๊ป

การติดตั้ง Bazel

หัวข้อนี้จะครอบคลุมข้อกําหนดเบื้องต้น การตั้งค่าสภาพแวดล้อม และขั้นตอนโดยละเอียดระหว่างการติดตั้งบน Windows

ตรวจสอบระบบ

แนะนํา: Windows 10 เวอร์ชัน 64 บิต เวอร์ชัน 1703 (การอัปเดตสําหรับครีเอเตอร์) ขึ้นไป

วิธีตรวจสอบเวอร์ชัน Windows

  • คลิกปุ่ม "เริ่ม"
  • พิมพ์ winver ในช่องค้นหา แล้วกด Enter
  • คุณจะเห็นช่อง "เกี่ยวกับ Windows" ที่มีข้อมูลเวอร์ชันของ Windows

ติดตั้งข้อกําหนดเบื้องต้น

ดาวน์โหลด Bazel

แนะนํา: ใช้ Bazelisk

หรือทําดังนี้

ตั้งค่าสภาพแวดล้อม

เพื่อให้เปลี่ยนชื่อ Bazel จาก Command Prompt หรือ PowerShell ได้ง่ายๆ โดยค่าเริ่มต้น คุณสามารถเปลี่ยนชื่อไบนารี Bazel เป็น bazel.exe แล้วเพิ่มลงในเส้นทางเริ่มต้นได้

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

นอกจากนี้ คุณยังเปลี่ยนตัวแปรสภาพแวดล้อมของระบบ PATH เพื่อทําให้เป็นแบบถาวรได้ ดูวิธีตั้งค่าตัวแปรสภาพแวดล้อม

เสร็จเรียบร้อย

"สําเร็จ: คุณติดตั้ง Bazel แล้ว"

หากต้องการตรวจสอบว่าการติดตั้งถูกต้องหรือไม่ ให้ลองเรียกใช้

bazel version

คุณสามารถดูเคล็ดลับและคําแนะนําเพิ่มเติมได้ที่นี่

การติดตั้งคอมไพเลอร์และรันไทม์ของภาษา

คุณจะต้องมีสิ่งต่อไปนี้โดยขึ้นอยู่กับภาษาที่คุณต้องการสร้าง

  • MSYS2 x 86_64

    MSYS2 เป็นแพลตฟอร์มการสร้างซอฟต์แวร์และการสร้างกรอบสําหรับ Windows มีเครื่องมือ Bash และเครื่องมือ Unix ที่ใช้กันทั่วไป (เช่น grep, tar, git)

    คุณจะต้องใช้ MSYS2 เพื่อสร้าง ทดสอบ หรือเรียกใช้เป้าหมายที่ขึ้นอยู่กับ Bash ซึ่งมักจะเป็น genrule, sh_binary, sh_test แต่อาจมีมากกว่านี้ (เช่น กฎ Starlark) Bazel จะแสดงข้อผิดพลาดหากเป้าหมายบิลด์ต้องการ Bash แต่ Bazel ไม่พบ

  • แพ็กเกจ MSYS2 ทั่วไป

    คุณอาจต้องใช้สิ่งเหล่านี้เพื่อสร้างและเรียกใช้เป้าหมายที่อาศัย Bash ขณะที่ MSYS2 จะไม่ติดตั้งเครื่องมือเหล่านี้โดยค่าเริ่มต้น คุณจึงต้องติดตั้งด้วยตนเอง โปรเจ็กต์ที่ต้องใช้เครื่องมือ Bash ใน PATH ต้องทําขั้นตอนนี้ (เช่น TensorFlow)

    เปิดเทอร์มินัล MSYS2 แล้วเรียกใช้คําสั่งนี้

    pacman -S zip unzip patch diffutils git

    ไม่บังคับ: หากต้องการใช้ Bazel จาก CMD หรือ Powershell แต่ยังคงใช้เครื่องมือ Bash ได้ ให้เพิ่ม MSYS2_INSTALL_PATH/usr/bin ลงในตัวแปรสภาพแวดล้อม PATH

  • สร้างเครื่องมือสําหรับ Visual Studio ปี 2019

    คุณจะต้องสร้างโค้ด C++ ใน Windows

    และยังรองรับ

    • Visual C++ Build Tools 2017 (หรือใหม่กว่า) และ Windows 10 SDK

  • Java SE Development Kit 11 (JDK) สําหรับ Windows x64

    คุณจะต้องสร้างโค้ด Java ใน Windows

    รองรับ: Java 8, 9 และ 10

  • Python 3.6 สําหรับ Windows x86-64

    คุณจะต้องใช้โค้ดนี้เพื่อสร้างโค้ด Python ใน Windows

    รองรับ: Python 2.7 ขึ้นไปสําหรับ Windows x86-64

การแก้ปัญหา

Bazel ไม่พบ Bash หรือ bash.exe

สาเหตุที่เป็นไปได้

  • คุณติดตั้ง MSYS2 ไว้ใต้เส้นทางการติดตั้งเริ่มต้น

  • คุณติดตั้ง MSYS2 i686 แทน MSYS2 x86_64

  • คุณติดตั้ง MSYS แทน MSYS2

วิธีแก้ไข

ตรวจสอบว่าคุณได้ติดตั้ง MSYS2 x86_64 แล้ว

หากไม่ได้ผล ให้ทําดังนี้

  1. ไปที่เมนูเริ่ม > การตั้งค่า

  2. หาการตั้งค่า "แก้ไขตัวแปรสภาพแวดล้อมสําหรับบัญชีของคุณ"

  3. ดูรายการที่ด้านบน ("ตัวแปรผู้ใช้สําหรับ <ชื่อผู้ใช้>") แล้วคลิกปุ่ม "ใหม่..." ใต้รายการ

  4. ป้อน "ชื่อตัวแปร" BAZEL_SH

  5. คลิก "เรียกดูไฟล์..."

  6. ไปที่ไดเรกทอรี MSYS2 แล้วไปที่ usr\bin ที่ด้านล่าง

    เช่น อาจเป็น C:\msys64\usr\bin ในระบบของคุณ

  7. เลือกไฟล์ bash.exe หรือ bash แล้วคลิกตกลง

  8. ตอนนี้ช่อง "ค่าตัวแปร" มีเส้นทางไปยัง bash.exe คลิก "ตกลง" เพื่อปิดหน้าต่าง

  9. เสร็จ

    หากคุณเปิดเทอร์มินัล cmd.exe หรือ PowerShell ใหม่และเรียกใช้ Bazel เลย คุณจะเห็น Bash

Bazel ไม่พบ Visual Studio หรือ Visual C++

สาเหตุที่เป็นไปได้

  • คุณติดตั้ง Visual Studio หลายเวอร์ชันแล้ว

  • คุณติดตั้งและนํา Visual Studio เวอร์ชันต่างๆ ออก

  • คุณติดตั้ง Windows SDK เวอร์ชันต่างๆ

  • คุณติดตั้ง Visual Studio ไม่ได้อยู่ในเส้นทางการติดตั้งเริ่มต้น

วิธีแก้ไข

  1. ไปที่เมนูเริ่ม > การตั้งค่า

  2. หาการตั้งค่า "แก้ไขตัวแปรสภาพแวดล้อมสําหรับบัญชีของคุณ"

  3. ดูรายการที่ด้านบน ("ตัวแปรผู้ใช้สําหรับ <ชื่อผู้ใช้>") แล้วคลิกปุ่ม "ใหม่..." ใต้รายการ

  4. ป้อน "ชื่อตัวแปร" BAZEL_VC

  5. คลิก "เรียกดูไดเรกทอรี..."

  6. ไปที่ไดเรกทอรี VC ของ Visual Studio

    ตัวอย่างเช่น นี่อาจเป็นC:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC ในระบบของคุณ

  7. เลือกโฟลเดอร์ VC แล้วคลิก "ตกลง"

  8. ตอนนี้ช่อง "ค่าตัวแปร" มีเส้นทางไปยัง VC คลิก "ตกลง" เพื่อปิดหน้าต่าง

  9. เสร็จ

    หากคุณเปิดเทอร์มินัล cmd.exe หรือ PowerShell ใหม่และเรียกใช้ Bazel เลย คุณจะเห็น Visual C++

วิธีอื่นๆ ในการติดตั้ง Bazel

การใช้ช็อกโกแลต

  1. ติดตั้งตัวจัดการแพ็กเกจช็อกโกแลต

  2. ติดตั้งแพ็กเกจ Bazel

    choco install bazel

    คําสั่งนี้จะติดตั้ง Bazel เวอร์ชันล่าสุดและทรัพยากร Dependency อย่างเช่น Ball MSYS2 แต่จะไม่ติดตั้ง Visual C++

ดูข้อมูลเพิ่มเติมเกี่ยวกับแพ็กเกจช็อกโกแลตแท้ได้ที่คู่มือการติดตั้งช็อกโกแลตและการบํารุงรักษาแพ็กเกจ

การใช้สกรู

  1. ติดตั้งตัวจัดการแพ็กเกจ Scoop โดยใช้คําสั่ง PowerShell ต่อไปนี้

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

  2. ติดตั้งแพ็กเกจ Bazel

    scoop install bazel

ดูข้อมูลเพิ่มเติมเกี่ยวกับแพ็กเกจ Scoop ได้ที่คู่มือการติดตั้งและการบํารุงรักษาแพ็กเกจ

สร้างจากแหล่งที่มา

หากต้องการสร้าง Bazel ใหม่ตั้งแต่ต้น ให้ติดตั้งการรวบรวมจากแหล่งที่มา