تثبيت حزم بايثون

Install dependencies into the Studio Python environment.

تسمح لك نافذة Import Package Window بإضافة تبعيات Python إلى نفس البيئة التي تشغل:

• Designer Window custom blocks (custom_blocks/*.py)

• السكربتات الأخرى التي يتم تنفيذها داخل AugeLab Studio

نظرة أولى

Import Package Window

فتح النافذة

• القائمة: Tools > Import Package Window

مرجع سريع

ما الذي تريد فعله…	استخدم	ملاحظات
نسخ ملف .py مفرد إلى Studio	IMPORT SCRIPT TO STUDIO	مناسب للأدوات الصغيرة المساعدة (مثل utils.py).
نسخ مجلد محلي كامل (package) إلى Studio	IMPORT PACKAGE TO STUDIO	اختر مجلداً يحتوي على وحدات Python.
التثبيت من PyPI	INSTALL PACKAGE FROM PYPI + ADD PACKAGE TO STUDIO	يتطلب اتصال إنترنت. يمكنك إدخال أسماء متعددة مفصولة بفواصل.
التحقق من اسم/إصدار الحزمة	CHECK PACKAGE INFO	يطبع الميتاداتا في لوحة السجل.
فتح دليل المساعدة المدمج	Help (القائمة العلوية في النافذة)	يفتح “Import Python Package Manual”.

تثبيت حزم المجتمع (community packages) قد يقلل من قابلية النقل. إذا كان السيناريو الخاص بك يحتاج لأن يعمل على جهاز آخر، ثبّت نفس الحزم هناك أيضاً (نفس إصدار Python + نفس المنصة).

التثبيت من PyPI

1. افتح Tools > Import Package Window.

2. في حقل INSTALL PACKAGE FROM PYPI، اكتب اسم أو أكثر من أسماء الحزم (مفصولة بفواصل).

3. انقر CHECK PACKAGE INFO للتأكد من وجود الحزمة وللاطلاع على الميتاداتا.

4. انقر ADD PACKAGE TO STUDIO ومتابعة سجل التنفيذ لمشاهدة التقدم/الأخطاء.

تُثبّت الحزم داخل مجلد “pkgs” الخاص بالـ Studio (نفس البيئة المستخدمة من قبل Designer custom blocks).

استيراد سكربت محلي (.py)

1. انقر IMPORT SCRIPT TO STUDIO.

2. اختر ملف .py.

3. أكد رسالة النجاح.

استخدم هذا عندما تريد استيراد وحدة مساعدة ثم القيام بـ import my_helper من داخل custom block الخاص بك.

استيراد package محلي (مجلد)

1. انقر IMPORT PACKAGE TO STUDIO.

2. اختر مجلداً يحتوي على package/وحدات Python الخاصة بك.

3. أكد رسالة النجاح (أو اقرأ مربع الخطأ إن ظهر).

إذا قمت بتحديث الحزمة لاحقاً، قم بإعادة استيرادها (أو احذف النسخة القديمة أولاً ثم استورد النسخة الجديدة).

استكشاف الأخطاء وإصلاحها

المشكلة	ماذا تجرب
“Package not found”	تحقق من اسم الحزمة على pypi.org وأعد المحاولة باستخدام CHECK PACKAGE INFO.
فشل التثبيت في منتصف العملية	تأكد من اتصال الإنترنت واقرأ مخرجات السجل.
تعطل custom block عند الاستيراد	أغلف الاستيرادات الاختيارية بـ try/except ImportError وتحقق من وجود القيمة None في run() وتعامل معها.