دليل تجربة نُور آلْعُلى على الآيفون — Mac وحساب Apple مجاني
========================================================

هذه حزمة تجهيز وليست ملف IPA موقّعًا. لا تُفتح على الآيفون مباشرة.
تحتوي واجهة التطبيق وألوانه وصوره والقرآن كاملًا ومجموعة الأحاديث المحلية.
لا تحتوي موقع الشركة، ولا تستبدل تطبيق أندرويد.

قبل البدء
---------
1. استخدم جهاز Mac، مع اتصال بالإنترنت وكابل يوصل الآيفون بالجهاز.
2. حدّث macOS إذا احتاج Xcode لذلك.
3. افتح App Store على Mac وابحث عن Xcode، ثم ثبّته. حجمه كبير؛ انتظر اكتمال التثبيت.
4. افتح Xcode مرة واحدة، وافق على الشروط وثبّت الإضافات التي يطلبها.
5. من Xcode افتح Settings ثم Accounts واضغط + وأضف حساب Apple الخاص بك.
   لا ترسل كلمة المرور لأي شخص. الحساب المجاني يظهر باسم Personal Team.
6. ثبّت Node.js من https://nodejs.org واختر إصدار LTS.

فتح الحزمة
----------
1. فك ضغط الملف على Mac. افتح المجلد Nour-iOS-Trial.
2. ستجد داخل المجلد مشروعًا اسمه ios، والملفات المحلية داخل www.
3. افتح Terminal من Applications ثم Utilities.
4. اكتب cd ثم مسافة، واسحب مجلد Nour-iOS-Trial إلى نافذة Terminal.
   اضغط Enter. السحب يكتب مكان المجلد دون الحاجة إلى نسخه يدويًا.
5. اكتب هذا الأمر واضغط Enter، ثم انتظر انتهاء تنزيل الأدوات:

   npm install

6. اكتب:

   npx cap sync ios

7. ثم اكتب:

   npx cap open ios

   سيفتح مشروع الآيفون في Xcode. إذا ظهرت رسالة خطأ انسخها وأرسلها لي.

التثبيت على هاتفك
----------------
1. صِل الآيفون بالكابل، افتح قفل الهاتف، واضغط «الوثوق» إذا ظهرت رسالة الوثوق بالكمبيوتر.
2. في Xcode اختر المشروع App من العمود الأيسر، ثم TARGETS واختر App.
3. افتح Signing & Capabilities.
4. فعّل Automatically manage signing.
5. عند Team اختر اسم حسابك الذي يحمل Personal Team.
6. إذا ظهر أن Bundle Identifier غير متاح، غيّره إلى اسم فريد، مثل:
   com.abdelaalimennaai.nour.trial
   لا تغيّر اسم الشركة أو الاسم الظاهر على الهاتف؛ هذا المعرّف فقط لمنع التعارض.
7. اختر هاتفك من قائمة الأجهزة أعلى Xcode بدل أي Simulator.
8. اضغط زر التشغيل ▶ أعلى النافذة. أول تجهيز قد يستغرق عدة دقائق.
9. في iOS 16 أو أحدث، إذا طلب الهاتف Developer Mode:
   الإعدادات ← الخصوصية والأمان ← نمط المطوّر، فعّله واتبع تعليمات إعادة التشغيل.
   قد لا يظهر الخيار قبل توصيل الهاتف ومحاولة تشغيل المشروع في Xcode.
10. إذا طلب الوثوق بالمطوّر:
    الإعدادات ← عام ← VPN وإدارة الجهاز ← حسابك ← الوثوق.
11. افتح نُور آلْعُلى على الآيفون، ثم جرّب الشاشات التالية.

