إعداد بيئة التطوير¶
للمساهمة في BeeWare، يتعين عليك إعداد بيئة تطوير.
المتطلبات الأساسية¶
ستحتاج إلى تثبيت المتطلبات الأساسية التالية.
BeeWare يتطلب Python 3.10+. ستحتاج أيضًا إلى طريقة
لإدارة البيئات الافتراضية (مثل venv).
يمكنك التحقق من إصدار Python الذي قمت بتثبيته عن طريق تشغيل:
$ python3 --version
إذا كان لديك أكثر من إصدار واحد من Python مثبتًا، فقد تحتاج إلى استبدال
python3 برقم إصدار محدد (على سبيل المثال، python3.13)
نوصي بتجنب الإصدارات الحديثة من Python (أي الإصدارات التي تحتوي على رقم إصدار فرعي ".0" أو ".1"، مثل 3.14.0). وذلك لأن الأدوات اللازمة لدعم Python على macOS غالبًا ما تكون متأخرة ولا تتوفر للإصدارات المستقرة الحديثة من Python.
BeeWare يتطلب Python 3.10+. ستحتاج أيضًا إلى طريقة
لإدارة البيئات الافتراضية (مثل venv).
يمكنك التحقق من إصدار Python الذي قمت بتثبيته عن طريق تشغيل:
$ python3 --version
إذا كان لديك أكثر من إصدار واحد من Python مثبتًا، فقد تحتاج إلى استبدال
python3 برقم إصدار محدد (على سبيل المثال، python3.13)
نوصي بتجنب الإصدارات الحديثة من Python (أي الإصدارات التي تحتوي على رقم إصدار فرعي ".0" أو ".1"، مثل 3.14.0). وذلك لأن الأدوات اللازمة لدعم Python على Linux غالبًا ما تكون متأخرة ولا تتوفر للإصدارات المستقرة الحديثة من Python.
BeeWare يتطلب Python 3.10+. ستحتاج أيضًا إلى طريقة
لإدارة البيئات الافتراضية (مثل venv).
يمكنك التحقق من إصدار Python الذي قمت بتثبيته عن طريق تشغيل:
C:\...>py -3 --version
إذا كان لديك أكثر من إصدار واحد من Python مثبتًا، فقد تحتاج إلى استبدال -3
برقم إصدار محدد (على سبيل المثال، -python3.13)
نوصي بتجنب الإصدارات الحديثة من Python (أي الإصدارات التي تحتوي على رقم إصدار فرعي ".0" أو ".1"، مثل 3.14.0). وذلك لأن الأدوات اللازمة لدعم Python على Windows غالبًا ما تكون متأخرة ولا تتوفر للإصدارات المستقرة الحديثة من Python.
قم بإعداد بيئة التطوير الخاصة بك¶
الطريقة الموصى بها لإعداد بيئة التطوير لـ BeeWare هي استخدام بيئة افتراضية, ثم تثبيت إصدار التطوير لـ BeeWare وتبعياته.
نسخ مستودع BeeWare¶
بعد ذلك، انتقل إلى صفحة BeeWare على GitHub، وإذا لم تكن قد قمت بذلك بالفعل، فقم بفصل المستودع إلى حسابك الخاص. بعد ذلك، انقر على زر "<> Code" في النسخة المنقسمة. إذا كان تطبيق GitHub desktop مثبتًا على جهاز الكمبيوتر الخاص بك، فيمكنك تحديد "Open with GitHub Desktop"؛ وإلا، فانسخ عنوان URL HTTPS المقدم، واستخدمه لنسخ المستودع إلى جهاز الكمبيوتر الخاص بك باستخدام سطر الأوامر:
قم بتقسيم مستودع BeeWare، ثم:
$ git clone https://github.com/<your username>/beeware.git
(استبدل اسم المستخدم الخاص بك على GitHub)
قم بتقسيم مستودع BeeWare، ثم:
$ git clone https://github.com/<your username>/beeware.git
(استبدل اسم المستخدم الخاص بك على GitHub)
قم بتقسيم مستودع BeeWare، ثم:
C:\...>git clone https://github.com/<your username>/beeware.git
(استبدل اسم المستخدم الخاص بك على GitHub)
إنشاء بيئة افتراضية¶
لإعداد بيئة افتراضية وترقية 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).
تثبيت BeeWare¶
الآن بعد أن أصبح لديك شفرة المصدر، يمكنك إجراء تثبيت قابل للتحرير لـ BeeWare في بيئة التطوير الخاصة بك. قم بتشغيل الأمر التالي:
(.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 لتحديد المشكلات البسيطة وتوحيد تنسيق الكود. ويقوم بذلك عن طريق تثبيت git hook الذي يقوم تلقائيًا بتشغيل سلسلة من أدوات فحص الكود قبل إنهاء أي git 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!