مراجعة Activity Tracker Flutter بوصفه مشروع واجهة وحركات وتنقل، مع توضيح الفرق بين بيانات العرض وربط أجهزة أو خدمات تتبع النشاط الفعلية.
ما الذي تؤكده مراجعة المصدر؟
يصف المستودع تطبيق تتبع نشاط مع رسوم متحركة، وتحتوي بنيته شاشات home وtoday وhealth وprofile وحركات مخصصة. الاعتماديات الظاهرة تركز على go_router والخطوط والأيقونات وLottie؛ لا تثبت وحدها تكاملًا مع مستشعر خطوات أو Health Connect. لذلك ابدأ به مثالًا لبناء لوحة متابعة، ولا تفسر الأرقام المعروضة باعتبارها قياسات فعلية صادرة عن جهاز المستخدم قبل ربط مصدر بيانات والتحقق منه.
تشغيل الواجهة وفهم المسارات
افحص ملف router وإعدادات الصفحات ونقطة الدخول قبل تغيير شريط التنقل. ثبت الحزم المتوافقة مع قيد SDK الخاص بالمشروع ثم شغل المسارات واحدًا واحدًا. ضع معرفات ثابتة للأقسام، واختبر زر الرجوع والفتح المباشر والعودة من الخلفية. إذا أعدت إنشاء الصفحة مع كل ضغطة فقد تفقد موضع التمرير؛ حدد متى تحفظ حالة التبويب ومتى تعيد جلب بياناته.
اسم ملف حساس لحالة الأحرف
تحتوي شاشة today في المصدر على import باسم Custom_card.dart بينما يظهر الملف في الشجرة باسم custom_card.dart. طابق اسم الاستيراد مع الاسم الحقيقي عند نقل المشروع إلى نظام ملفات حساس لحالة الأحرف، بدل علاج الخطأ بإضافة نسخة ثانية من الملف. راجع بقية imports والأصول بالطريقة نفسها قبل تغيير الاعتماديات؛ خطأ مسار ملف محلي لا يصلحه تحديث go_router.
تحويل الأرقام إلى نموذج بيانات
أنشئ نموذجًا يفصل القيمة والوحدة والفترة الزمنية ومصدر القياس وحالة التحميل. لا تخلط خطوات اليوم مع مجموع الأسبوع أو السعرات المقدرة مع قراءة مباشرة، ولا تستبدل البيانات المفقودة بصفر يبدو مؤكدًا. إذا ربطت خدمة صحية لاحقًا، تحقق من إذن القراءة وما إذا كانت النتيجة جديدة أو مخزنة أو ناقصة. صمم الواجهة لتوضح هذه الحالات بدل إظهار رقم واحد دون سياق.
الحركة والأداء وإتاحة الاستخدام
حركات الظهور مناسبة لشرح ترتيب العناصر، لكنها لا تحتاج إلى إعادة التشغيل مع كل تحديث قيمة. احترم تقليل الحركة، وحدد حجم رسوم Lottie وأعد استخدام الأجزاء الثابتة بدل إعادة بناء اللوحة كاملة لكل إطار. اختبر النص الطويل وRTL وتكبير الخط والتباين في الوضعين. اعرض القيمة والوحدة نصيًا إلى جانب الرسم حتى لا يصبح اللون أو شكل الدائرة الوسيلة الوحيدة للفهم.
حدود المنتج والاختبار
جرب بيانات تجريبية ثابتة وصفرية ومفقودة وتغير يوم المستخدم حسب منطق المنطقة الزمنية. اختبر التبويبات والتمرير على هاتف صغير وشاشة أكبر، ثم قس الأداء في وضع مناسب. لا يقدم هذا المصدر بمفرده حكمًا على صحة المستخدم أو خطة نشاط؛ المقال يشرح بناء الواجهة وعقد البيانات. عند تقديم قياسات حقيقية احتفظ بمصدرها وتوقيتها وقيودها، ولا تنسب للمشروع ميزات أجهزة لم تتحقق منها.
أوامر بدء مراجعة المصدر
هذه أوامر مقترحة لنسخة محلية مستقلة؛ راجع README وpubspec وإعداد المنصة قبل التشغيل. نجاح تنزيل المصدر لا يعني أن بناءه أو خدماته قد اختبرت على كل إصدار حديث.
git clone https://github.com/Aditya-Thakur-369/Activity_Tracker.git
cd Activity_Tracker
flutter --version
flutter pub get
flutter analyze
flutter run





