البدء السريع لـ 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 لتطبيقك.

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

# Clone the SDK repository and navigate to the example project
git clone https://github.com/Pushwoosh/pushwoosh-phonegap-plugin.git

# Navigate to example directory
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"
});

استبدل قيمة appid بـ Pushwoosh App Code الخاص بك.

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 Device API Token

Android

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

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

2. تعيين اسم الحزمة (package name)

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

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

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

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

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