إضافة إشعارات في تطبيق Android Studio

مطلبك عام جدا، ويحتاج تخصيصا وتفصيلا لإعطاء اجابة أكثر دقة، ولكن عموما،  لإضافة إشعارات إلى تطبيقك على منصة Android باستخدام Android Studio، يمكنك اتباع الخطوات التالية:

1. قم بإنشاء ملف XML لتصميم شكل الإشعار. يمكنك استخدام عناصر مثل TextView وImageView وغيرها لتخصيص مظهر الإشعار.
2. قم بإنشاء ملف Java للتحكم في سلوك الإشعار. في هذا الملف، يمكنك تحديد عناصر الإشعار مثل النص والصورة وعمليات النقر عليها.
3. في ملف Java الرئيسي لتطبيقك، قم بتهيئة نظام الإشعارات وتكوين القناة الافتراضية للإشعارات. يجب عليك تحديد اسم ووصف للقناة وتعيين الأذونات المناسبة (نتحدث هنا عن جزئية متفرعة جدا، وهي تقنيات الويب سوكيت لتحقيق التخاطب ما بين تطبيق الخادم والعميل في الوقت الفعلي).
4. قم بكتابة الشفرة اللازمة لإظهار الإشعار عند الحدث المناسب، مثل استلام رسالة جديدة أو إكمال مهمة.
5. اختبر التطبيق وتأكد من ظهور الإشعارات بشكل صحيح عند الأحداث المناسبة.

سأوضح لك الخطوات التي أشار إليك بها عدنان:

1- إنشاء ملف XML لتصميم إشعارك، باستخدام عنصر RelativeLayout أو LinearLayout لتحديد تخطيط الإشعار الخاص بك وتضمين العناصر المختلفة مثل الصورة والنص.

مثال:

<!-- notification.xml -->
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <ImageView
        android:id="@+id/notification_icon"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@drawable/notification_icon" />

    <TextView
        android:id="@+id/notification_title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_toRightOf="@id/notification_icon"
        android:text="عنوان الإشعار" />

    <TextView
        android:id="@+id/notification_message"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_below="@id/notification_title"
        android:layout_toRightOf="@id/notification_icon"
        android:text="رسالة الإشعار" />

</RelativeLayout>

2- في فئة النشاط (Activity) أو الخدمة (Service) التي ترغب في استخدام الإشعار، أنشئ كائنًا من فئة NotificationCompat.Builder لبناء الإشعار.

مثال:

// في الأعلى من الفئة، قم بإضافة استيرادات التالية:
// import androidx.core.app.NotificationCompat;
// import androidx.core.app.NotificationManagerCompat;

public class MyActivity extends AppCompatActivity {
    // ...

    private static final String CHANNEL_ID = "my_channel_id"; // قم بتعيين قيمة فريدة لهذا المعرف

    private void showNotification() {
        // بناء الإشعار
        NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
                .setSmallIcon(R.drawable.notification_icon)
                .setContentTitle("عنوان الإشعار")
                .setContentText("رسالة الإشعار")
                .setPriority(NotificationCompat.PRIORITY_DEFAULT);

        // قم بإنشاء النقرة النائبة (PendingIntent) للتعامل مع نقرة المستخدم على الإشعار (اختياري)
        Intent intent = new Intent(this, MyActivity.class);
        PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, 0);
        builder.setContentIntent(pendingIntent);

        // إنشاء الإشعار
        NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
        notificationManager.notify(notificationId, builder.build());
    }

    // ...

}

3- إنشاء قناة الإشعار (Notification Channel) في طراز الأندرويد الذي يدعم قنوات الإشعارات (Android 8.0 أو أعلى).

مثال:

public class MyApplication extends Application {

    private static final String CHANNEL_ID = "my_channel_id"; // يجب أن يتطابق مع القيمة المستخدمة في الخطوة السابقة

    @Override
    public void onCreate() {
        super.onCreate();

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            // إنشاء قناة الإشعار
            CharSequence name = "اسم القناة";
            String description = "وصف القناة";
            int importance = NotificationManager.IMPORTANCE_DEFAULT;
            NotificationChannel channel = new NotificationChannel(CHANNEL_ID, name, importance);
            channel.setDescription(description);

            // تهيئة إعدادات قناة الإشعار
            NotificationManager notificationManager = getSystemService(NotificationManager.class);
            notificationManager.createNotificationChannel(channel);
        }
    }
}

