الاستيرادات والتصديرات والمكتبات

يجلب import ملفاً أو حزمة أخرى إلى شيفرتك حتى تتمكن من استخدام أصنافها ودوالها. ويبدأ كل ملف Dart بهذه التعليمات. 📥

تستخدم المكتبات المضمنة السابقة dart:. فعلى سبيل المثال، يوفر dart:math الدالتين sqrt وRandom من دون تثبيت أي شيء.

لاستخدام اعتماد من pub، استورده باستخدام السابقة package: متبوعة باسم الحزمة ومسار الملف داخلها.

بالنسبة إلى الملفات الموجودة في مشروعك، استخدم مساراً relative بين علامتي اقتباس. ويحافظ ذلك على ارتباط الشيفرة ذات الصلة من دون سابقة حزمة.

إذا تشاركت مكتبتان اسماً، فأضف سابقة باستخدام as. ثم استدعِ الأعضاء عبر تلك السابقة لتجنب أي تعارض.

استخدم show لاستيراد أسماء محددة فقط من مكتبة. ويحافظ ذلك على نظافة مساحة الأسماء ويوضح الغرض من الشيفرة.

عكس show هو hide. فهو يستورد كل شيء باستثناء الأسماء التي تسردها، وهو مفيد جداً لتجنب تعارض واحد.

في Dart، يُعد كل ملف library افتراضياً. وتكون الأعضاء العامة على مستوى الملف مرئية للمستوردين، ولا يلزم إجراء إضافي.

يكون الاسم الذي يبدأ بـ underscore خاصاً بمكتبته. ولا يستطيع المستوردون رؤيته، وهذه هي طريقة إخفاء تفاصيل التنفيذ.

يوجّه التوجيه export الأسماء العامة لمكتبة أخرى عبر ملفك، بحيث يستورد المستخدمون نقطة دخول واحدة بدلاً من عدة نقاط.

ملف barrel ليس سوى مكتبة مليئة بعمليات التصدير. وهو يمنح حزمتك واجهة API عامة واحدة ونظيفة ليستوردها الجميع.

تعلمت استيراد شيفرة SDK والحزم والشيفرة المحلية باستخدام import، وتخصيصها باستخدام show وhide، وعرض API نظيفة باستخدام export. 🎉