התקנת Bazel ב-Windows

דף זה מתאר את הדרישות ואת השלבים להתקנת Bazel ב-Windows. הוא כולל גם פתרון בעיות ודרכים אחרות להתקין את Bazel, כמו שימוש בשוקולד או בסקופ.

התקנת Bazel

הקטע הזה מפרט את הדרישות המוקדמות, הגדרת הסביבה ואת השלבים המפורטים במהלך ההתקנה ב-Windows.

בדיקת המערכת

מומלץ: 64 סיביות של Windows 10, גרסה 1703 (עדכון ליוצרים) או גרסה חדשה יותר

כדי לבדוק את הגרסה של Windows:

  • לוחצים על הלחצן 'התחלה'.
  • מקלידים winver בתיבת החיפוש ומקישים על Enter.
  • אמורה להופיע התיבה 'מידע על Windows' עם פרטי הגרסה של Windows.

תמיכה נוספת:

  • גרסת 64 ביט ל-Windows 7 ומעלה

  • 64-bit Windows Server 2008 R2 ומעלה

התקנת הדרישות המוקדמות

הורדת Bazel

מומלץ: השתמשו ב-Bazlisk

לחלופין, אפשר:

הגדרת הסביבה

כדי להפוך את Bazel לנגיש בקלות מהודעות פקודה או PowerShell כברירת מחדל, אפשר לשנות את השם של הקובץ הבינארי של Bazel ל-bazel.exe ולהוסיף אותו לנתיבי ברירת המחדל שלך.

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

אפשר גם לשנות את משתנה הסביבה PATH של המערכת כדי להפוך אותו לקבוע. בקישור הבא מוסבר איך להגדיר משתני סביבה.

סיום

"הצלחה: התקנת את Bazel."

כדי לבדוק אם ההתקנה נכונה, כדאי לנסות להריץ את:

bazel version

בשלב הבא, ריכזנו כאן טיפים נוספים והדרכה:

התקנת הידור וזמני ריצה של שפות

בהתאם לשפות שרוצים לבנות, תצטרכו:

  • MSYS2 x86_64

    MSYS2 היא הפצה ובניית תוכנה של Windows. היא מכילה כלי חד-פעמיים נפוצים ו-Unix (כמו grep, tar, git).

    יהיה צורך ב-MSYS2 כדי ליצור, לבדוק או להפעיל יעדים שתלויים ב-Bash. בדרך כלל מדובר ב-genrule, ב-sh_binary, ב-sh_test, אבל ייתכן שיש מאפיינים נוספים (כמו Starlark כללים). בזל מציג הודעת שגיאה אם נדרש ל-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 Studio 2015 (או גרסה חדשה יותר) עם Visual C++ ו-Windows 10 SDK

    • Visual C++ Build Tools 2015 (או גרסה חדשה יותר) ו-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 ואת התלויות שלה, כגון מעטפת MSYS2. פעולה זו לא תתקין את Visual C++.

כדי לקבל מידע נוסף על חבילת השוקולד, ראו מדריך להתקנת שוקולד ותחזוקת החבילות.

באמצעות כפות

  1. מתקינים את מנהל החבילות של Scoop באמצעות פקודת PowerShell הבאה:

    iex (new-object net.webclient).downloadstring('https://get.scoop.sh')
    
  2. מתקינים את החבילה של Bazel:

    scoop install bazel
    

מידע נוסף על חבילת הסקופים זמין במדריך להתקנה ותחזוקה של כפות.

גרסת מקור

כדי להבין איך ליצור Bazel מאפס במקום להתקין, אפשר לקרוא את המאמר הידור מהמקור.