شارك المقالة
تنظيف نواتج بناء مشاريع Flutter على macOS وLinux

تنظيف نواتج بناء مشاريع Flutter على macOS وLinux

تنظيف نواتج بناء مشاريع Flutter على macOS وLinux بعد عرض المشاريع المستهدفة، والفرق بين flutter clean وحذف حزم pub-cache.

تنظيف نواتج بناء مشاريع Flutter على macOS وLinux بعد عرض المشاريع المستهدفة، والفرق بين flutter clean وحذف حزم pub-cache.

ما الذي ينظفه الأمر؟

flutter clean يزيل نواتج بناء وملفات مولدة للمشروع، ولا يحذف الحزم غير المستخدمة من pub-cache المشترك. ستدفع كلفة إعادة توليدها في البناء التالي، لذلك قس الحجم أولًا ولا تنظف مشروعًا يبني حاليًا. تعديل مجلد مشاريع لا يبرر المرور على كل مجلد في Home أو تنفيذ حذف يدوي عام.

ابدأ بمعاينة دون تعديل

اعرض المجلدات التي تحتوي pubspec.yaml في المستوى المقصود، ثم شغل flutter clean لكل مشروع تختاره. ضع المسار بين اقتباسين وتحقق من نجاح الدخول للمجلد قبل الأمر. لا تستخدم سكربتًا يفترض أن كل مجلد تطبيق Flutter؛ الحزمة قد تكون Dart فقط. احتفظ بملفات توقيع ورموز الإصدار وشفرة المصدر خارج أي مجلد build مؤقت.

ثلاث مساحات مختلفة

مجلد build في كل مشروع يضم مخرجات قابلة لإعادة الإنشاء، ومجلد .dart_tool يضم بيانات أدوات محلية، بينما pub-cache يخزن نسخ حزم تشترك بها مشاريع عديدة. تنظيف الأولين لا يكتشف حزمة غير مستعملة على جهازك كله. قبل أي عملية اعرض الأحجام وحدد أي مساحة تريد تحريرها، ثم اختر أداة المشروع أو pub المناسبة. إزالة كاش التنزيل قد تجعل أول pub get التالي أبطأ أو متعذرًا بلا شبكة، فلا تعتبرها توفيرًا مجانيًا دائمًا.

المعاينة أولًا على مجلد محدود

اجعل الجذر مجلدًا معروفًا لمشاريعك، ثم اعرض أبناءه الذين لديهم pubspec.yaml. المعاينة المكتوبة أدناه لا تغير شيئًا وتسمح باكتشاف مسارات خاطئة أو مسافات أو مجلدات ليست Flutter. بعد المراجعة ادخل مشروعًا واحدًا واختبر flutter clean فيه واقرأ النتيجة قبل تكرار العملية. لا تفترض أن نجاح اسم مجلد في القائمة يثبت أنه لا يبني في نافذة أخرى؛ أوقف مهام البناء والأرشفة أولًا.

التكرار مع معالجة الفشل

إذا حولت المعاينة لاحقًا إلى سكربت تنفيذ فاجعل لكل مشروع سجل نجاح أو فشل واضحًا، واستعمل subshell أو حفظًا للموقع يمنع فشل cd من تنظيف المجلد السابق. لا تتجاوز وجود pubspec ولا توسع البحث إلى كل القرص دون حاجة. روابط المجلدات والمستودعات التي تضم حزمًا داخلية تحتاج سياسة مختلفة عن مستوى واحد بسيط. ابدأ ببيانات اختبار وراجع أسماء المسارات التي سيطالها التنفيذ بدل الاعتماد على تأكيد عام غير مرتبط بالقائمة.

ما الذي يجب أن يبقى؟

لا تحذف lib وassets وpubspec.lock أو ملفات Android وiOS ولا شهادات وتوقيعًا من أجل المساحة. رموز إصدار منشور وأرشيفاته قد تحتاجهما لاحقًا حتى إن أمكن بناء برنامج جديد من الكود. خزنهما خارج build المؤقت وفق سياسة الفريق. بعد التنظيف شغل pub get وبناء تطبيق مهم وتحقق من رجوع العمل، وسجل المساحة المتحررة والوقت الذي كلفه البناء الأول. إذا امتلأ القرص مجددًا سريعًا فراجع مصدر تكرار artifacts أو الصور بدل إضافة تنظيف شامل عند كل تشغيل.

اختيار الوقت المناسب

نفذ التنظيف عند حاجة فعلية للمساحة وبعد إيقاف العمل، واحتفظ بهامش لبناء جديد. لا تجعل تنظيف الكاش المشترك تلقائيًا عند فتح كل مشروع؛ فقد تتكرر تنزيلات كبيرة ويتأخر الفريق بلا فائدة. إن كان جهازك قليل التخزين فراجع أحجام المحاكيات والنسخ المؤرشفة والـartifacts المكررة كعناصر مستقلة، ولا تحذف أيًا منها لمجرد أنها كبيرة قبل معرفة ما تستخدمه المشاريع المهمة.

مراجعة أخيرة للتطبيق

لا تفترض أن اسم مجلد build يجعل كل الملفات الأخرى بجواره قابلة للحذف أيضًا.

مثال الشفرة بعد المراجعة

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

# macOS / Linux: preview only. Change the project root intentionally.
projects_root="$HOME/dev"
for project_dir in "$projects_root"/*; do
  [ -d "$project_dir" ] || continue
  [ -f "$project_dir/pubspec.yaml" ] || continue
  printf '%s\n' "$project_dir"
done
# Review this list, stop active builds, then run flutter clean
# manually in each selected Flutter project. No cache deletion here.

مرجع للتنفيذ

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

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع