تفعيل الإشعارات في iOS عبر الشهادات والمفاتيح ودمجها مع Firebase
الإشعارات (Push Notifications) تعتبر واحدة من أهم الأدوات التي تُبقي المستخدمين متفاعلين مع التطبيقات. فهي تُمكّن المطور من إرسال رسائل آنية مثل التنبيهات، العروض الترويجية، أو التحديثات المهمة مباشرةً إلى جهاز المستخدم حتى لو كان التطبيق مغلقًا.
بالنسبة لمطوري iOS، تعتمد هذه الميزة على خدمة تسمى Apple Push Notification service (APNs). ولكي يعمل التطبيق مع APNs، لا بد من تهيئة شهادة أو مفتاح مصادقة (Auth Key) من خلال حساب Apple Developer.
في هذا المقال سنتعرف على خطوات توليد APNs Certificate أو APNs Auth Key، وكيفية دمجه مع منصات مثل Firebase أو مع سيرفر مخصص لإرسال الإشعارات
ما هو APNs؟
APNs (Apple Push Notification service) هو بروتوكول من آبل يُتيح للتطبيقات استلام إشعارات من السيرفر. الفكرة كالتالي:
- التطبيق يسجل نفسه للحصول على Device Token.
- يرسل هذا التوكن إلى السيرفر أو Firebase.
- السيرفر يستخدم شهادة أو مفتاح APNs لإرسال رسالة إلى جهاز معين.
- APNs تقوم بتسليم الرسالة إلى iPhone أو iPad.
- بدون شهادة أو مفتاح APNs لن تتمكن من ربط تطبيقك بالخدمة.
الخيارات المتاحة لتوليد APNs
- عند تفعيل الإشعارات في iOS لديك خيارين أساسيين:
- APNs Certificate (شهادة APNs):
- ملف بامتداد .p12 أو .cer.
- صالح عادة لمدة سنة واحدة.
- يتطلب تجديدًا دوريًا وإعادة تحميله على السيرفر أو Firebase.
APNs Auth Key (مفتاح مصادقة):
ملف بامتداد .p8.
يُنشأ مرة واحدة فقط.
يمكن استخدامه مع جميع تطبيقاتك (تحت نفس حساب Apple Developer).
يُنصح به لأنه أكثر مرونة وأسهل في الإدارة.
تفعيل Push Notifications في Xcode
افتح مشروعك في Xcode.
اختر TARGETS → Signing & Capabilities.
اضغط على زر + Capability.
أضف Push Notifications.
أضف أيضًا Background Modes وحدد خيار Remote Notifications.
بهذا تكون قد فعّلت الإعدادات الأولية داخل التطبيق.
توليد APNs Auth Key
تسجيل الدخول لحساب Apple Developer
ادخل إلى Apple Developer → Keys
اختر Apple Push Notifications service (APNs).
أعط المفتاح اسمًا مميزًا
اضغط Continue → Register.
تحميل ملف المفتاح
بعد الإنشاء حمّل الملف .p8.
انتبه: يمكنك تحميله مرة واحدة فقط، لذا احتفظ به بأمان
حفظ القيم المطلوبة
Key ID: يظهر بجانب المفتاح.
Team ID: موجود في إعدادات حساب Apple Developer.
Auth Key (.p8): الملف الذي حمّلته.
هذه القيم الثلاثة ضرورية لربط Firebase أو سيرفرك مع APNs..
دمج APNs مع Firebase
إذا كنت تستخدم Firebase لإرسال إشعارات (FCM):
ادخل إلى Firebase Console.
افتح Project Settings → Cloud Messaging.
تحت iOS App Configuration:
إذا كان لديك شهادة: ارفع ملف .p12.
إذا كان لديك مفتاح .p8: ارفع الملف وأدخل Key ID و Team ID.
احفظ التغييرات.
الآن Firebase أصبح متصلًا بـ APNs، ويمكنك إرسال الإشعارات إلى أجهزة iOS.
ملاحظه : يجب رفع الشهاده في كلا الموقعين في الصوره توجد بالاسفل فقط قم باضافه No development APNs auth key ايضا