مهم جدًا: مدة الحساب المجاني
----------------------------
Apple تمنح توقيع التجربة الشخصية لمدة سبعة أيام. بعد انتهاء المدة أعد توصيل الهاتف
بالـ Mac وشغّل المشروع من Xcode مجددًا. لا تحذف التطبيق قبل ذلك حتى لا تفقد بياناتك.
صدّر نسخة احتياطية من داخل التطبيق قبل أي حذف أو تغيير المعرّف.
الحساب المجاني ليس للنشر أو التوزيع على الناس ولا يدعم TestFlight.
النشر في App Store لاحقًا يحتاج الاشتراك في برنامج مطوّري Apple ومراجعة التطبيق.

ما يعمل في هذه التجربة وما يحتاج اختبارًا
----------------------------------------
• القرآن والأحاديث والهوية والصور والخطوط مضمّنة محليًا.
• مواقيت الصلاة تُحسب محليًا حسب المدينة والمنطقة الزمنية والتصحيحات المحفوظة.
• التقويم الهجري/الميلادي والأرقام العربية/الغربية مستقلّان، مع اللغات الخمس الموجودة.
• الإعدادات والتقدم الشخصي محليان. لا تُنقل بيانات أندرويد تلقائيًا؛ استخدم نسخة احتياطية.
• التفسير والبث واختيار القرّاء والإدارة السحابية تحتاج الإنترنت.
• عند إغلاق التطبيق، التنبيه المحلي يستخدم صوت النظام وليس الأذان كاملًا؛ قد يمنعه الصامت أو التركيز.
• Apple تحد عدد التنبيهات المجدولة؛ هذه التجربة تجدول أقرب 60 تنبيهًا،
  بما فيها التذكيرات السابقة للصلاة، وتتجدد عند فتح التطبيق. افتحه يوميًا.
• تشغيل الصوت داخل التطبيق موجود؛ استمرار التلاوة بعد قفل الشاشة وويدجت شاشة الهاتف
  ليسا مجهزين في هذه التجربة الأولى. لا تعتبرهما منجزين قبل إضافة دعم أصلي واختباره.
• زر التحديث لا ينزّل APK على الآيفون؛ التحديث التجريبي عبر Xcode.
• الدخول المخفي للمدير ما زال يطلب الحساب والدور المعتمد؛ الضغط خمس مرات لا يمنح صلاحيات.
• نشر الإصدارات والإشعارات الجماعية وإدارة موقع الشركة غير متاحة من هذه التجربة؛
  استخدم نسخة الويب لهذه العمليات. يجب اختبار الدخول وتعديل المحتوى على الهاتف.

اختبار سريع على هاتفك
---------------------
1. افتح القرآن واختر الفاتحة ثم البقرة، وتحقق من ظهور النص.
2. فعّل وضع الطيران، ثم افتح سورة أخرى وحديثًا ومواقيت الصلاة.
3. غيّر المدينة إلى مدينتك، وتحقق من جدول الجهة الرسمية قبل الاعتماد على التنبيهات.
4. غيّر نوع التاريخ ونوع الأرقام ثم أغلق وافتح التطبيق للتحقق من حفظ الإعدادات.
5. من جاهزية الأذان فعّل الإشعارات، ثم اضغط تجربة إشعار وغادر التطبيق؛ انتظر خمس ثوانٍ.
6. جرّب الخط وحجم الكتابة والواجهة مع لوحة المفاتيح ومع قفل الشاشة.
7. جرّب النسخ الاحتياطي والاستعادة دون حذف التطبيق.

التحقق المنجز هنا
----------------
تم فحص الملفات المحلية وتشغيل الواجهة المجمّعة واختبار قواعد جدولة التنبيهات.
لا يتوفر Mac أو آيفون في بيئة التجهيز الحالية؛ لم يتم تشغيل Xcode أو توقيع المشروع
أو اختبار أذونات وصوت الجهاز فعليًا. إتمام التثبيت والتحقق من هذه النقاط يتم على جهازك.

مراجع Apple الرسمية
-------------------
https://developer.apple.com/support/compare-memberships/
https://developer.apple.com/documentation/xcode/running-your-app-in-simulator-or-on-a-device
https://developer.apple.com/documentation/usernotifications