نصب Bazel بر روی ویندوز

در این صفحه شرایط و مراحل نصب Bazel در ویندوز توضیح داده شده است. همچنین شامل عیب یابی و سایر روش های نصب Bazel، مانند استفاده از Chocolatey یا Scoop می باشد.

نصب بازل

این بخش پیش نیازها، تنظیمات محیط و مراحل دقیق نصب در ویندوز را پوشش می دهد.

سیستم خود را بررسی کنید

توصیه می شود: ویندوز 10 64 بیتی، نسخه 1703 (به روز رسانی سازندگان) یا جدیدتر

برای بررسی نسخه ویندوز خود:

• روی دکمه Start کلیک کنید.
• winver را در کادر جستجو تایپ کنید و Enter را فشار دهید.
• باید کادر About Windows را با اطلاعات نسخه ویندوز خود مشاهده کنید.

همچنین پشتیبانی می شود:

• 64 بیت ویندوز 7 یا جدیدتر

• 64 بیت ویندوز سرور 2008 R2 یا جدیدتر

پیش نیازها را نصب کنید

• Visual C++ قابل توزیع مجدد برای Visual Studio 2015

دانلود بازی Bazel

توصیه می شود: از Bazelisk استفاده کنید

به طور متناوب می توانید:

• باینری Bazel ( bazel- version -windows-x86_64.exe ) را از GitHub دانلود کنید.
• Bazel را از Chocolatey نصب کنید
• Bazel را از Scoop نصب کنید
• ساخت Bazel از منبع

محیط خود را تنظیم کنید

برای اینکه Bazel به راحتی از طریق command prompt یا PowerShell به طور پیش فرض قابل دسترسی باشد، می توانید نام باینری Bazel را به bazel.exe تغییر دهید و آن را به مسیرهای پیش فرض خود اضافه کنید.

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

همچنین می توانید متغیر محیطی PATH سیستم خود را تغییر دهید تا آن را دائمی کنید. نحوه تنظیم متغیرهای محیط را بررسی کنید.

انجام شده

"موفقیت: شما بازل را نصب کردید."

برای بررسی صحیح نصب، سعی کنید اجرا کنید:

bazel version

در مرحله بعد، می توانید نکات و راهنمایی های بیشتری را در اینجا بررسی کنید:

• نصب کامپایلر و زمان اجرا زبان
• عیب یابی
• بهترین روش ها در ویندوز
• آموزش ها

نصب کامپایلر و زمان اجرا زبان

بسته به اینکه کدام زبان را می خواهید بسازید، به موارد زیر نیاز دارید:

• MSYS2 x86_64

  MSYS2 یک پلتفرم توزیع و ساخت نرم افزار برای ویندوز است. این شامل Bash و ابزارهای رایج یونیکس (مانند grep ، tar ، git ) است.

  برای ساخت، آزمایش یا اجرای اهداف وابسته به Bash به MSYS2 نیاز دارید. معمولاً اینها genrule ، sh_binary ، sh_test ، اما ممکن است موارد بیشتری نیز وجود داشته باشد (مانند قوانین Starlark). اگر هدف ساختنی به Bash نیاز داشته باشد، Bazel خطایی نشان می‌دهد اما 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 خود اضافه کنید.

• ابزارهای ساخت ویژوال استودیو 2019

  برای ساخت کد ++C در ویندوز به این نیاز خواهید داشت.

  همچنین پشتیبانی می شود:

  • Visual Studio 2015 (یا جدیدتر) با Visual C++ و Windows 10 SDK

  • Visual C++ Build Tools 2015 (یا جدیدتر) و Windows 10 SDK

• کیت توسعه Java SE 11 (JDK) برای ویندوز x64

  برای ساخت کد جاوا در ویندوز به این نیاز خواهید داشت.

  همچنین پشتیبانی می شود: جاوا 8، 9، و 10

• پایتون 3.6 برای ویندوز x86-64

  برای ساخت کد پایتون در ویندوز به این نیاز خواهید داشت.

  همچنین پشتیبانی می شود: Python 2.7 یا جدیدتر برای Windows x86-64

