دراسة تطبيق قرآن ومواقيت صلاة Flutter من Al-Quran، مع Provider والبيانات المحلية والصوت واتجاه القبلة وتحديث إعدادات المصدر القديم.
تمييز هذا المثال عن بقية مشاريع القرآن
يعرض README مشروع Al-Quran للقراءة ومواقيت الصلاة واتجاه القبلة والراديو والأذكار. يعكس ذلك تطبيقًا متعدد الصفحات، لا مكتبة واحدة تضيف كل الميزات تلقائيًا. هذا المقال يركز على كيفية فهم وتحديث مثال أقدم يعتمد Provider وعدة خدمات، بينما يتناول مقال طمأنينة ومكتبة الحكمة مصدرين مختلفين. لا تخلط بيانات أو ملفات تهيئة أحدها بالآخر لمجرد تشابه الأسماء.
التحقق من البيئة والأصول
راجع pubspec ونسخة Flutter المستهدفة وملفات الخطوط والصور والبيانات قبل التشغيل. تعليمات README القديمة تذكر إصدارات سابقة، وقد تتطلب الإضافات تعديل إعداد Android أو iOS عند تحديثها. استخدم اسم المجلد الناتج من git clone الفعلي بدل نسخ اسم مجلد تنزيل ZIP مختلف. ابدأ بقراءة البيانات المحلية ثم وسع الاختبار للخدمات التي تحتاج شبكة أو إذنًا.
القراءة والمحفوظات
اختبر عرض السور والآيات والبحث والعودة إلى موضع القراءة مع تكبير الخط وRTL. احفظ مرجعًا مستقرًا للسورة والآية لا index من نتيجة بحث، ولا تجعل تغيير شكل الأرقام يغير القيم الأصلية. افصل تفضيلات المظهر عن البيانات المرجعية، وراجع ما يحدث للمحفوظات عند تحديث بنية التخزين. لا تعتمد على لقطات الشاشة لتأكيد دقة النص؛ قارن البيانات المعروضة بمصدرها المرجعي عند تغييرها.
الموقع والصوت ومواقيت الصلاة
خدمة القبلة تحتاج اختبار المستشعر، ومواقيت الصلاة تحتاج موقعًا وطريقة حساب ومنطقة زمنية، والراديو يحتاج مصدرًا متاحًا على الشبكة. كل خدمة قد تفشل بشكل مستقل؛ اعرض بديلًا مفهومًا بدل تعطيل التطبيق كله. اطلب الموقع حين يحتاج المستخدم الميزة، ولا تسجل تاريخ المواقع بلا حاجة. عند انقطاع محطة صوتية أوقف انتظارًا لا ينتهي واسمح بالعودة إلى القراءة دون شبكة.
اختبار الترقية خطوة بخطوة
شغل شاشة واحدة ثم التنقل والمظهر فالصوت فالموقع، وسجل التغييرات المطلوبة لكل إضافة. لا تحدث كل dependency وتعيد تصميم الصفحات في الخطوة نفسها؛ يصعب حينها معرفة سبب العطل. اختبر تثبيتًا جديدًا وتحديثًا فوق بيانات قديمة وهاتفًا يرفض الإذن. المصدر مفيد للتعلم، لكن توفر كوده أو APK قديم لا يثبت أنه جاهز للنشر الحالي دون مراجعة إعدادات المنصات والبيانات والحقوق المرتبطة بالمحتوى.
أوامر بدء مراجعة المصدر
هذه أوامر مقترحة لنسخة محلية مستقلة؛ راجع README وpubspec وإعداد المنصة قبل التشغيل. نجاح تنزيل المصدر لا يعني أن بناءه أو خدماته قد اختبرت على كل إصدار حديث.
git clone https://github.com/abdalla3yash/Al-Quran.git
cd Al-Quran
flutter --version
flutter pub get
flutter analyze
flutter run





