התקנת Bazel ב-macOS

הדף הזה מתאר איך להתקין את Bazel ב-macOS ולהגדיר את הסביבה שלך.

ניתן להתקין את Bazel ב-macOS באמצעות אחת מהשיטות הבאות:

• מומלץ: שימוש ב-Bazelisk
• שימוש במתקין הבינארי
• שימוש ב-Homebrew
• קומפיל בזל ממקור

Bazel מגיעה עם שני סקריפטים של השלמה. לאחר התקנת Bazel, ניתן:

• גישה לסקריפט השלמת ה-Bash
• התקן את סקריפט הסיום של zsh

התקנה באמצעות המתקין הבינארי

המתקינים הבינאריים נמצאים בדף הגרסאות של GitHub של Bazel.

המתקין מכיל את הקובץ הבינארי של Bazel. יש להתקין גם כמה ספריות נוספות כדי ש-Bazel תפעל.

שלב 1: התקנת כלי שורת הפקודה של Xcode

אם לא בכוונתך להשתמש בכללי ios_*, מספיק להתקין את חבילת הכלים של פקודת Xcode באמצעות xcode-select:

xcode-select --install

אחרת, אם יש לך תמיכה ב-ios_*, עליך להשתמש ב-Xcode 6.1 ואילך עם iOS SDK 8.1.

מורידים את ה-Xcode מ- App Store או מהאתר למפתחים של Apple.

לאחר התקנת Xcode, אשר את הסכם הרישיון עבור כל המשתמשים עם הפקודה הבאה:

sudo xcodebuild -license accept

שלב 2: הורדת מתקין Bazel

לאחר מכן, יש להוריד את המתקין הבינארי של Bazel שנקרא bazel-<version>-installer-darwin-x86_64.sh מדף הגרסאות של Bazel ב-GitHub.

ב-macOS Catalina או בגרסה חדשה יותר (macOS >= 11), בגלל הדרישות החדשות של Apple לחתימת אפליקציות, צריך להוריד את מנהל ההתקנה מהמסוף באמצעות curl משתנה גירסה עם גרסת Bazel שברצונך להוריד:

export BAZEL_VERSION=5.2.0
curl -fLO "https://github.com/bazelbuild/bazel/releases/download/$BAZEL_VERSION/bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"

זהו מעקף זמני עד שתהליך ההפצה של macOS תומך בחתימה (#9304).

שלב 3: הפעלת מנהל ההתקנה

הפעל את המתקין של Bazel באופן הבא:

chmod +x "bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh"
./bazel-$BAZEL_VERSION-installer-darwin-x86_64.sh --user

הסימון --user מתקין את Bazel לספריית $HOME/bin במערכת שלך ומגדיר את הנתיב .bazelrc ל-$HOME/.bazelrc. יש להשתמש בפקודה --help כדי לראות אפשרויות התקנה נוספות.

אם אתהב-macOS Catalina ואילך (macOS >= 11) ולקבל שגיאה על כךאי אפשר לפתוח את "ריאל-בלאז" כי לא ניתן לאמת את המפתח , צריך להוריד מחדש את מנהל ההתקנה מהמסוף באמצעותcurl כפתרון, ראו את שלב 2 למעלה.

שלב 4: מגדירים את הסביבה

אם הפעלת את מתקין Bazel עם הסימון --user כמו למעלה, Bazel ניתן להפעלה מותקן בספרייה שלך HOME/bin. מומלץ להוסיף ספרייה זו לנתיבי ברירת המחדל שלך, באופן הבא:

export PATH="PATH:HOME/bin"

אפשר גם להוסיף את הפקודה הזו לקובץ ~/.bashrc, ~/.zshrc או ~/.profile.

הכול מוכן! ניתן לוודא שההתקנה של Bazel הצליחה על ידי הפעלת הפקודה הבאה:

bazel --version

כדי לעדכן לגרסה חדשה יותר של Bazel, יש להוריד ולהתקין את הגרסה הרצויה.

התקנה באמצעות Homebrew

שלב 1: מתקינים את Homebrew ב-macOS

התקנת Homebrew (שלב חד-פעמי):

/bin/bash -c "$(curl -fsSL \
https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

שלב 2: התקנת Bazel דרך Homebrew

התקן את חבילת Bazel דרך Homebrew באופן הבא:

brew install bazel

הכול מוכן! ניתן לוודא שההתקנה של Bazel הצליחה על ידי הפעלת הפקודה הבאה:

bazel --version

לאחר ההתקנה, תוכל לשדרג לגרסה חדשה יותר של Bazel באמצעות הפקודה הבאה:

brew upgrade bazel