تشخيص تعطل Hot Reload في Flutter والتمييز بين rebuild وHot Restart وإعادة البناء الأصلي مع الحفاظ على Future خارج build.
إعادة بناء الشجرة ليست إعادة تشغيل التطبيق
وجود FutureBuilder في جذر التطبيق لا يسبب Hot Restart بذاته، وعدم استخدام Bloc أو Provider ليس سببًا عامًا لفشل Hot Reload. إعادة إنشاء Future داخل build قد تكرر الطلب وتُشبه فقدان الحالة، بينما العملية لم تبدأ من جديد. خزّن Future عند بدء الحالة أو عند تغير مدخلاته ثم راقب سجل الطلبات، بدل نقل كل FutureBuilder بعيدًا عن الجذر بلا تشخيص.
ما الذي يبقى وما الذي يعاد؟
Hot Reload يحتفظ عادة بحالة Dart الحالية ولا يعيد main أو initState. Hot Restart يبدأ حالة Dart من جديد ويفقد الحالة الموجودة في الذاكرة، ولا يحافظ عليها كما يفعل reload. تغيير كود Kotlin أو Swift أو تعريف plugin يحتاج إيقافًا وبناءً أصليًا. افحص أخطاء الترجمة ووضع debug واتصال debugger أولًا، ولا تستخدم flutter clean لكل تعديل نصي أو كبديل لفهم رسالة الخطأ.
ابدأ بعلامة يمكن ملاحظتها
غيّر نص عنوان أو لونًا داخل build واحفظ الملف، ثم نفذ Hot Reload من زر الأداة وانتظر النتيجة في السجل. إذا ظهرت رسالة خطأ ترجمة فلا تبحث عن مشكلة state قبل إصلاحها. إذا نجح التحديث اليدوي وفشل التحديث عند الحفظ فالمشكلة أقرب لإعداد المحرر أو الملف أو الجلسة النشطة. تأكد أنك تعدل الملف المستخدم بالفعل وأن التطبيق ليس نسخة release مختلفة مثبتة إلى جوار نسخة التطوير. اختبر مسارًا صغيرًا قبل تغيير هيكل المشروع أو حزم إدارة الحالة.
لماذا تبقى قيمة متغير قديم؟
الحفاظ على الحالة مقصود: تغيير initializer لحقل داخل State لا يعني إعادة إنشائه في الحالة الموجودة. Hot Reload يعيد بناء الشجرة بالكود الجديد مع قيمها الحالية حيث يدعمه التغيير. قد تحتاج Hot Restart لتطبيق قيمة بداية أو تهيئة main جديدة، وبعدها ستفقد مسودة الذاكرة. قاعدة البيانات أو تفضيل محفوظ قد يبقي بياناته رغم restart لأن مصدره ليس الذاكرة فقط. افصل ما رأيته: هل القيمة من التخزين أم من State أم من رد شبكة سابق؟
المستقبل وإعادة الطلب
إذا مررت fetchLessons() إلى FutureBuilder مباشرة داخل build فكل بناء قد ينشئ مستقبلًا مختلفًا. خزّن Future في initState إذا كان الطلب تابعًا لعمر الصفحة، أو أعد إنشاءه عند تغير هوية المدخلات في موضع مناسب. عند إضافة زر إعادة محاولة استبدل المستقبل صراحة. لا تستخدم initState لقراءة inherited dependency بلا مراعاة دورة الحياة؛ بعض الحالات تحتاج didChangeDependencies. السبب هنا تكرار عمل I/O، وليس شرطًا أن Flutter أعاد تشغيل كل التطبيق.
تغيير Native أو بنية غير مدعومة
إضافة plugin أو تغيير manifest أو إعداد Xcode أو Kotlin يحتاج بناءً وتشغيلًا من جديد حتى يدخل في binary، ولا يستطيع Hot Reload تعديل ما لم يُجمع في التطبيق الأصلي. راجع القيود الخاصة بتغيير الأنواع والهياكل من دليل الإصدار، ولا تفترض أن كل تعديل يقبل الحقن الحي. احتفظ بسجل واضح للتغييرات التي أجريت منذ آخر تشغيل ناجح، وجرب العودة عن آخر تغيير محدد بدل حذف كل مجلدات المنصة. استخدم clean فقط عندما يكون لديك سبب يتعلق بمخرجات البناء المتولدة.
التحقق من النتيجة
بعد الإصلاح جرّب تحديث نص مع الاحتفاظ بعداد، ثم Hot Restart لتلاحظ إعادة تعيين العداد. راقب عدد طلبات API بعد rebuild وتأكد أنه لم يتضاعف بلا طلب مستخدم، وأغلق الصفحة أثناء طلب معلّق لاختبار mounted. احتفظ بهذه الخطوات في وصف المشكلة حتى يستطيع زميل إعادة إنتاجها. لا توجد علاقة سببية عامة تجعل اختيار Bloc أسرع من Provider في إصلاح Hot Reload؛ نوع إدارة الحالة يجب أن يخدم تصميم الميزة لا أن يستعمل كبديل لتشخيص الأداة.
بيانات التشخيص الآمنة
شارك أسماء الإصدارات ورسائل الخطأ المختصرة ومثالًا مصغرًا؛ لا تحتاج المشكلة إلى مفاتيح API أو بيانات حساب حقيقية كي يمكن إعادة إنتاجها والتحقق من سببها.
مرجع للتنفيذ
راجع التوثيق الخاص بهذا الموضوع وطابق إعداداته مع إصدار أدوات مشروعك. اختبر السلوك المستهدف وحالة الفشل قبل إدماج المثال في تطبيق منشور.






