شرح Timer في Flutter لتنفيذ مهمة مؤجلة وعدّ تنازلي، مع إلغاء المؤقت السابق وضبط دورة الحياة وفهم حدود دقة المؤقتات في الخلفية.
مهمة واحدة أو أحداث دورية
Timer لمدة محددة ينفذ callback مرة واحدة ما لم يُلغَ، بينما Timer.periodic يولد استدعاءات دورية حتى الإلغاء. اختر ما يطابق المهمة بدل إنشاء مؤقت دوري لتنفيذ فعل واحد فقط. المرجع إلى Timer يسمح لك بإلغائه، ويجب إلغاء المؤقت السابق عند بدء جلسة جديدة حتى لا تعمل عدة عدّادات فوق بعضها. في المثال لا توجد عملية تسجيل خروج أو حذف بيانات تلقائية؛ انتهاء العدّ يغير رسالة واجهة تجريبية فقط.
لا تعتمد على عدد النبضات لقياس الوقت
قد تتأخر callbacks عندما ينشغل event loop أو ينتقل التطبيق إلى الخلفية. طرح واحد من متغير كل ثانية لا يضمن أنه يساوي الزمن الحقيقي المنقضي. اختر ساعة مناسبة لغرضك؛ Stopwatch يفيد في قياس مدة داخل العملية، وموعد انتهاء محدد يفيد في إعادة حساب المتبقي وفق سياسة واضحة. System clock قد يتغير، وإغلاق العملية أو إيقافها قد يغير ما تستطيع استعادته. لا تجعل مؤقت عميل وحده مصدر صلاحية مالية أو أمنية.
إدارة المؤقت في State أو Cubit
إذا كانت الصفحة تملك المؤقت فألغِه في dispose، وإذا كانت طبقة حالة تملكه فأغلقه في دورة حياتها المناسبة. لا تستدعِ setState بعد مغادرة الصفحة، ولا تنشئ Timer.periodic داخل build. راجع العمليات asynchronous التي يبدأها callback؛ Timer لا ينتظر Future داخل callback دوري تلقائيًا، وقد تتداخل دورات عمل طويلة. عندما يلزم الانتظار بين الدورات صمم حلقة محدودة أو جدولة بعد انتهاء المهمة بدل تراكب الطلبات.
اختيار معنى الخلفية والاستئناف
حدد ماذا يحدث إذا ضغط المستخدم Home أو قفل الجهاز. قد تريد إيقاف عداد تدريب مؤقتًا، بينما انتهاء جلسة دخول يحتاج تحققًا من صلاحية الخادم عند العودة. لا تفترض وصول callback أخير عند قتل التطبيق، واحفظ الحالة المهمة في الوقت المناسب. عند عرض عداد اعتمادًا على موعد انتهاء، أعد الحساب عند الاستئناف إذا كانت تجربة المستخدم تحتاج تحديثًا فوريًا. السياسة الوظيفية تأتي قبل اختيار Widget يعرض دائرة تقدم.
التحقق من السلوك
اختبر البدء مرتين ثم الإلغاء ثم مغادرة الصفحة ثم إعادة فتحها. اجعل المدة قصيرة في الاختبار حتى ترى أن مؤقتًا واحدًا فقط يملك الحالة. جرّب تغيير وقت الجهاز إذا استخدمت موعدًا مبنيًا على DateTime وافهم أثر ذلك؛ هذا المثال للعرض المحلي وليس ساعة موثوقة ضد التلاعب. لا تضع signOut أو مسح قاعدة البيانات داخل مثال عام دون توضيح عقد الاستعادة وحماية المستخدم من الفقد.
موعد الانتهاء ليس إشعار نظام
إذا كان المطلوب تذكير المستخدم بعد إغلاق التطبيق، فإن Timer داخل الذاكرة لا يضمن بقاء العملية أو تنفيذ التنبيه. تحتاج آلية جدولة تدعمها المنصة مع الصلاحيات والسياسات المناسبة، وقد تكون هناك قيود على الدقة والعمل بالخلفية. أما العداد المرئي داخل الشاشة فيمكنه إعادة حساب المتبقي من الحالة المحفوظة عندما يعود المستخدم. ميّز بين عرض الوقت وتنفيذ أثر تجاري: انتهاء مهلة عرض لا يثبت انتهاء جلسة الخادم، كما أن توقف مؤقت محلي لا يمدد صلاحية جلسة فعلية. اختبر ما يراه المستخدم بعد الاستئناف ثم راجع الحالة المرجعية قبل السماح بإجراء يعتمد على الوقت.
مثال كامل للتجربة
ضع المثال في ملف مستقل داخل مشروع تجريبي. في أمثلة Flutter شغّل DemoPage داخل MaterialApp، ولا تدمج أكثر من main في الملف نفسه. البيانات محلية للتعلم ويمكن استبدالها بمصدر بيانات بعد فهم حالات النجاح والخطأ.
import 'dart:async';
import 'package:flutter/material.dart';
void main() => runApp(const MaterialApp(home: DemoPage()));
class DemoPage extends StatefulWidget {
const DemoPage({super.key});
@override
State<DemoPage> createState() => _DemoPageState();
}
class _DemoPageState extends State<DemoPage> {
Timer? _timer;
DateTime? _deadline;
int _remaining = 0;
void _start() {
_timer?.cancel();
_deadline = DateTime.now().add(const Duration(seconds: 5));
setState(() { _remaining = 5; });
_timer = Timer.periodic(const Duration(milliseconds: 100), (timer) {
final milliseconds = _deadline!.difference(DateTime.now()).inMilliseconds;
final seconds = milliseconds <= 0 ? 0 : (milliseconds / 1000).ceil();
if (!mounted) { timer.cancel(); return; }
if (seconds != _remaining) setState(() { _remaining = seconds; });
if (seconds == 0) timer.cancel();
});
}
@override
void dispose() { _timer?.cancel(); super.dispose(); }
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: const Text('Timer')),
body: Center(child: Column(mainAxisSize: MainAxisSize.min, children: [
Text(_remaining == 0 ? 'Ready or finished' : '$_remaining seconds'),
ElevatedButton(onPressed: _start, child: const Text('Start again')),
])),
);
}مرجع التفاصيل والتوافق
راجع التوثيق الرسمي عند نقل المثال إلى إصدار مختلف، ثم جرّب الحالة الطبيعية والفشل ومغادرة الصفحة أثناء الانتظار. دوّن السلوك المتوقع قبل تعديل منطق مشروعك.
الصور والفيديو من الشرح السابق
الكود النصي أعلاه هو النسخة المصححة؛ قد تختلف المواد المرئية السابقة في أسماء المتغيرات أو طريقة التشغيل.






