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

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

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

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

<TranslatedFragment id="prerequisites-plugins" />

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

استنسخ مستودع SDK:
```bash
git clone https://github.com/Pushwoosh/pushwoosh-capacitor-plugin.git
```

انتقل إلى دليل المكون الإضافي:
```bash
cd pushwoosh-capacitor-plugin
```

## بناء المكون الإضافي

قبل تشغيل التطبيق التجريبي، تحتاج إلى بناء المكون الإضافي Capacitor.
ثبّت تبعيات المكون الإضافي:
```bash
npm i
```

ابنِ المكون الإضافي:
```bash
npm run build
```

## تكوين التطبيق التجريبي

انتقل إلى دليل التطبيق التجريبي:

```bash
cd example
```

ثبّت تبعيات التطبيق:

```bash
npm i
```

ابنِ أصول الويب:

```bash
npm run build
```

افتح **src/js/example.js** وقم بتحديث استدعاء `Pushwoosh.onDeviceReady`:

```javascript
Pushwoosh.onDeviceReady({
    appid: "__YOUR_APP_CODE__"
});
```

حيث:

`__YOUR_APP_CODE__` هو رمز التطبيق من لوحة تحكم Pushwoosh.

### iOS

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

انتقل إلى دليل منصة iOS وقم بتثبيت تبعيات CocoaPods:
```bash
cd ios/App
pod install --repo-update
cd ../..
```

###### 2. مزامنة Capacitor مع iOS

بعد تثبيت CocoaPods، قم بمزامنة تكوين Capacitor:

```bash
npx cap sync ios
```

###### 3. فتح مشروع iOS

افتح المشروع في Xcode:

```bash
npx cap open ios
```

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

في Xcode، قم بتعيين **Bundle Identifier** إلى اسم حزمة تطبيقك (على سبيل المثال، `com.example.pushwoosh`).

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

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

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

###### 6. تعيين رمز API

افتح `ios/App/App/Info.plist` في Xcode وأضف الإدخال التالي مع [رمز API لجهاز Pushwoosh](/ar/developer/api-reference/api-access-token/#device-api-token):

```xml title="Info.plist"
<key>Pushwoosh_API_TOKEN</key>
<string>__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__</string>
```

### Android

###### 1. مزامنة Capacitor مع Android

قم بمزامنة تكوين Capacitor مع منصة Android:

```bash
npx cap sync android
```

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

انسخ ملف `google-services.json` الخاص بك إلى دليل **android/app**.

###### 3. تعيين اسم الحزمة

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

###### 4. تعيين رمز 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__` بـ [رمز API لجهاز Pushwoosh](/ar/developer/api-reference/api-access-token/#device-api-token).

###### 5. فتح مشروع Android

افتح المشروع في Android Studio:

```bash
npx cap open android
```

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

1. ابنِ وشغّل المشروع.
2. اضغط على زر **"Click Me!"**.
3. امنح الإذن للإشعارات الفورية. سيتم تسجيل الجهاز في Pushwoosh.

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

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