البدء السريع باستخدام 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.

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

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

# Navigate to example directory
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 و رقم مشروع Firebase الخاصين بك.

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

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

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

إرسال إشعار Push

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