دليل البدء السريع لـ React Native SDK

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

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

لدمج Pushwoosh React Native 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-react-native-plugin.git

# انتقل إلى دليل المثال
cd pushwoosh-react-native-plugin/example/demoapp/

تكوين المشروع

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

npm install

افتح Settings.js وقم بتحديث استدعاء Pushwoosh.init:

Pushwoosh.init({ "pw_appid" : "__YOUR_APP_ID__" });

استبدل __YOUR_APP_ID__ بـ رمز تطبيق Pushwoosh الخاص بك.

iOS

1. تثبيت التبعيات

انتقل إلى دليل ios وقم بتثبيت التبعيات:

cd ios && pod install --repo-update

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

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

قم بتعيين معرف الحزمة (Bundle Identifier) لكل هدف:

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

3. تعيين رمز API

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

Android

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

انسخ ملف google-services.json الخاص بك إلى دليل android/app

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__ بـ رمز Device API الخاص بـ Pushwoosh.

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

1. قم ببناء وتشغيل المشروع.
2. سيحتوي التطبيق على علامتي تبويب: “Actions” و “Settings”. انتقل إلى علامة التبويب Settings.
3. اضغط على زر Register for Push Notifications.
4. امنح الإذن لإشعارات الدفع. سيتم تسجيل الجهاز في Pushwoosh.

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

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