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

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

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

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

<TranslatedFragment id="prerequisites-plugins" />

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

```bash
# استنساخ مستودع SDK والانتقال إلى المشروع التجريبي
git clone https://github.com/Pushwoosh/pushwoosh-flutter

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

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

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

```bash
flutter pub get
```

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

```dart
Pushwoosh.initialize({"app_id": "XXXXX-XXXXX"});
```

استبدل قيمة `app_id` بـ **Pushwoosh App Code** الخاص بك.

### iOS

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

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

```bash
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

في ملف `ios/Runner/Info.plist` الخاص بك، قم بتعيين مفتاح `Pushwoosh_API_TOKEN` إلى [رمز Pushwoosh Device API](/ar/developer/api-reference/api-access-token/#device-api-token)



### 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>`:

```xml title="AndroidManifest.xml"
<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />
```
استبدل `__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__` بـ [رمز Pushwoosh Device API](/ar/developer/api-reference/api-access-token/#device-api-token) الخاص بك.


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

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

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

ارجع إلى لوحة تحكم Pushwoosh و [أرسل إشعار دفع](/ar/product/messaging-channels/push-notifications/send-push-notifications/one-time-push) إلى جهازك المسجل.