إضافة حزمة Flutter محلية عبر path dependency مع مسار نسبي ورخصة الحزمة وpubspec.lock، دون تعديل كاش pub أو الاعتماد على مسار جهاز واحد.
مسار يملكه المشروع
استخدم نسخة حزمة في مسار واضح داخل المستودع أو مجلد workspace متفق عليه، واجعل path نسبيًا إلى pubspec.yaml. يجب أن يطابق اسم dependency الاسم داخل pubspec الخاص بالحزمة. لا تجعل /Users/اسمك/.pub-cache مسار الفريق؛ الكاش يمكن تنظيفه ولا ينتقل إلى CI.
النسخة المحلية مسؤولية صيانة
احتفظ برخصة الحزمة ونسختها ومصدرها، ووثق التعديلات واختبر الاستيراد والتحليل والبناء. dependency_overrides مناسب لتجربة مقصودة لكنه قد يخفي تعارضًا في الرسم البياني؛ راجعه قبل النشر. تغييرات Dart قد تظهر بالتحديث، أما كود plugin الأصلي فيحتاج إعادة بناء كاملة لتسجيل التغييرات.
تنظيم المسار داخل المستودع
ضع الحزمة المعدلة في مجلد packages أو استخدم workspace منظمًا وفق نسخة Dart المدعومة. يتحدد المسار النسبي من مكان pubspec للتطبيق، وليس من المجلد الذي فتحت فيه Terminal عشوائيًا. حافظ على اسم الحزمة وإصدارها ورخصتها وبنية lib حتى تستمر الاستيرادات التي يستعملها التطبيق. لا تنسخ مجلدًا من الكاش دون أن تعرف commit أو الإصدار الذي أخذته، لأن إصلاحًا صغيرًا قد يختلف عن المصدر الذي ستحدثه لاحقًا.
تجربة التغيير ثم نشره للفريق
نفذ تعديلًا محدودًا داخل النسخة المحلية وشغل اختبارات الحزمة نفسها إن وجدت، ثم شغل اختبارات التطبيق المستهلك. افحص pubspec.lock وdependency graph لتتأكد أن التطبيق أخذ path المقصود لا نسخة hosted أخرى تحمل الاسم ذاته. إذا انتقلت لاحقًا إلى Git فثبّت ref يمكن إعادة إنتاجه، وراجع ما إذا كان المطورون وCI يستطيعون قراءة المصدر. لا تجعل dependency_overrides المحلية غير المراجعة جزءًا مخفيًا من بناء الإصدار، ولا تخلط تغييرات plugin الأصلية مع Dart Hot Reload. الوثيقة التي تسجل سبب fork وطريقة تحديثه تجعل صيانته أيسر من تعديل كاش قد يختفي بعد pub cache repair.
مراجعة أخيرة للتطبيق
اختبر المشروع من نسخة checkout نظيفة في مسار آخر كي تكشف أي اعتماد على مسار شخصي أو ملف غير متعقب. نجاحه في جهاز المؤلف وحده لا يثبت انتقال الحزمة المحلية للفريق. راجع أيضًا الصور وملفات native التي تحتاجها الحزمة ولا تنقل lib وحده إذا كانت إضافتها تعتمد بقية الملفات.
خطوات التطبيق والشرح
كيفية إضافة مكتبات Flutter محليًا على نظامي التشغيل macOS وWindows باستخدام ملفات
عند تطوير تطبيقات Flutter، قد ترغب أحيانًا في استخدام مكتبات محلية مخصصة بدلاً من تنزيلها من الإنترنت، خاصة إذا كنت تستخدم مكتبة تقوم بتطويرها أو تريد تعديلها لتناسب احتياجاتك. سنشرح في هذه المقالة كيفية إعداد مكتبة Flutter محليًا باستخدام ملف .pub-cache على نظامي التشغيل macOS وWindows.
ما هو ملف .pub-cache؟
ملف .pub-cache هو الدليل الذي يتم فيه تخزين كافة المكتبات (الحزم) المثبتة باستخدام pub.dev. عند إضافة مكتبة محلية، يمكنك توجيه Flutter لاستخدام نسخة محلية من المكتبة بدلاً من تنزيلها من الإنترنت.
أضف مكتبات أصلية على نظام التشغيل macOS
في البدايه انتقل الي home وبعدها عن طريق لوحه المفاتيح اظهر الملفات المخفيه عن طريق command + shift + .
سوف تجد ملف باسم .pub-cache قم بفتح الملف ومن ثم hosted وبعدها pub.dev واخيرا ابحث عن المكتبه التي ترغب باستعمالها وقم بنسخها .
الخطوات:
تحديد موقع مكتبة Flutter: قم بتنزيل أو إنشاء مكتبة Flutter المحلية التي تريد إضافتها، وتأكد من حفظها في مسار معين داخل ملفات المشروع الخاص بك عن طريق سحب المكتبه ووضعها داخل ملفات المشروع .
تحديث ملف pubspec.yaml: افتح ملف pubspec.yaml الخاص بمشروعك، وأضف المكتبة مع تحديد مسارها المحلي:
مرجع للتنفيذ
راجع التوثيق الخاص بهذا الموضوع وطابق إعداداته مع إصدار أدوات مشروعك. اختبر السلوك المستهدف وحالة الفشل قبل إدماج المثال في تطبيق منشور.






