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

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

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

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

<TranslatedFragment id="prerequisites-plugins" />

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

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

# Navigate to example directory
cd pushwoosh-phonegap-plugin/example/newdemo/
```

## تهيئة المشروع

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

```bash
npm i
```

إضافة إضافة Pushwoosh:
```bash
cordova plugin add ../../ --link --nofetch
```

افتح **www/js/index.js** وقم بتحديث استدعاء `pushwoosh.onDeviceReady`:

```javascript
pushwoosh.onDeviceReady({
    appid: "XXXXX-XXXXX"
});
```

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

### iOS

###### 1. تعيين معرف الحزمة (Bundle Identifier)

افتح ملف **platforms/ios/newdemo.xcworkspace** في Xcode.

قم بتعيين **Bundle Identifier** لكل هدف:

- `newdemo`: اسم حزمة تطبيقك. (مثال: com.example.pushwoosh)

###### 2. إضافة القدرات (Capabilities)

لتمكين الإشعارات الفورية (Push Notifications)، تحتاج إلى إضافة قدرات معينة.

في قسم Signing & Capabilities، أضف القدرات التالية:
- `Push Notifications`
- `Background Modes`. بعد إضافة هذه القدرة، حدد مربع `Remote notifications`.

###### 3. تعيين رمز API (API Token)

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

### Android

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

انسخ ملف `google-services.json` الخاص بك إلى الدليل الجذر للمشروع

###### 2. تعيين اسم الحزمة (package name)

افتح **android/app/build.gradle** وقم بتعيين **applicationId** إلى اسم حزمة تطبيقك. (مثال: `com.example.pushwoosh`)

###### 3. تعيين رمز API (API Token)

افتح ملف **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 Token](/ar/developer/api-reference/api-access-token/#device-api-token) الخاص بك.

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

1. قم ببناء وتشغيل المشروع.
2. قم بتبديل مفتاح **Register for notifications**.
3. امنح الإذن للإشعارات الفورية. سيتم تسجيل الجهاز مع Pushwoosh.

## إرسال إشعار فوري

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