راهاندازی محیط توسعه¶
مشارکت در BeeWare مستلزم راهاندازی یک محیط توسعه است.
پیشنیازها¶
شما باید پیشنیازهای زیر را نصب کنید.
BeeWare به پایتون 3.10+ نیاز دارد. همچنین به روشی
برای مدیریت محیطهای مجازی (مانند venv) نیاز خواهید داشت.
میتوانید با اجرای دستور زیر، نسخهٔ پایتونی را که نصب کردهاید بررسی کنید:
$ python3 --version
اگر بیش از یک نسخه از پایتون نصب کرده باشید، ممکن است لازم باشد python3 را با
شماره نسخهٔ مشخصی جایگزین کنید (مثلاً python3.13)
ما توصیه میکنیم از نسخههای تازه منتشرشدهٔ پایتون (یعنی نسخههایی که شمارهٔ نسخهٔ خرد «.0» یا «.1» دارند، مانند 3.14.0) خودداری کنید. دلیل آن این است که ابزارهای لازم برای پشتیبانی از پایتون در macOS اغلب با تأخیر عرضه میشوند و معمولاً برای نسخههای پایدار تازهمنتشرشدهٔ پایتون در دسترس نیستند.
BeeWare به پایتون 3.10+ نیاز دارد. همچنین به روشی
برای مدیریت محیطهای مجازی (مانند venv) نیاز خواهید داشت.
میتوانید با اجرای دستور زیر، نسخهٔ پایتونی را که نصب کردهاید بررسی کنید:
$ python3 --version
اگر بیش از یک نسخه از پایتون نصب کرده باشید، ممکن است لازم باشد python3 را با
شماره نسخهٔ مشخصی جایگزین کنید (مثلاً python3.13)
ما توصیه میکنیم از نسخههای تازه منتشرشدهٔ پایتون (یعنی نسخههایی که شمارهٔ نسخهٔ خرد «.0» یا «.1» دارند، مانند 3.14.0) خودداری کنید. دلیل آن این است که ابزارهای لازم برای پشتیبانی از پایتون روی لینوکس اغلب با تأخیر عرضه میشوند و معمولاً برای نسخههای پایدار تازهمنتشرشدهٔ پایتون در دسترس نیستند.
BeeWare به پایتون 3.10+ نیاز دارد. همچنین به روشی
برای مدیریت محیطهای مجازی (مانند venv) نیاز خواهید داشت.
میتوانید با اجرای دستور زیر، نسخهٔ پایتونی را که نصب کردهاید بررسی کنید:
C:\...>py -3 --version
اگر بیش از یک نسخه از پایتون نصب کرده باشید، ممکن است لازم باشد -3 را با شماره
نسخهٔ مشخصی جایگزین کنید (مثلاً -python3.13)
ما توصیه میکنیم از نسخههای تازه منتشرشدهٔ پایتون (یعنی نسخههایی که شمارهٔ نسخهٔ خرد «.0» یا «.1» دارند، مانند 3.14.0) خودداری کنید. دلیل آن این است که ابزارهای لازم برای پشتیبانی از پایتون روی ویندوز اغلب با تأخیر عرضه میشوند و معمولاً برای نسخههای پایدار تازهمنتشرشدهٔ پایتون در دسترس نیستند.
محیط توسعه خود را راهاندازی کنید¶
روش پیشنهادی برای راهاندازی محیط توسعهٔ شما برای BeeWare استفاده از یک محیط مجازی است و سپس نصب نسخهٔ توسعهٔ BeeWare و وابستگیهای آن.
مخزن BeeWare را کلون کنید¶
سپس به صفحه BeeWare در گیتهاب، بروید و اگر قبلاً این کار را نکردهاید، مخزن را فورک کنید به حساب کاربری خود. سپس، روی دکمه «<> Code» در فورک خود کلیک کنید. اگر برنامه دسکتاپ گیتهاب را روی رایانه خود نصب دارید، میتوانید «Open with GitHub Desktop» را انتخاب کنید؛ در غیر این صورت، URL HTTPS ارائهشده را کپی کرده و از آن برای کلون کردن مخزن روی رایانه خود با استفاده از خط فرمان استفاده کنید:
مخزن BeeWare را فورک کنید، و سپس:
$ git clone https://github.com/<your username>/beeware.git
(نام کاربری گیتهاب خود را جایگزین کنید)
مخزن BeeWare را فورک کنید، و سپس:
$ git clone https://github.com/<your username>/beeware.git
(نام کاربری گیتهاب خود را جایگزین کنید)
مخزن BeeWare را فورک کنید، و سپس:
C:\...>git clone https://github.com/<your username>/beeware.git
(نام کاربری گیتهاب خود را جایگزین کنید)
یک محیط مجازی ایجاد کنید¶
برای راهاندازی یک محیط مجازی و ارتقا pip، اجرا کنید:
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
C:\...>cd beeware
C:\...>py -3 -m venv .venv
C:\...>.venv\Scripts\activate
(.venv) $ python -m pip install -U pip
دستور شما اکنون باید یک پیشوند (.venv) در جلوی آن داشته باشد.
نصب کنید¶
حالا که کد منبع را در اختیار دارید، میتوانید یک نصب قابل ویرایش از (https://setuptools.pypa.io/en/latest/userguide/development_mode.html) را در محیط توسعه خود انجام دهید. دستور زیر را اجرا کنید:
(.venv) $ python -m pip install -U -e . --group dev
(.venv) $ python -m pip install -U -e . --group dev
(.venv) C:\...>python -m pip install -U -e . --group dev
پیشتأیید را فعال کنید¶
BeeWare از ابزاری به نام pre-commit برای شناسایی مشکلات ساده و استانداردسازی قالببندی کد استفاده میکند. این کار با نصب یک گیت هوک انجام میشود که پیش از نهاییسازی هر commit گیت، بهطور خودکار مجموعهای از لینترهای کد را اجرا میکند. برای فعالسازی pre-commit، دستور زیر را اجرا کنید:
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) C:\...>pre-commit install
pre-commit installed at .git/hooks/pre-commit
اکنون شما آمادهاید تا روی BeeWare هک کردن را شروع کنید!