إعداد الشارات

بدءًا من الإصدار 6.4.0 من Pushwoosh iOS SDK، تغيرت عملية إدارة وإعداد الشارات من خلال الإشعارات الفورية.

إذا كنت تستخدم سابقًا رقم الشارات للإشارة إلى عدد الإشعارات الفورية المستلمة في تطبيقك، فيجب عليك الترحيل إلى إصدار أحدث من iOS SDK (6.4.0 أو أحدث). سيتم دعم الإصدارات القديمة حتى نهاية الربع الثاني من عام 2022.

ما الذي يحدد قيمة الشارة

تأتي الشارة دائمًا من الإشعار الفوري نفسه. لا توجد ميزة في Pushwoosh تقوم بتعيينها أو مسحها من تلقاء نفسها. إرسال "ios_badges" في طلب /createMessage (أو حقل badges في لوحة التحكم) يعين كل من aps.badge (القيمة المطلقة) و aps.pw_badge (الدلتا النسبية) في حمولة iOS. يحمل Android القيمة المكافئة في pw_badges ويحتاج إلى وحدة com.pushwoosh:pushwoosh-badge لتطبيقها على المشغلات المدعومة. حفظ إشعار فوري في صندوق الرسائل الواردة لا يعين أو يغير الشارة أبدًا. هذان تأثيران مستقلان لنفس الإشعار الفوري.

كيفية إعداد الشارات

لإعداد الشارات، اتبع الخطوات التالية:

أضف ملحق خدمة الإشعارات (Notification Service Extension) (File -> New -> Target…)

حدد “Notification Service Extension”

استبدل فئة NotificationService التي تم إنشاؤها بفئة فرعية من PushwooshNotificationServiceExtension. يتولى Pushwoosh عد الشارات، وحدث التسليم، وتنزيل المرفقات، والرجوع إلى الوضع الافتراضي عند انتهاء المهلة نيابة عنك:

Swift
Objective-C

import PushwooshFramework

class NotificationService: PushwooshNotificationServiceExtension {}

#import <PushwooshFramework/PushwooshFramework.h>

@interface NotificationService : PushwooshNotificationServiceExtension
@end

@implementation NotificationService
@end

أضف إمكانية مجموعات التطبيقات (App Groups) إلى كلا الهدفين — التطبيق الرئيسي وملحق خدمة الإشعارات — واستخدم نفس مجموعة التطبيقات لكل منهما.
أضف معرف مجموعة التطبيقات (App Group ID) إلى info.plist للتطبيق الرئيسي:

<key>PW_APP_GROUPS_NAME</key>
<string>group.com.example.demoapp_example</string>

يرث الملحق هذه القيمة من التطبيق المضيف، لذلك لا تحتاج إلى تكرارها في info.plist الخاص بالملحق — أضفها هناك فقط لتجاوز قيمة المضيف.

إذا كنت تفضل عدم استخدام ملف info.plist، فقم بتوفير مجموعة التطبيقات في الكود عن طريق تجاوز pushwooshAppGroupsName في فئة NotificationServiceExtension الخاصة بك:

Swift
Objective-C

override func pushwooshAppGroupsName() -> String? {
    "group.com.example.demoapp_example"
}

- (NSString *)pushwooshAppGroupsName {
    return @"group.com.example.demoapp_example";
}

مثال

إرسال إشعار فوري مع شارات

إذا كنت ترغب في إرسال إشعار فوري مع شارات من لوحة تحكم Pushwoosh، فما عليك سوى إضافة قيمة الشارة المطلوبة إلى حقل نص badges كما هو موضح في الصورة أدناه:

شاركنا ملاحظاتك

تساعدنا ملاحظاتك في إنشاء تجربة أفضل، لذلك نود أن نسمع منك إذا كان لديك أي مشاكل أثناء عملية تكامل SDK. إذا واجهت أي صعوبات، فلا تتردد في مشاركة أفكارك معنا عبر هذا النموذج.