إعداد مساحة عمل افتراضية لـ Python

لإنشاء بيئة افتراضية لـ Python باستخدام venv، تأكد من تثبيت Python على نظامك. يمكنك تنزيل برنامج التثبيت من python.org. تتطلب واجهة برمجة تطبيقات AIM WebSocket الإصدار 3.8 من Python أو أحدث.

• في نظام ويندوز، تأكد من تحديد خيار إضافة بايثون 3.x إلى متغير PATH أثناء التثبيت. قد يتطلب ذلك صلاحيات المسؤول.

• في نظام macOS ومعظم توزيعات Linux، يتم تثبيت Python 3 مسبقًا عادةً، ولكن لا يزال من المستحسن التحقق من الإصدار.

1. Create the Virtual Environment

من داخل الدليل الرئيسي لمستودع الاستنساخ، قم بتشغيل ما يلي:

python -m venv venv

2. Activate the Virtual Environment

من داخل الدليل الرئيسي لمستودع النسخ، قم بتشغيل الأمر المناسب لنظام التشغيل الخاص بك:

ويندوز

باور شيل أو موجه الأوامر:

venv\Scripts\activate

جيت باش (MINGW64) - غير مُوصى به:

source venv/Scripts/activate

macOS و Linux و WSL

source venv/bin/activate

ملاحظة: لضمان تفعيل بيئتك الافتراضية تلقائيًا، يمكنك إضافة أمر التفعيل إلى ملف بدء تشغيل shell الخاص بك (على سبيل المثال، .bashrc، .zshrc).

تحقق من بيئة Shell

للتأكد من أن بيئة shell الخاصة بك تستخدم البيئة الافتراضية الصحيحة، ابدأ جلسة Python عن طريق إدخال REPL:

python

ثم قم بتشغيل الأوامر التالية:

import sys
print(sys.prefix)

يجب أن تتطابق المخرجات مع مسار دليل بيئتك الافتراضية.

3. Install the Required Packages

من داخل الدليل الرئيسي لمستودع النسخ، قم بتشغيل ما يلي:

pip install -r requirements.txt

في نظام macOS، إذا واجهت خطأً أثناء تثبيت pyaudio، فقم أولاً بتثبيت مكتبة portaudio باستخدام Homebrew، ثم حاول مرة أخرى:

brew install portaudio
pip install -r requirements.txt

على نظامي Debian/Ubuntu: قم بتثبيت portaudio19-dev باستخدام apt، ثم أعد تشغيل الأمر pip install -r requirements.txt

sudo apt install portaudio19-dev
pip install -r requirements.txt

يمكنك الآن تشغيل برامج بايثون على الروبوت المتصل.