البدء السريع مع iOS SDK 7.0+

ابدأ باستخدام Pushwoosh iOS SDK مع هذا المثال السريع والبسيط.

ما الجديد في iOS SDK 7.0+

بدءًا من الإصدار 7.0، تم إعادة تصميم Pushwoosh iOS SDK بهيكلية معيارية بالكامل. تم تقسيم SDK الآن إلى وحدات منفصلة: PushwooshFramework، PushwooshCore، PushwooshBridge، و PushwooshLiveActivities مطلوبة للتكامل الأساسي، بينما يمكن إضافة PushwooshForegroundPush، PushwooshVoIP، و PushwooshTVOS اختياريًا بناءً على احتياجاتك.

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

يقدم هذا الإصدار دعمًا أصليًا لـ Swift Package Manager لتسهيل إدارة التبعيات، إلى جانب تحسين التوافق مع Swift عبر جميع الوحدات. تم الآن تضمين التوثيق مباشرة في الأطر الثنائية، بحيث يمكنك الوصول إلى مرجع API وأمثلة الكود مباشرة في Xcode عبر Quick Help ونافذة Developer Documentation. تشمل الميزات الجديدة الدعم الكامل لـ iOS 16+ Live Activities مع تكامل Dynamic Island، وإشعارات الدفع في المقدمة القابلة للتخصيص مع لافتات متحركة وردود فعل لمسية، وقدرات VoIP محسنة، ووحدة tvOS مخصصة لتطبيقات Apple TV.

المتطلبات الأساسية

لتكامل Pushwoosh iOS SDK في تطبيقك، ستحتاج إلى ما يلي:

المتطلبات

• حساب Pushwoosh
• مشروع Pushwoosh تم إعداده في حسابك.
• منصة iOS مهيأة لإرسال الإشعارات الفورية. نوصي باستخدام تهيئة المصادقة المستندة إلى الرمز المميز كأبسط طريقة.
• أثناء الإعداد، قم بتعيين البوابة (Gateway) إلى Sandbox لإرسال الإشعارات الفورية إلى جهاز محاكاة.
• Pushwoosh Application Code الخاص بك و Pushwoosh Device API Token من لوحة تحكم Pushwoosh لتطبيقك.

تنزيل المشروع المثال

استنسخ المشروع المثال من GitHub:

git clone https://github.com/Pushwoosh/pushwoosh-ios-sample.git

تكوين المشروع

1. افتح المشروع في Xcode.

2. أضف https://github.com/Pushwoosh/Pushwoosh-XCFramework كتبعية حزمة Swift (Swift Package Dependency).

3. قم بتعيين معرف الحزمة (bundle identifier) للهدف الرئيسي (PushwooshSampleApp) ليتطابق مع مشروع Pushwoosh الخاص بك (على سبيل المثال، com.pushwoosh.PushwooshSampleApp).

4. استخدم نفس معرف الحزمة (bundle identifier) لهدف NotificationService، مع إلحاق .NotificationService به (على سبيل المثال، com.pushwoosh.PushwooshSampleApp.NotificationService).

5. في Info.plist، قم بتعيين:

   • المفتاح Pushwoosh_APPID إلى رمز تطبيق Pushwoosh (Pushwoosh Application Code)
   • المفتاح Pushwoosh_API_TOKEN إلى رمز واجهة برمجة تطبيقات جهاز Pushwoosh (Pushwoosh Device API Token)

مهم: تأكد من منح الرمز المميز (token) حق الوصول إلى التطبيق الصحيح في لوحة تحكم Pushwoosh الخاصة بك. اعرف المزيد

تشغيل المشروع

1. قم ببناء وتشغيل المشروع.
2. سيحتوي التطبيق على علامتي تبويب: “Actions” و “Settings”. انتقل إلى علامة التبويب Settings.
3. اضغط على زر Register for Pushes.
4. امنح الإذن لإشعارات الدفع. سيتم تسجيل الجهاز مع Pushwoosh.

يجب أن ترى إدخال سجل مثل هذا:

Pushwoosh: Initializing application runtime
[PW] BUNDLE ID: __YOUR_BUNDLE_ID__
[PW] APP CODE: __YOUR_APP_CODE__
[PW] PUSHWOOSH SDK VERSION: 7.0.0
[PW] HWID: __YOUR_HWID__
[PW] PUSH TOKEN: (null)
[PW] [I] -[PWNotificationManagerCompatiOS10] NotificationCenter authorization granted: 1
[PW] [I] -[PWPushNotificationsManagerCommon] Registered for push notifications: __YOUR_PUSH_TOKEN__

جهازك مسجل الآن مع Pushwoosh.

إرسال إشعار دفع

ارجع إلى لوحة تحكم Pushwoosh وأرسل إشعار دفع إلى جهازك المسجل.

الترحيل من SDK 6.x

إذا كنت تقوم بالترقية من إصدار SDK 6.x، فإن التغيير الرئيسي هو كيفية الوصول إلى مثيل Pushwoosh. في الإصدار 7.0+، استخدم Pushwoosh.configure بدلاً من Pushwoosh.sharedInstance():

قبل (6.x):

Pushwoosh.sharedInstance().registerForPushNotifications()
Pushwoosh.sharedInstance().delegate = self

بعد (7.0+):

Pushwoosh.configure.registerForPushNotifications()
Pushwoosh.configure.delegate = self

تظل جميع واجهات برمجة التطبيقات الأخرى كما هي، لذا يتطلب تحديث الكود الخاص بك فقط استبدال sharedInstance() بـ configure في جميع أنحاء مشروعك.

ماذا بعد

لمعرفة المزيد، يرجى الرجوع إلى دليل التكامل الأساسي