قياس وقت استخدام Flutter في المقدمة باستخدام دورة حياة التطبيق وStopwatch، وفصل مدة الجلسة عن تاريخ اليوم ومنع الحساب المكرر.
مدة الجلسة ليست فرقًا عن بداية الشهر
طرح day-1 من تاريخ الآن يعيد تاريخًا في بداية الشهر تقريبًا، ولا يقيس وقت استخدام التطبيق. كما أن جمع الفرق الكامل عند كل تحديث يكرر أجزاء من الزمن. استخدم Stopwatch لفترات النشاط واجمع interval مرة واحدة عند انتهاء كل فترة، وحدد مسبقًا هل inactive محسوب أم مستبعد في مقياسك.
احتمال الإنهاء دون callback
دورة الحياة ليست ضمانًا أن النظام سيمنح التطبيق فرصة حفظ أخيرة عند قتله. احفظ نقاطًا دورية محدودة إذا احتجت ديمومة، ولا تكتب تخزينًا في كل إطار. افصل اليوم التقويمي ومنطقة المستخدم عن عداد الزمن الرتيب، ولا تجمع تقديرًا محليًا مع analytics آخر دون إزالة الازدواج. وضح معنى الرقم للمستخدم ولا تعرضه كوقت انتباه مؤكد.
تعريف ما تقيسه
حدد هل المقصود مدة بقاء التطبيق في resumed فقط، أم جلسة من أول فتح حتى الخروج، أم وقت تفاعل داخل شاشة محددة. هذه مقاييس مختلفة وقد يختلف إدراج inactive عند ظهور نافذة نظام أو مكالمة. المثال يعد زمنًا في الذاكرة ما دام resumed وفق سياسته ولا يرسل تحليلات إلى خادم. وضوح التعريف يمنع تسمية رقم تقريبي «مدة مشاهدة المستخدم» بينما كان التطبيق مفتوحًا دون انتباه.
عداد زمني لا ساعة تقويم
Stopwatch مناسب لقياس فترات لأنه لا يعتمد على تغيير ساعة الجهاز مثل طرح DateTime.now في كل مرة. start بعد stop يواصل من الزمن المتراكم، فلا تجمع elapsed كاملة مجددًا فوق مجموع سابق إلا إن صفّرت العداد وفق عقدك. المثال يعرض لقطة عندما يضغط المستخدم الزر لتجنب Timer واجهة لا تحتاجه الفكرة. إذا احتجت عرضًا حيًا فاستعمل مؤقتًا محدودًا وألغِه في dispose ولا تخلط عدد tick مع الزمن الحقيقي.
التخزين وحدود اليوم
لو احتجت تقريرًا يوميًا فعرّف منطقة اليوم التقويمية ثم وزع الفترات التي تعبر منتصف الليل بحسب السياسة. لا تعتبر DateTime.now.subtract(Duration(days:day-1)) بداية اليوم؛ إنها عملية تقود نحو بداية الشهر مع إبقاء وقت الساعة. احفظ رقم نسخة schema وآخر فترة مكتملة كي لا تعيد احتسابها عند فتح التطبيق، وحدد كيف تتعامل مع سجل انقطع قبل حفظ النهاية. حفظ كل ثانية في التخزين ليس ضروريًا لكل منتج وقد يضيف كلفة دون دقة مضمونة.
اختبار دورة الحياة
جرب resumed ثم inactive ثم paused ثم resumed وتأكد أن الفترات المستبعدة لا تدخل الحساب. أغلق الصفحة التي تملك المستمع وتحقق من عدم تحديث State بعد dispose. النظام قد يقتل العملية دون انتقال نهائي يمكن لتطبيقك معالجته، لذا لا تقدم الرقم بوصفه سجلًا محاسبيًا مضمونًا. إذا أرسلت أحداث analytics فاستخدم معرفات لمنع الازدواج وعرّف البيانات الضرورية فقط. اختبر الحساب بساعة وهمية في unit test ثم لاحظ سلوك الجهاز لأن محاكاة callback وحدها لا تختبر كل حالات النظام.
عدم مضاعفة المدة
عند إرسال لقطة دورية حدد هل الرقم إجمالي أم فترة جديدة؛ جمع إجماليات متتابعة على الخادم يضخم الوقت. استخدم عقدًا واضحًا ومعرف فترة واختبر إعادة إرسال الحدث بعد انقطاع الشبكة كي تبقى النتيجة متسقة.
مراجعة أخيرة للتطبيق
حدد مجال العداد في وصف المقياس.
مثال الشفرة بعد المراجعة
اقرأ التعليقات ومتطلبات الإعداد قبل النقل إلى مشروعك. أمثلة الواجهات ذات main مستقلة، أما العقود والمقاطع الأصلية وملفات الإعداد فموضح نطاقها داخل المثال.
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> {
final Stopwatch _watch=Stopwatch();
late final AppLifecycleListener _lifecycle;
Duration _total=Duration.zero;
@override
void initState(){super.initState();_watch.start();
_lifecycle=AppLifecycleListener(onStateChange:(state){
if(state==AppLifecycleState.resumed){_watch.start();}
else {_watch.stop();}
});}
void _snapshot(){setState(()=>_total=_watch.elapsed);}
@override
void dispose(){_lifecycle.dispose();_watch.stop();super.dispose();}
@override
Widget build(BuildContext context) => Scaffold(
appBar: AppBar(title: const Text('Flutter lesson')),
body: Center(child:TextButton(onPressed:_snapshot,child:Text('Foreground elapsed: ${_total.inSeconds}s'))));
}
الصور والفيديو التوضيحي
قد تعرض الوسائط إصدارًا أقدم. اعتمد الخطوات النصية المصححة عند اختلاف إعدادات المنصة أو أسماء الواجهات.

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






