البدء السريع لـ 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

في ملف ios/newdemo/Info.plist الخاص بك، قم بتعيين مفتاح Pushwoosh_API_TOKEN إلى Pushwoosh Device API Token

Android

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

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

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

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

3. تعيين رمز API

افتح ملف 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 Device API Token الخاص بك.

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

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

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

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