البدء السريع لـ Flutter SDK

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

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

لدمج Pushwoosh Flutter 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-flutter

# الانتقال إلى دليل المثال
cd pushwoosh-flutter/Source/pushwoosh/example

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

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

flutter pub get

افتح lib/main.dart وقم بتحديث استدعاء Pushwoosh.initialize:

Pushwoosh.initialize({"app_id": "XXXXX-XXXXX", "sender_id": "XXXXXXXXXXXX"});

استبدل قيم app_id و 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)
• StopwatchWidgetExtension: اسم حزمة تطبيقك مع .StopwatchWidget (مثال: com.example.pushwoosh.StopwatchWidget)

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. تعيين اسم الحزمة

افتح 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 Pushes.
4. امنح الإذن لإشعارات الدفع. سيتم تسجيل الجهاز مع Pushwoosh.

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

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