مقدمة
يحدث خطأ تبعية وحدة أودو عندما لا يمكن لأودو تثبيت أو ترقية وحدة بسبب عدم وجود وحدة أو أكثر مطلوبة، أو عدم تثبيتها، أو إعلانها بشكل غير صحيح.
عادة ما يظهر هذا النوع من الأخطاء خلال:
- تثبيت الوحدة
- ترقية الوحدة
- ترحيل قاعدة البيانات
- نشر الوحدة المخصصة
عندما لا يتم تكوين التبعيات بشكل صحيح، يقوم أودو بحظر العملية لمنع سلوك النظام غير المتسق.
تشرح هذه الدليل لماذا تحدث أخطاء تبعية الوحدة وكيفية إصلاحها بشكل صحيح.
ما هي تبعية الوحدة في أودو؟
تحتوي كل وحدة أودو على ملف __manifest__.py مع قسم التبعيات:
{
'name': 'وحدتي المخصصة',
'depends': ['base', 'sale'],
}
هذا يعني:
- تتطلب الوحدة تثبيت قاعدة وبيع
- سيقوم أودو بتثبيتهما تلقائيًا إذا لزم الأمر
- تعتمد الوحدة على نماذجها وميزاتها
إذا كانت إحدى هذه التبعيات مفقودة أو معلن عنها بشكل غير صحيح، يرفع أودو خطأ في التبعية.
الأسباب الشائعة لأخطاء تبعية وحدات أودو
1. الوحدة المطلوبة مفقودة
إذا كانت وحدتك تعتمد على وحدة أخرى غير مثبتة، لا يمكن لأودو المتابعة.
مثال:
'depends': ['stock']
إذا لم يتم تثبيت المخزون → فشل التثبيت.
2. اسم الوحدة غير صحيح في البيان
إذا كان اسم الاعتماد خاطئًا:
'depends': ['sales']
بدلاً من:
'depends': ['sale']
لن يجد أودو الوحدة ويرفع خطأ.
3. الاعتمادات الدائرية
إذا:
- الوحدة A تعتمد على الوحدة B
- الوحدة B تعتمد على الوحدة A
Odoo لا يمكنه حل ترتيب التثبيت.
تسبب الاعتماديات الدائرية فشل التثبيت.
4. وحدة مخصصة غير موجودة في مسار الإضافات
إذا كانت الاعتمادية وحدة مخصصة ولكنها ليست موجودة في مسار الإضافات المكون، لا يمكن لـ Odoo اكتشافها.
5. الوحدة مثبتة ولكن لم يتم تحميلها بشكل صحيح
إذا كانت الوحدة الاعتمادية قد تم تثبيتها جزئيًا أو فشلت أثناء التثبيت السابق، قد يعتبر النظام أنها غير متاحة.
6. عدم تطابق النسخة بين الوحدات
إذا كانت الوحدة المخصصة قد تم بناؤها لنسخة Odoo مختلفة، قد تحدث تعارضات في الاعتماديات أثناء التثبيت أو الترقية.
كيفية إصلاح خطأ تبعية وحدة أودو
الخطوة 1 – تحقق من رسالة الخطأ
عادةً ما تحدد رسالة الخطأ أي اعتماد مفقود.
مثال:
ModuleNotFoundError: لا يوجد وحدة باسم 'stock'
أو:
الاعتماديات غير الملباة: sale_management
الخطوة 2 – تحقق من ملف البيان
افتح __manifest__.py وتحقق من:
- أسماء الوحدات الصحيحة
- التهجئة الصحيحة
- لا توجد فاصلات زائدة أو أخطاء في الصياغة
قارن الأسماء مع الأسماء التقنية الرسمية للوحدات في Odoo.
الخطوة 3 – تثبيت الاعتماديات المفقودة
اذهب إلى:
التطبيقات → ابحث عن الوحدة المفقودة → تثبيت
إذا كانت وحدة مخصصة، تأكد من أنها:
- موجود في مجلد الإضافات
- مدرج في addons_path
- مرئي في قائمة التطبيقات
الخطوة 4 - إعادة تشغيل خادم Odoo
بعد تصحيح مشكلات الاعتماد:
- أعد تشغيل الخادم
- قم بتحديث قائمة التطبيقات
- حاول التثبيت مرة أخرى
الخطوة 5 - تجنب الاعتماد الدائري
إذا كان هناك اعتماد دائري:
- إعادة هيكلة المنطق المشترك إلى وحدة ثالثة
- إزالة الاعتمادات المتقاطعة غير الضرورية
يجب أن تحتوي الوحدات على علاقات هرمية واضحة.
الخطوة 6 - تحقق من تكوين مسار الإضافات
تحقق من ملف تكوين Odoo الخاص بك:
addons_path = /path/to/odoo/addons,/path/to/custom/addons
تأكد من أن جميع الوحدات المطلوبة موجودة في هذه الدلائل.
كيفية منع أخطاء تبعية الوحدات
- قم دائمًا بإعلان الاعتمادات بشكل صريح
- احتفظ بهيكل الوحدة نظيفًا ومرنًا
- تجنب الاعتمادات الدائرية
- استخدم أسماء الوحدات الفنية الصحيحة
- اختبر التثبيت في بيئة الاختبار
- وثق علاقات الوحدة المخصصة
تمنع بنية الوحدة المنظمة بشكل جيد معظم حالات فشل التثبيت المتعلقة بالاعتمادات.
كيف تنظم داسولو تبعيات الوحدات النظيفة
تشير أخطاء اعتماد الوحدة عادةً إلى هيرارشيّات وحدات غير واضحة أو اعتماديات متقاطعة مخفية بين المكونات المخصصة. مع نمو بيئات أودو، يمكن أن تؤدي الاعتماديات غير المُدارة بسرعة إلى فشل في التثبيت أو الترقية.
في داسولو، نحن نمنع تعارضات الاعتماد من خلال التركيز على:
- إعلانات الاعتماد الصريحة
- حدود وحدات واضحة
- ترابط منخفض بين الوحدات
- تجنب المراجع الدائرية
- توثيق منظم للمكونات المخصصة
تضمن بنية اعتماد نظيفة تثبيتات متوقعة وصيانة طويلة الأمد عبر مشاريع أودو.
خاتمة
يحدث "خطأ اعتماد الوحدة" في أودو عندما تكون الوحدات المطلوبة مفقودة أو مُعلنة بشكل خاطئ أو متعارضة أثناء التثبيت أو الترقية. بينما يُبلغ النظام بوضوح عن الاعتماديات غير المُلباة، غالبًا ما تكمن المشكلة الأعمق في هيكلة الوحدات الضعيفة.
من خلال مراجعة ملفات البيان بعناية، والحفاظ على هيرارشيّات وحدات نظيفة، والتحقق من الاعتماديات قبل النشر، يمكن للمطورين منع تعارضات التثبيت المتكررة. تعتبر بنية الوحدة المنضبطة ضرورية لبيئات أودو المستقرة والقابلة للتوسع.