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

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

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

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

3. تعيين API Token

في ملف ios/Runner/Info.plist الخاص بك، قم بتعيين مفتاح Pushwoosh_API_TOKEN إلى 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 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. سيحتوي التطبيق على علامتي تبويب: “Actions” و “Settings”. انتقل إلى علامة التبويب Settings.
3. اضغط على زر Register for Pushes.
4. امنح الإذن لإشعارات Push. سيتم تسجيل الجهاز في Pushwoosh.

إرسال إشعار Push

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