كشف الكود غير المستخدم في Flutter يبدأ بفهم الفرق بين تنبيه المحلل وما يصل فعلًا إلى إصدار الإنتاج. حذف أي ملف لا يظهر في بحث نصي قد يكسر التوليد أو التسجيل الديناميكي أو assets. كما أن تقليل أسطر المصدر لا يساوي تلقائيًا تقليل حجم التنزيل لأن بناء release يطبق تحسينات وtree shaking ضمن حدوده.
ابدأ بالأدوات الرسمية
شغّل flutter analyze لإصلاح الأخطاء والتنبيهات، وراجع نتيجة dart fix –dry-run قبل أي تطبيق. المحلل قد يكشف تعريفات خاصة غير مستخدمة واستيرادات زائدة، لكنه لا يثبت أن كل ملف عام بلا استخدام. احتفظ بنسخة تحكم بالإصدارات وشغّل اختبارات التطبيق بعد كل مجموعة تغييرات صغيرة.
ماذا حدث لـDart Code Metrics؟
حزمة dart_code_metrics القديمة على pub.dev معلّمة discontinued، وقيد SDK في آخر إصدار منشور لا يقبل Dart 3. لذلك لا يقدم هذا الدرس أمر check-unused-files القديم باعتباره مسارًا صالحًا لكل مشروع Flutter حديث. إذا اخترت أداة خارجية فراجع المنتج الحالي وترخيصه وتوافقه من مصدره.
راجع assets والحزم
احصر الصور والخطوط والصوت المعلنة في pubspec.yaml، ثم افحص المراجع المباشرة والتوليد ومسارات التحميل القادمة من بيانات. أزل اعتمادًا غير مطلوب باستخدام flutter pub remove فقط بعد معرفة ما يستعمله. لا تعدل pubspec.lock يدويًا لحل اعتماد، ولا تمسح ملفات المنصات بحثًا عن مساحة.
قياس الحجم قبل الحكم
ابنِ إصدارًا مناسبًا للمنصة وقارنه بنفس إعدادات البناء. استخدم تحليل الحجم في Flutter DevTools لمعرفة نصيب مكتبات Dart والموارد. حجم APK كامل يختلف عن تنزيل كل جهاز من App Bundle، لذلك حدد المقياس الذي تريد تحسينه بدل الاكتفاء بحجم مجلد المشروع.
خطة تحقق بعد التنظيف
اختبر المسارات قليلة الاستخدام وشاشات اللغات والميزات التي تحمل موارد عند الطلب. راجع الأخطاء في التحليل والبناء واختبارات الواجهة، ثم قارن تقرير الحجم قبل وبعد. إذا لم يتحسن الحجم فلا تنسب التحسن إلى حذف الملفات بلا قياس؛ قد تكون الموارد أو مكتبة أصلية هي العامل الأكبر.
الإعداد
flutter analyze
dart fix --dry-run
flutter build apk --release --analyze-size --target-platform android-arm64تطبيق الكود غير المستخدم في Flutter في مشروعك
ابدأ بالمحلل الرسمي ثم راجع مراجع assets والتوليد قبل الحذف؛ Dart Code Metrics القديم معلّم discontinued ولا يقبل Dart 3 في قيده المنشور.
مراجع الموضوع: docs.flutter.dev — app-size، dart.dev — dart-analyze






