انتقل إلى المحتوى
أدلة المستخدمالدعم طلب عرض توضيحي تسجيل الدخول
Pushwoosh.com

دليل التكامل المتقدم لـ iOS SDK 7.0+

يقدم هذا القسم معلومات حول التكامل المتقدم لـ Pushwoosh iOS SDK.

أوضاع الخلفية

Anchor link to

لتمكين هذه الوظيفة، يجب عليك إضافة أوضاع الخلفية (Background Modes) إلى مشروعك.

خطوات تمكين أوضاع الخلفية

Anchor link to
  1. افتح مشروعك في Xcode وحدده في Project Navigator.
  2. اختر هدف تطبيقك من اللوحة اليسرى.
  3. انتقل إلى علامة التبويب Signing & Capabilities.
  4. انقر فوق الزر + Capability في الزاوية العلوية اليسرى.
  5. ابحث عن Background Modes وحددها من القائمة.
  6. في قسم Background Modes، قم بتمكين Remote notifications عن طريق تحديد المربع.

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

أوضاع المقدمة

Anchor link to

بشكل افتراضي، يعرض Pushwoosh iOS SDK لافتة الإشعار عندما يكون التطبيق قيد التشغيل في المقدمة.

يمكنك التحكم في هذا السلوك عن طريق تعيين العلامة المنطقية التالية في الكود الخاص بك (على سبيل المثال، في AppDelegate الخاص بك):

// قم بالتعيين إلى false لتعطيل إشعارات المقدمة، وإلى true لتمكينها
Pushwoosh.configure.showPushnotificationAlert = true
مثال (Swift)

مستوى السجل

Anchor link to

يدعم Pushwoosh iOS SDK مستويات التسجيل التالية:

  • NONE - لا توجد سجلات من SDK.
  • ERROR - يعرض رسائل الخطأ فقط في وحدة التحكم.
  • WARNING - يعرض التحذيرات بالإضافة إلى الأخطاء.
  • INFO - يتضمن رسائل إعلامية (الإعداد الافتراضي).
  • DEBUG - يتضمن معلومات تصحيح أخطاء مفصلة.

بشكل افتراضي، يتم تعيين مستوى التسجيل على INFO، مما يضمن أن SDK يوفر معلومات ذات صلة دون ازدحام وحدة تحكم المطور.

لتعديل مستوى التسجيل، قم بتحديث مفتاح Pushwoosh_LOG_LEVEL في ملف Info.plist الخاص بتطبيقك:

<key>Pushwoosh_LOG_LEVEL</key>
<string>YOUR_LOG_LEVEL</string>

بدلاً من ذلك، يمكنك تغيير مستوى السجل باستخدام مقتطف الكود أدناه:

Pushwoosh.Debug.setLogLevel(.PW_LL_DEBUG)

استبدل YOUR_LOG_LEVEL بالمستوى المطلوب (على سبيل المثال، DEBUG أو ERROR).

UNNotificationCenterDelegate المخصص

Anchor link to

إذا كنت ترغب في استخدام UNNotificationCenterDelegate الخاص بك (على سبيل المثال، للإشعارات المحلية)، يجب عليك إبلاغ Pushwoosh SDK بذلك للسلوك الصحيح. يمكنك القيام بذلك باستخدام خاصية notificationCenterDelegateProxy لمثيل Pushwoosh:

Pushwoosh.configure?.notificationCenterDelegateProxy.add(my_delegate)
مثال (Swift)

بعد ذلك، قم بتنفيذ دوال UNNotificationCenterDelegate في المفوّض الخاص بك:

func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    willPresent notification: UNNotification,
    withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void
) {
    if (!PWMessage.isPushwooshMessage(notification.request.content.userInfo)) {
        // تعامل مع إشعارك
        completionHandler(UNNotificationPresentationOptions.alert)
    }
}


func userNotificationCenter(
    _ center: UNUserNotificationCenter,
    didReceive response: UNNotificationResponse,
    withCompletionHandler completionHandler: @escaping () -> Void
) {
    if (!PWMessage.isPushwooshMessage(response.notification.request.content.userInfo)) {
        // تعامل مع إشعارك
        completionHandler()
    }
}
مثال (Swift)

التهيئة الكسولة لـ Pushwoosh

Anchor link to

