> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/almyzat-alreysyh/instal-custom-packages-with-package-window.md).

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

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

* Designer Window custom blocks (`custom_blocks/*.py`)
* السكربتات الأخرى التي يتم تنفيذها داخل AugeLab Studio

## نظرة أولى

<figure><img src="/files/trRlgG6CRZc5fVxZr1x2" alt="Import Package Window"><figcaption><p>Import Package Window</p></figcaption></figure>

## فتح النافذة

* القائمة: `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”.                        |

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

<details>

<summary>التثبيت من PyPI</summary>

1. افتح `Tools > Import Package Window`.
2. في حقل **INSTALL PACKAGE FROM PYPI**، اكتب اسم أو أكثر من أسماء الحزم (مفصولة بفواصل).
3. انقر **CHECK PACKAGE INFO** للتأكد من وجود الحزمة وللاطلاع على الميتاداتا.
4. انقر **ADD PACKAGE TO STUDIO** ومتابعة سجل التنفيذ لمشاهدة التقدم/الأخطاء.

{% hint style="info" %}
تُثبّت الحزم داخل مجلد “pkgs” الخاص بالـ Studio (نفس البيئة المستخدمة من قبل Designer custom blocks).
{% endhint %}

</details>

<details>

<summary>استيراد سكربت محلي (.py)</summary>

1. انقر **IMPORT SCRIPT TO STUDIO**.
2. اختر ملف `.py`.
3. أكد رسالة النجاح.

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

</details>

<details>

<summary>استيراد package محلي (مجلد)</summary>

1. انقر **IMPORT PACKAGE TO STUDIO**.
2. اختر مجلداً يحتوي على package/وحدات Python الخاصة بك.
3. أكد رسالة النجاح (أو اقرأ مربع الخطأ إن ظهر).

{% hint style="info" %}
إذا قمت بتحديث الحزمة لاحقاً، قم بإعادة استيرادها (أو احذف النسخة القديمة أولاً ثم استورد النسخة الجديدة).
{% endhint %}

</details>

<details>

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

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

</details>