إنشاء Barrel Files في Dart باستخدام export وتجميع واجهة الميزة دون استيراد ذاتي أو دورات تبعية، مع توضيح أثرها الحقيقي على الأداء.
export غير import
ملف barrel يعيد تصدير واجهات بواسطة export؛ مجرد استيراد الملفات داخله لا يجعل رموزها متاحة للمستورد. لا تكتب export للملف نفسه داخل barrel.dart. استخدم مسارات نسبية واضحة داخل الميزة أو package paths حسب سياسة المشروع، وحدد show أو hide حين تحتاج تضييق السطح العام.
حدود الميزة قبل جمع كل شيء
لا تصدر ملفات implementation الداخلية كلها من index عام، ولا تستورد barrel من أحد الملفات التي يعيد تصديرها لأن ذلك يسهل دورات الاعتماد. تقليل عدد أسطر imports ليس دليلًا على تقليل حجم binary؛ أدوات التحليل والبناء تحدد التبعيات المستعملة. اختبر استيرادًا صغيرًا من الحزمة وافحص تعارض الأسماء بدل حل التحذير بإعادة تسمية رموز عشوائيًا.
الواجهة العامة للميزة
ابدأ بمجموعة ملفات تنتمي إلى مسؤولية واحدة، مثل نموذج درس وبطاقة عرضه وخدمة يستهلكها جزء آخر من التطبيق. قرر ما يجب أن يعرفه المستهلك ثم صدّر هذه الرموز فقط. الملف الذي يحتوي export لا يستنسخ الكود في كل مستورد؛ هو يحدد الأسماء التي يراها المستورد. لا تجمع كل Material وDart وحزم المشروع في barrel واحد باسم عام يخفي مصدر كل رمز ويجعل أي تغيير داخلي يبدو تغييرًا في الواجهة العامة.
مثال المسارات والملفات
المثال أدناه يفترض وجود lesson.dart وlesson_card.dart بجوار lessons.dart داخل lib/lessons. يظهر show كيف يمكن عرض Lesson وLessonCard دون بقية الأسماء في الملفين. السطر المعلق عند المستهلك يحتاج اسم package الحقيقي من pubspec.yaml، لا اسم مجلد القرص. لا تضع export lessons.dart داخل lessons.dart نفسه. إذا احتاجت البطاقة النموذج فلتستورد lesson.dart مباشرة بدل الرجوع إلى الواجهة العامة التي تعيد تصدير البطاقة أيضًا.
التعارض والدورات
إذا صدّرت حزمة نوعين بالاسم نفسه فقد يحتاج المستهلك prefix أو show/hide أو إعادة تنظيم الواجهة. لا تعالج ذلك بإضافة barrel جديد فوق الدائرة نفسها. راجع اتجاه الاعتمادات: طبقة نموذج البيانات لا ينبغي أن تستورد واجهة Widgets لمجرد أن ملف التجميع يجمع الاثنين. يمكن فصل ملفات عامة لكل طبقة أو ميزة لتبقى الحدود قابلة للفهم. التنظيم الجيد يقلل ما يتغير عند إضافة وظيفة داخلية ويجعل التحليل والاختبار أسهل.
كيف تتحقق من الفائدة؟
استعمل مستهلكًا صغيرًا يستورد الواجهة العامة فقط وشغل dart analyze أو flutter analyze واختبارات الحزمة. جرب تغيير اسم داخلي غير مصدر وتأكد أن المستهلك لا يتأثر، ثم راجع أثر حذف رمز عام قبل نشر نسخة. عدد أسطر import ليس مقياس أداء runtime، وقد لا يتغير حجم التطبيق لمجرد نقل الاستيراد إلى barrel. إذا كان زمن التحليل أو البناء مشكلة فقسه في المشروع نفسه، ولا تعد القارئ بزيادة سرعة التطبيق من تجميع أسماء الملفات وحده.
مثال على سطح واجهة صغير
إذا احتاج المستهلك Lesson فقط فـshow يوضح هذا الاحتياج ولا يفرض تحميل كل Widgets الميزة في أسلوب البرمجة. وعند إضافة خدمة داخلية جديدة لا تُصدّرها تلقائيًا من barrel العام إن لم يكن هناك مستهلك يحتاجها. راجع اتجاه الاستيراد مع شجرة مجلدات بسيطة، واجعل اختبارات الحزمة توضح أي رموز تعد عقدًا عامًا يمكن الاعتماد عليه بين الإصدارات.
مراجعة أخيرة للتطبيق
راجع exports عند كل إضافة عامة حتى لا تتوسع الواجهة دون حاجة فعلية للمستهلك.
مثال الشفرة بعد المراجعة
اقرأ التعليقات ومتطلبات الإعداد قبل النقل إلى مشروعك. أمثلة الواجهات ذات main مستقلة، أما العقود والمقاطع الأصلية وملفات الإعداد فموضح نطاقها داخل المثال.
// lib/lessons/lessons.dart — the public feature barrel:
export 'lesson.dart' show Lesson;
export 'lesson_card.dart' show LessonCard;
// In a consumer (not in this barrel itself):
// import 'package:your_app/lessons/lessons.dart';
// lesson.dart and lesson_card.dart must exist.
// Internal files should import their direct dependencies to avoid cycles.الصور والفيديو التوضيحي
قد تعرض الوسائط إصدارًا أقدم. اعتمد الخطوات النصية المصححة عند اختلاف إعدادات المنصة أو أسماء الواجهات.



مرجع للتنفيذ
راجع التوثيق الخاص بهذا الموضوع وطابق إعداداته مع إصدار أدوات مشروعك. اختبر السلوك المستهدف وحالة الفشل قبل إدماج المثال في تطبيق منشور.






