البدء السريع باستخدام React Native SDK

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

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

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

Requirements

• A Pushwoosh account.
• A Pushwoosh project set up in your account.
• For iOS integration:
  • An iOS platform configured to send push notifications. We recommend using the Token-Based Authentication configuration as the simplest approach.
  • During setup, set the Gateway to Sandbox to send pushes to a simulator.
• For Android integration:
  • A configured Android platform
  • The project number(also known as Sender ID) , google-services.json file and package name from your Firebase project.
  • A Firebase project connected to your Android application. Follow the Firebase setup guide if needed.
• Your Pushwoosh Application Code and Pushwoosh Device API Token from the Pushwoosh Control Panel for your application.

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

# استنساخ مستودع 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__", "project_number":"__YOUR_FCM_SENDER_ID__"});

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

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 (API Token)

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

Android

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

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

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__ بـ رمز API لجهاز Pushwoosh (Pushwoosh Device API Token) الخاص بك.

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

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

إرسال إشعار Push

ارجع إلى لوحة تحكم Pushwoosh (Pushwoosh Control Panel) و أرسل إشعار Push إلى جهازك المسجل.