شارك المقالة
تطبيق قرآن Flutter طمأنينة: تشغيل المشروع وبنيته

تطبيق قرآن Flutter طمأنينة: تشغيل المشروع وبنيته

مراجعة تطبيق قرآن Flutter طمأنينة ومشروع qurani-master، مع إعداد الخطوط والملفات والصوت والإشعارات وفحص التهيئة قبل البناء.

مراجعة تطبيق قرآن Flutter طمأنينة ومشروع qurani-master، مع إعداد الخطوط والملفات والصوت والإشعارات وفحص التهيئة قبل البناء.

هوية المشروع وما يميزه

يعرض README الحالي المشروع باسم طمأنينة، ويصف القراءة والاستماع والعلامات ومواقيت الصلاة ومحتوى إسلاميًا إضافيًا. تحتوي البنية على features منفصلة للقرآن والصوت والبحث والإعدادات وغيرها. نركز هنا على تشغيل هذا المصدر وفهم توزيع مسؤولياته، بينما يشرح مقال مكتبة الحكمة مشروعًا آخر مستقلًا. وجود ميزة مذكورة في README لا يغني عن تجربتها في النسخة والفرع اللذين ستبنيهما.

متطلبات التشغيل من الملف الفعلي

راجع SDK في pubspec وملفات المنصات والاعتماديات المحلية قبل تنفيذ أوامر التشغيل. يشير المصدر إلى quran_library داخل flutter_packages، لذا تنزيل ملف Dart منفرد لن يكفي؛ يجب توافر الملفات والخطوط وقواعد البيانات المرتبطة. بعض الاعتماديات لا تقيد إصدارًا محددًا، لذلك احتفظ بملف القفل وراجع أي تغيير في الحل. هيئ خدمات Firebase المطلوبة بحساب اختبار تملكه بدل افتراض أن ملفات الناشر مناسبة لتطبيقك.

دقة النص وتجربة القراءة

حافظ على معرفات السور والآيات وترتيبها عند تغيير العرض، واختبر الخط العثماني والوصل وعلامات الوقف والأرقام في RTL. افصل بيانات النص المرجعية عن النص الذي تطبعه للبحث؛ إزالة التشكيل أو تطبيع الحروف في حقل بحث لا يبرر تغيير النص المعروض. جرب حفظ موضع القراءة ثم إغلاق التطبيق وفتحه، واجعل العلامة تعتمد معرفًا مستقرًا لا index متغيرًا في قائمة نتائج.

الصوت والتنزيل والتنبيهات

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

خطة تعديل دون كسر بقية الميزات

حافظ على فصل services وإدارة الحالة عن Widgets القراءة، وابدأ بتغيير صغير يمكن التحقق منه. بعد تغيير قاعدة بيانات محلية اختبر ترحيل نسخة سبق استخدامها بدل اختبار تثبيت جديد فقط. يقدم README شارة MIT، لكن افحص ملف الترخيص نفسه وحقوق المحتوى والخطوط قبل إعادة التوزيع. الأوامر أدناه تبدأ المراجعة ولا تنفذ تهيئة حساباتك أو تضمن بناء جميع الميزات تلقائيًا.

أوامر بدء مراجعة المصدر

هذه أوامر مقترحة لنسخة محلية مستقلة؛ راجع README وpubspec وإعداد المنصة قبل التشغيل. نجاح تنزيل المصدر لا يعني أن بناءه أو خدماته قد اختبرت على كل إصدار حديث.

git clone https://github.com/moatasem-alhilali/qurani-master.git
cd qurani-master
flutter --version
flutter pub get
flutter analyze
flutter run

المصدر ومراجع التنفيذ

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع