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

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

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

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

المتطلبات

• حساب Pushwoosh.
• مشروع Pushwoosh تم إعداده في حسابك.
• لتكامل iOS:
  • منصة iOS مهيأة لإرسال إشعارات الدفع. نوصي باستخدام إعداد المصادقة المستندة إلى الرمز المميز (Token-Based Authentication) كأبسط طريقة.
  • أثناء الإعداد، قم بتعيين Gateway إلى Sandbox لإرسال الإشعارات إلى جهاز محاكاة.
• لتكامل Android:
  • منصة Android مهيأة
  • project number (المعروف أيضًا باسم Sender ID)، وملف google-services.json، وpackage name من مشروع Firebase الخاص بك.
  • مشروع Firebase متصل بتطبيق Android الخاص بك. اتبع دليل إعداد Firebase إذا لزم الأمر.
• Pushwoosh Application Code الخاص بك و Pushwoosh Device API Token من لوحة تحكم Pushwoosh لتطبيقك.

تنزيل المشروع النموذجي

# استنساخ مستودع SDK والانتقال إلى المشروع النموذجي
git clone https://github.com/Pushwoosh/pushwoosh-phonegap-plugin.git

# الانتقال إلى دليل المثال
cd pushwoosh-phonegap-plugin/example/newdemo/

تهيئة المشروع

تثبيت التبعيات:

npm i

إضافة إضافة Pushwoosh:

cordova plugin add ../../ --link --nofetch

افتح www/js/index.js وقم بتحديث استدعاء pushwoosh.onDeviceReady:

pushwoosh.onDeviceReady({
    appid: "XXXXX-XXXXX",
    projectid: "XXXXXXXXXXXXXXX"
});

استبدل قيم appid و projectid بـ Pushwoosh App Code و Firebase Project Number الخاصين بك.

iOS

1. تعيين معرف الحزمة (Bundle Identifier)

افتح ملف platforms/ios/newdemo.xcworkspace في Xcode.

قم بتعيين Bundle Identifier لكل هدف:

• newdemo: اسم حزمة تطبيقك. (مثال: com.example.pushwoosh)

2. إضافة القدرات (capabilities)

لتمكين إشعارات الدفع (Push Notifications)، تحتاج إلى إضافة قدرات معينة.

في قسم Signing & Capabilities، أضف القدرات التالية:

• Push Notifications
• Background Modes. بعد إضافة هذه القدرة، حدد مربع Remote notifications.

3. تعيين رمز API (API Token)

في ملف ios/newdemo/Info.plist الخاص بك، قم بتعيين مفتاح Pushwoosh_API_TOKEN إلى رمز واجهة برمجة تطبيقات جهاز Pushwoosh (Pushwoosh Device API Token)

Android

1. إعداد google-services.json

انسخ ملف google-services.json الخاص بك إلى الدليل الجذر للمشروع

2. تعيين اسم الحزمة

افتح android/app/build.gradle وقم بتعيين applicationId إلى اسم حزمة تطبيقك. (مثال: com.example.pushwoosh)

3. تعيين رمز API (API Token)

افتح ملف android/app/src/main/AndroidManifest.xml الخاص بك وأضف البيانات الوصفية التالية داخل وسم <application>:

AndroidManifest.xml

<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />

استبدل __YOUR_PUSHWOOSH_DEVICE_API_TOKEN__ بـ رمز واجهة برمجة تطبيقات جهاز Pushwoosh (Pushwoosh Device API Token) الخاص بك.

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

1. بناء وتشغيل المشروع.
2. قم بتبديل مفتاح Register for notifications.
3. امنح الإذن لإشعارات الدفع. سيتم تسجيل الجهاز مع Pushwoosh.

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

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