عیب یابی

Bazel Bash یا bash.exe را پیدا نمی کند

دلایل احتمالی :

• شما MSYS2 را در مسیر نصب پیش فرض نصب نکرده اید

• شما MSYS2 i686 را به جای MSYS2 x86_64 نصب کردید

• شما MSYS را به جای MSYS2 نصب کردید

راه حل :

مطمئن شوید که MSYS2 x86_64 را نصب کرده اید.

اگر کمکی نکرد:

1. به منوی شروع > تنظیمات بروید.

2. تنظیم "ویرایش متغیرهای محیطی برای حساب شما" را پیدا کنید

3. به لیست بالا نگاه کنید ("متغیرهای کاربر برای <username>")، و روی دکمه "جدید..." در زیر آن کلیک کنید.

4. برای "نام متغیر"، BAZEL_SH را وارد کنید

5. روی "مرور فایل..." کلیک کنید

6. به دایرکتوری MSYS2 و سپس به usr\bin زیر آن بروید.

   برای مثال، این ممکن است C:\msys64\usr\bin در سیستم شما باشد.

7. فایل bash.exe یا bash را انتخاب کرده و OK کنید

8. فیلد "مقدار متغیر" اکنون مسیر bash.exe را دارد. روی OK کلیک کنید تا پنجره بسته شود.

9. انجام شده.

   اگر یک ترمینال cmd.exe یا PowerShell جدید باز کنید و Bazel را هم اکنون اجرا کنید، Bash را پیدا می کند.

Bazel Visual Studio یا Visual C++ را پیدا نمی کند

دلایل احتمالی :

• شما چندین نسخه از ویژوال استودیو را نصب کرده اید

• شما نسخه های مختلف ویژوال استودیو را نصب و حذف کردید

• شما نسخه های مختلفی از Windows SDK را نصب کرده اید

• ویژوال استودیو را در مسیر نصب پیش فرض نصب نکرده اید

راه حل :

1. به منوی شروع > تنظیمات بروید.

2. تنظیم "ویرایش متغیرهای محیطی برای حساب شما" را پیدا کنید

3. به لیست بالا نگاه کنید ("متغیرهای کاربر برای <username>")، و روی دکمه "جدید..." در زیر آن کلیک کنید.

4. برای "نام متغیر"، BAZEL_VC را وارد کنید

5. روی "مرور دایرکتوری..." کلیک کنید

6. به دایرکتوری VC Visual Studio بروید.

   برای مثال، این ممکن است C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC در سیستم شما باشد.

7. پوشه VC را انتخاب کرده و روی OK کلیک کنید

8. فیلد "Variable value" اکنون مسیر VC را دارد. روی OK کلیک کنید تا پنجره بسته شود.

9. انجام شده.

   اگر یک ترمینال جدید cmd.exe یا PowerShell را باز کنید و اکنون Bazel را اجرا کنید، Visual C++ را پیدا خواهد کرد.

راه های دیگر نصب Bazel

استفاده از شکلات

1. برنامه Chocolatey package manager را نصب کنید

2. بسته Bazel را نصب کنید:

   choco install bazel
   

   این دستور آخرین نسخه موجود Bazel و وابستگی های آن مانند پوسته MSYS2 را نصب می کند. با این حال، ویژوال سی پلاس پلاس را نصب نمی‌کند.

راهنمای نصب و نگهداری بسته شکلاتی را برای اطلاعات بیشتر در مورد بسته شکلاتی مشاهده کنید.

با استفاده از Scoop

1. با استفاده از دستور PowerShell زیر، مدیریت بسته Scoop را نصب کنید:

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

2. بسته Bazel را نصب کنید:

   scoop install bazel
   

برای اطلاعات بیشتر در مورد پکیج اسکوپ به راهنمای نصب و نگهداری بسته اسکوپ مراجعه کنید.

ساخت از منبع

برای ساخت Bazel از ابتدا به جای نصب، به کامپایل از منبع مراجعه کنید.