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

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

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

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

<TranslatedFragment id="prerequisites-android" />

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

استنسخ المشروع التجريبي من GitHub:
```bash
git clone https://github.com/Pushwoosh/pushwoosh-android-sample
```

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

1. ضع ملف **google-services.json** الخاص بك في دليل pushwoosh-demoapp/app.

2. في ملف **build.gradle** (الوحدة: app)، قم بتحديث `applicationId` ليتطابق مع اسم الحزمة الخاص بك.

3. في **res/values/strings.xml**، استبدل قيم العناصر النائبة بتفاصيلك المحددة:
  - `pushwoosh_app_id`: استخدم رمز تطبيق Pushwoosh الخاص بك.
  - `pushwoosh_api_token`: استخدم [رمز واجهة برمجة تطبيقات جهاز Pushwoosh](/ar/developer/api-reference/api-access-token/#device-api-token) الخاص بك
```xml title="strings.xml"
<resources>
    <string name="app_name">demoapp</string>
    <string name="title_home">Actions</string>
    <string name="title_notifications">Settings</string>
    <string name="pushwoosh_app_id">_YOUR_PUSHWOOSH_APP_ID_</string>
    <string name="pushwoosh_api_token">_YOUR_PUSHWOOSH_DEVICE_API_TOKEN_</string>
</resources>
```

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

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

يجب أن ترى إدخال سجل مثل هذا:
```plaintext title="Logcat"
Log level: INFO
[RequestPermissionHelper] Requesting permissions
Pushwoosh SDK initialized successfully
HWID: __HWID_OF_YOUR_DEVICE__
APP_CODE: __YOUR_PUSHWOOSH_APP_ID__
PUSHWOOSH_SDK_VERSION: __PUSHWOOSH_SDK_VERSION_INSTALLED__
FIREBASE_PROJECT_ID: __YOUR_FIREBASE_PROJECT_ID__
PUSH_TOKEN:
User ID "__USER_ID_OF_THE_DEVICE__" successfully set

[NotificationManager] Registered for push notifications: __DEVICE_PUSH_TOKEN__
```

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

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

## الخطوات التالية
لمعرفة المزيد، يرجى الرجوع إلى [دليل التكامل الأساسي](/ar/developer/pushwoosh-sdk/android-sdk/firebase-integration/integrate-pushwoosh-android-sdk/)