البدء السريع لـ iOS SDK

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

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

لدمج 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: 6.7.13
[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 و أرسل إشعار دفع إلى جهازك المسجل.

ماذا بعد

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