شرح AutomaticKeepAliveClientMixin في Flutter لحفظ حالة صفحات التبويبات، وحدود الاحتفاظ بالحالة والفرق بين ذلك وتخزين البيانات الدائم.
ما الذي تحتفظ به الميزة؟
تساعد keep-alive على إبقاء State لطفل داخل سياق يدعم إشعارات الاحتفاظ، مثل صفحات تمرير كسول مناسبة. لا تجعل الصفحة خالدة بعد حذفها نهائيًا من الشجرة أو تغير مفتاحها أو انتهاء العملية. لذلك لا تصفها بأنها تحفظ الحالة حتى بعد إغلاق التطبيق. التمييز مهم: بقاء عداد داخل تبويب أثناء التنقل يختلف عن استعادته بعد قتل العملية، والأخير يحتاج تصميم استعادة أو تخزين يناسب البيانات وليس مجرد mixin.
الخطوات المطلوبة
أضف AutomaticKeepAliveClientMixin إلى State الخاص بالصفحة، وعرّف wantKeepAlive بالقيمة التي تعبر عن حاجتك، واستدع super.build(context) داخل build مع تجاهل القيمة التي يعيدها. هذا الاستدعاء جزء من بروتوكول المزيج وليس بديلًا عن إرجاع Widget حقيقية. المثال السابق الذي ينتهي بتعليق فقط لا يبني واجهة؛ المثال التالي يعيد Scaffold قابلًا للتشغيل داخل TabBarView. إذا تغيرت wantKeepAlive ديناميكيًا فأبلغ المزيج عبر updateKeepAlive في المكان المناسب.
هل توجد قاعدة شاشة واحدة؟
لا يوجد حد عام يقول إن الميزة تصلح لشاشة واحدة فقط. تكلفة الاحتفاظ تعتمد على حجم الحالة والصور والاشتراكات والموارد المحتفظ بها، وعلى عدد الصفحات وكيف تبنيها. احتفظ بما تحتاجه وقِس الذاكرة على جهاز ممثل، بدل تشغيلها لكل صفحة أو منعها مطلقًا. بقاء الصفحة حية قد يعني استمرار مصدر بيانات أو مراقبة لا يحتاجها المستخدم؛ سياسة إيقاف هذه الموارد تحتاج تفكيرًا منفصلًا عن keep-alive.
منع تكرار طلبات البيانات
إذا كان طلب Firebase أو API يبدأ داخل build، فإن إبقاء State لا يضمن منع تكراره عند كل إعادة بناء. ضع Future أو اشتراك البيانات في موضع يملكه بوضوح، وافهم cache الخاص بطبقة البيانات ومتى تعيد التحميل. قد تختار إدارة حالة أعلى من التبويبات للاحتفاظ ببيانات مشتركة، مع بقاء كل صفحة قابلة للإزالة. لا تجعل keep-alive إصلاحًا يخفي خطأ إنشاء مصادر جديدة باستمرار، ولا تدّع تقليل استهلاك الشبكة دون مراقبة عدد الطلبات الفعلي.
المفاتيح والتمرير والاستعادة
استخدم مفاتيح مستقرة عندما تكون هوية الصفحة مهمة، ولا تولّد UniqueKey جديدًا في كل بناء ثم تتوقع State نفسها. حفظ موضع التمرير قد يعتمد على PageStorage أو ScrollController وتصميم القائمة، وليس جميعه وظيفة هذا المزيج. إذا كانت البيانات تتغير من مستخدم إلى آخر فامسح الحالة أو غيّر هوية المورد وفق سياسة واضحة، حتى لا تظهر بيانات حساب سابق تحت حساب جديد. التخزين الدائم للبيانات الحساسة يحتاج ضوابط أخرى للخصوصية والأمان.
كيف تجرّب المثال؟
ارفع العداد داخل التبويب الأول ثم انتقل للثاني وعد. ستجد الحالة محفوظة في سياق المثال، ويمكنك مقارنة السلوك عند تغيير السياسة في نسخة اختبار. جرّب إعادة ترتيب تبويبات بمفاتيح غير مستقرة لتفهم أثر الهوية، وراقب dispose لتعرف متى ينتهي عمر الصفحة فعلًا. لا تستنتج من نجاح المثال على تبويبين أن الاحتفاظ بمئات الصفحات مناسب. بعد إدخال الميزة في تطبيقك راقب الذاكرة والمصادر النشطة وخيارات تحديث البيانات قبل اعتمادها.
يمكنك تسجيل إنشاء State وانتهاءه في نسخة تشخيصية لتفهم ملكية التبويب، ثم إزالة التسجيل بعد الفحص. قارن السيناريو نفسه قبل التغيير وبعده مع عدد صفحات مماثل، ولا تعتمد على نجاح التنقل مرة واحدة بوصفه قياسًا شاملًا لذاكرة التطبيق أو كلفة مصادر البيانات.
المثال التطبيقي
المثال مستقل للتعلم. شغّله داخل مشروع تجريبي، ثم بدّل مصدر البيانات المحلي بخدمة مشروعك بعد اختبار حالات النجاح والفشل. لا تنسخ أكثر من دالة main إلى الملف نفسه.
import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: TabsPage()));
class TabsPage extends StatelessWidget {
const TabsPage({super.key});
@override
Widget build(BuildContext context) => DefaultTabController(
length: 2,
child: Scaffold(
appBar: AppBar(bottom: const TabBar(tabs: [Tab(text: 'First'), Tab(text: 'Second')])),
body: const TabBarView(children: [
DemoPage(key: ValueKey('first')),
DemoPage(key: ValueKey('second')),
]),
),
);
}
class DemoPage extends StatefulWidget {
const DemoPage({super.key});
@override
State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> with AutomaticKeepAliveClientMixin<DemoPage> {
int _count = 0;
@override
bool get wantKeepAlive => true;
@override
Widget build(BuildContext context) {
super.build(context);
return Center(child: ElevatedButton(
onPressed: () => setState(() { ++_count; }),
child: Text('Count: $_count'),
));
}
}التوثيق والتجربة
راجع التوثيق الرسمي عند مطابقة إصدار الأداة. اختبر العودة إلى الصفحة والخروج منها والحالة الفارغة والفشل، وراقب أن الموارد التي تملكها الصفحة تُغلق عند انتهاء حاجتها.