4. تنفيذ دالة showNotification() عند الحاجة لعرض الإشعار.

بمجرد تنفيذ دالة showNotification()، ستقوم ببناء الإشعار وعرضه للمستخدم، وتستطيع استدعاء هذه الدالة من أي مكان في تطبيقك وفي أي سياق مناسب.

مثلاً استدعاء showNotification() عندما يتم اكتشاف حدث جديد في التطبيق، مثل وصول رسالة جديدة أو تحديث مهم، أيضًا استدعائها من داخل خدمة (Service) لعرض إشعارات دورية أو قائمة بالتحديثات الجديدة.

مثال على استدعاء showNotification():

public class MyActivity extends AppCompatActivity {
    // ...

    private void checkForNewMessages() {
        // افحص على وجود رسائل جديدة
        // إذا تم العثور على رسالة جديدة، عرض إشعار
        if (hasNewMessages()) {
            showNotification();
        }
    }

    // ...
}

تأكد من تعيين القيم المناسبة لكائن NotificationCompat.Builder في دالة showNotification() واستخدم الأساليب المناسبة لتخصيص الإشعار حسب احتياجات تطبيقك.

من الهام جدًا أن تتذكر أنه بدءًا من Android 8.0 (API level 26)، يجب عليك إنشاء قناة إشعارات (Notification Channel) وتعيينها لكائن NotificationCompat.Builder حتى يتم عرض الإشعار بنجاح.

وتأكد من استدعاء الدالة createNotificationChannel() في الوقت المناسب، كما تم شرحه في الخطوة 3 في الإجابة السابقة.

يمكن استخدام مكتبات خارجية لتسهيل عملية إضافة الإشعارات في تطبيق Android Studio. واحدة من هذه المكتبات هي Firebase Cloud Messaging (FCM) التي تسمح بإرسال الإشعارات إلى التطبيق من الخادم.

لإضافة دعم FCM في تطبيق Android Studio، يجب إضافة مكتبة Firebase Messaging إلى مشروع التطبيق. بعد ذلك، يمكن إنشاء خادم FCM وتضمينه في التطبيق لإرسال الإشعارات إلى التطبيق.

فيما يلي مثال عن إرسال الإشعارات باستخدام FCM في تطبيق Android Studio:

•  إضافة مكتبة Firebase Messaging إلى مشروع التطبيق عن طريق تعديل ملف `build.gradle` في المستوى التطبيق:

dependencies {
    implementation 'com.google.firebase:firebase-messaging:20.2.4'
}

• إنشاء خادم FCM باستخدام Firebase Console وحفظ مفتاح المشروع الذي تم إنشاؤه.
• إضافة مستلم (Receiver) للاستماع إلى الإشعارات الواردة من FCM وتنفيذ الإجراءات المناسبة لعرض الإشعارات في التطبيق. يمكن القيام بذلك بإنشاء فئة تنفيذ BroadcastReceiver وتحديد الدوال التي تنفذ عند استلام الإشعارات، كما يلي:

public class MyFirebaseMessagingService extends FirebaseMessagingService {
 
    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        super.onMessageReceived(remoteMessage);
 
        // إنشاء كائن من الـ NotificationCompat.Builder
        NotificationCompat.Builder builder = new NotificationCompat.Builder(this, CHANNEL_ID)
                .setSmallIcon(R.drawable.notification_icon)
                .setContentTitle(remoteMessage.getNotification().getTitle())
                .setContentText(remoteMessage.getNotification().getBody())
                .setPriority(NotificationCompat.PRIORITY_DEFAULT);

        // تحديد الفعل الذي يتم تنفيذه عند النقر على الإشعار
        Intent intent = new Intent(this, MainActivity.class);
        intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);
        PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, 0);
        builder.setContentIntent(pendingIntent);

        // عرض الإشعار
        NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
        notificationManager.notify(notificationId, builder.build());
    }
}

• تحديد خصائص الإشعارات المراد إرسالها من الخادم FCM وإرسالها إلى التطبيق باستخدام مفتاح المشروع. يمكن القيام بذلك باستخدام Firebase Console أو استخدام REST API.

يمكنك تخصيص تطبيقك باستخدام هذه المكتبات الخارجية لتسهيل إضافة الإشعارات، وتوفير الوقت والجهد في تطوير التطبيق.

كما يفضل الإطلاع على التوثيق الرسمي من google من هذا الرابط