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

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

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

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

Requirements

• A Pushwoosh account
• A Pushwoosh project set up in your account.
• A configured Android platform
• The project number (also known as Sender ID), google-services.json file and package name from your Firebase project.
• Your Pushwoosh Application Code and Pushwoosh Device API Token from the Pushwoosh Control Panel for your application.

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

استنسخ المشروع التجريبي من GitHub:

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 الخاص بك.
   • fcm_sender_id: استخدم رقم مشروع Firebase الخاص بك.
   • pushwoosh_api_token: استخدم رمز API لجهاز Pushwoosh الخاص بك.

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="fcm_sender_id">_YOUR_FIREBASE_PROJECT_ID_</string>
    <string name="pushwoosh_api_token">_YOUR_PUSHWOOSH_DEVICE_API_TOKEN_</string>
</resources>

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

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

يجب أن تشاهد إدخال سجل مثل هذا:

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__

إرسال إشعار Push

ارجع إلى لوحة تحكم Pushwoosh وأرسل إشعار Push إلى جهازك المسجل.

الخطوات التالية

لمعرفة المزيد، يرجى الرجوع إلى دليل الدمج الأساسي