تمنع علامة Pushwoosh_LAZY_INITIALIZATION التهيئة التلقائية لـ Pushwoosh SDK عند بدء تشغيل التطبيق. وهذا يسمح بمزيد من التحكم في وقت بدء خدمات Pushwoosh SDK.

عند تمكين هذه العلامة، لا يبدأ Pushwoosh SDK خدماته حتى يتم استدعاء دوال Pushwoosh iOS SDK بشكل صريح.

أضف الإدخال التالي إلى Info.plist:

<key>Pushwoosh_LAZY_INITIALIZATION</key>
<true/>

حالات الاستخدام

  1. تهيئة SDK المتحكم بها – تسمح علامة Pushwoosh_LAZY_INITIALIZATION بتأخير بدء تشغيل Pushwoosh SDK، مما يمنح مزيدًا من التحكم في وقت تنشيط خدمات الإشعارات الفورية.

  2. تفعيل الإشعارات المؤجل – في بعض التطبيقات، يجب تهيئة الإشعارات الفورية فقط في ظل ظروف محددة. يضمن تمكين هذه العلامة أن يبدأ Pushwoosh SDK فقط عند الطلب الصريح.

  3. تكوين الإشعارات الخاص بالمستخدم – قد تتطلب بعض التطبيقات تخصيص إعدادات الإشعارات الفورية بناءً على تفضيلات المستخدم أو إعدادات الحساب. مع التهيئة الكسولة، يبدأ Pushwoosh SDK فقط بعد تحديد التكوين المناسب.

القائمة الكاملة لخصائص Info.plist

Anchor link to
الخاصيةالوصفالقيم الممكنة
Pushwoosh_APPIDيضبط معرّف تطبيق Pushwoosh لإصدار الإنتاج.XXXXX-XXXXX
النوع: String
Pushwoosh_APPID_Devيضبط معرّف تطبيق Pushwoosh لإصدار التطوير.XXXXX-XXXXX
النوع: String
Pushwoosh_SHOW_ALERTيعرض تنبيه الإشعار في المقدمة.YES (افتراضي) / NO
النوع: Boolean
Pushwoosh_ALERT_TYPEيضبط نمط تنبيه الإشعار.BANNER (افتراضي) / ALERT / NONE
النوع: String
Pushwoosh_BASEURLيتجاوز عنوان URL الأساسي لخادم Pushwoosh.https://cp.pushwoosh.com/json/1.3/ (افتراضي)
النوع: String
Pushwoosh_AUTO_ACCEPT_DEEP_LINK_FOR_SILENT_PUSHإذا كانت YES، فسيتم معالجة الروابط العميقة (Deep Links) المستلمة في الإشعارات الصامتة تلقائيًا.YES (افتراضي) / NO
النوع: Boolean
Pushwoosh_ALLOW_SERVER_COMMUNICATIONيسمح لـ SDK بإرسال طلبات الشبكة إلى خوادم Pushwoosh.YES (افتراضي) / NO
النوع: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_DATAيسمح لـ SDK بجمع وإرسال بيانات الجهاز (إصدار نظام التشغيل، اللغة، والطراز) إلى الخادم.YES (افتراضي) / NO
النوع: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_OS_VERSIONيسمح لـ SDK بجمع وإرسال إصدار نظام تشغيل الجهاز إلى الخادم.YES (افتراضي) / NO
النوع: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_LOCALEيسمح لـ SDK بجمع وإرسال لغة الجهاز إلى الخادم.YES (افتراضي) / NO
النوع: Boolean
Pushwoosh_ALLOW_COLLECTING_DEVICE_MODELيسمح لـ SDK بجمع وإرسال طراز الجهاز إلى الخادم.YES (افتراضي) / NO
النوع: Boolean
Pushwoosh_LOG_LEVELمستوى تسجيل Pushwoosh SDK. لمزيد من التفاصيل، راجع التحكم في مستوى السجل.NONE / ERROR / WARNING / INFO (افتراضي) / DEBUG / VERBOSE
النوع: String
Pushwoosh_PURCHASE_TRACKING_ENABLEDيسمح لـ SDK بتتبع عمليات الشراء داخل التطبيق. مطلوب لـ Customer Journey Builder.YES / NO (افتراضي)
النوع: Boolean