إعداد بيئة التطوير¶
للمساهمة في 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)
تعيين مستودع أعلى¶
بعد استنساخ الفرع الخاص بك، أضف مستودع BeeWare كمرجع بعيد upstream. هذا يمنح
النسخة المستنسخة المحلية مرجعًا إلى المستودع الأصلي، مما يسهل مزامنة التحديثات
بمرور الوقت.
ستحتاج أيضًا إلى علامات من upstream حتى تتمكن أدوات مثل Toga و Briefcase من
تحديد أرقام الإصدارات بدقة:
$ git remote add upstream https://github.com/beeware/beeware.git
$ git fetch --tags upstream
$ git remote add upstream https://github.com/beeware/beeware.git
$ git fetch --tags upstream
C:\...>git remote add upstream https://github.com/beeware/beeware.git
C:\...>git fetch --tags upstream
إذا كنت تريد أن تتضمن شوكتك هذه العلامات أيضًا، يمكنك دفعها:
$ git push --tags
قد يكون هذا مفيدًا إذا قمت بعمل نسخة جديدة لاحقًا وأردت أن تكون العلامات متاحة من شوكتك.
إنشاء بيئة افتراضية¶
لإعداد بيئة افتراضية وترقية 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!