Understand Some Important Concepts of Push a Notification
We shall discuss all the concepts mentioned below step by step,
- Creating a basic notification
- Creating notification channel
- Adding large icon
- Making notification expandable
- Making notification clickable
- Adding an action button to our notification
1. Creating a basic notification
To create a basic notification at first we need to build a notification. Now to build notification, we must use NotificationCompat.Builder() class where we need to pass a context of activity and a channel id as an argument while making an instance of the class. Please note here we are not using Notification.Builder(). NotificationCompat gives compatibility to upper versions (Android 8.0 and above) with lower versions (below Android 8.0).
Kotlin
val nBuilder = NotificationCompat.Builder( this ,CHANNEL_ID) .setContentTitle(et1.text.toString()) .setContentText(et2.text.toString()) .setSmallIcon(R.drawable.spp_notification_foreground) .setPriority(NotificationCompat.PRIORITY_DEFAULT) .build() |
Please note, here we need to set the priority of the notification accordingly by the setPriority() method.
Now to deliver the notification we need an object of NotificationManagerCompat class and then we notify it.
Kotlin
val nManager = NotificationManagerCompat.from( this ) // Here we need to set an unique id for each // notification and the notification Builder nManager.notify( 1 , nBuilder) |
Please note that, in this method, we can deliver notification only in the android versions below 8.0 but in the android versions 8.0 and upper, no notification will appear by only this block of code.
2. Creating a notification channel
Now to deliver notifications on android version 8.0 and above versions, we need to create a notification channel. This Notification Channel concept comes from android 8.0. Here every application may have multiple channels for different types of notifications and each channel has some type of notification. Before you can deliver the notification on Android 8.0 and above versions, you must register your app’s notification channel with the system by passing an instance of NotificationChannel to createNotificationChannel().
Kotlin
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { val channel = NotificationChannel(CHANNEL_ID, CHANNEL_NAME, NotificationManager.IMPORTANCE_DEFAULT).apply { description = CHANNEL_DESCRIPTION } val nManager: NotificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager nManager.createNotificationChannel(channel) } |
Please note that here we must provide a unique CHANNEL_ID for each channel and also we must give a CHANNEL_NAME and CHANNEL_DESCRIPTION. Also, we must give channel importance.
3. Adding a large icon
To set a large icon we use the setLargeIcon() method which is applied to the instance of the NotificationCompat.Builder() class. In this method, we need to pass a Bitmap form of an image. Now to convert an image file (e.g. jpg, jpeg, png, etc.) of the drawable folder into a Bitmap, we use the following code in Kotlin
Kotlin
// converting a jpeg file to Bitmap file and making an instance of Bitmap! val imgBitmap=BitmapFactory.decodeResource(resources,R.drawable.gfg_green) // Building notification val nBuilder= NotificationCompat.Builder( this ,CHANNEL_ID) .setContentTitle(et1.text.toString()) .setContentText(et2.text.toString()) .setSmallIcon(R.drawable.spp_notification_foreground) .setPriority(NotificationCompat.PRIORITY_DEFAULT) // passing the Bitmap object as an argument .setLargeIcon(imgBitmap) .build() |
4. Making notification expandable
In the short template of the notification, large information can’t be shown. Therefore we need to make the notification expandable like this:
to make such an expandable notification we use the setStyle() method on the notification builder (nBuilder) object. In this expanded area we can display an image, any text, different messages, etc. In our Application, we have added an image by passing the instance of the NotificationCompat.BigPictureStyle class to setStyle() method.
Kotlin
val imgBitmap = BitmapFactory.decodeResource(resources,R.drawable.gfg_green) val nBuilder = NotificationCompat.Builder( this ,CHANNEL_ID) .setContentTitle(et1.text.toString()) .setContentText(et2.text.toString()) .setSmallIcon(R.drawable.spp_notification_foreground) .setPriority(NotificationCompat.PRIORITY_DEFAULT) .setLargeIcon(imgBitmap) // Expandable notification .setStyle(NotificationCompat.BigPictureStyle() .bigPicture(imgBitmap) // as we pass null in bigLargeIcon() so the large icon // will goes away when the notification will be expanded. .bigLargeIcon( null )) .build() |
5. Making notification clickable
We need to make our notification clickable to perform some action by clicking the notification such as open an activity or system setting or any webpage etc. Now to perform such actions intent is needed (e.g. explicit or implicit intent). In our Application, we are making an Implicit intent to open the GFG official home page.
Kotlin
// Creating the Implicit Intent to // open the home page of GFG val intent1= Intent() intent1.action=Intent.ACTION_VIEW |
Now it is not necessary that whenever the notification will appear then the user will click it instantly, user can click it whenever he /she wants and therefore we also need to make an instance of PendingIntent which basically makes the intent action pending for future purpose.
Kotlin
val pendingIntent1=PendingIntent.getActivity( this , 5 , intent1, PendingIntent.FLAG_UPDATE_CURRENT) // Here the four parameters are context of activity, // requestCode,Intent and flag of the pendingIntent respectively // The request code is used to trigger a // particular action in application activity val nBuilder = NotificationCompat.Builder( this ,CHANNEL_ID) .setContentTitle(et1.text.toString()) .setContentText(et2.text.toString()) .setSmallIcon(R.drawable.notifications) .setPriority(NotificationCompat.PRIORITY_DEFAULT) .setLargeIcon(imgBitmap) .setStyle(NotificationCompat.BigPictureStyle() .bigPicture(imgBitmap) .bigLargeIcon( null )) // here we are passing the pending intent .setContentIntent(pendingIntent1) // as we set auto cancel true, the notification // will disappear after afret clicking it .setAutoCancel( true ) .build() |
6. Adding an action button to our notification
Sometimes there exists some action button at our notification template that is used to perform some action.
Here we also need an Intent and a PendingIntent. Then we need to pass the instance of the PendingIntent to addAction() method at the time of building the notification.
Kotlin
// Creating the Implicit Intent // to open the GFG contribution page val intent2 = Intent() intent2.action = Intent.ACTION_VIEW val nBuilder = NotificationCompat.Builder( this ,CHANNEL_ID) .setContentTitle(et1.text.toString()) .setContentText(et2.text.toString()) .setSmallIcon(R.drawable.notifications) .setPriority(NotificationCompat.PRIORITY_DEFAULT) .setLargeIcon(imgBitmap) .setStyle(NotificationCompat.BigPictureStyle() .bigPicture(imgBitmap) .bigLargeIcon( null )) .setContentIntent(pendingIntent1) .setAutoCancel( true ) // Here we need to pass 3 arguments which are // icon id, title, pendingIntent respectively // Here we pass 0 as icon id which means no icon .addAction( 0 , "LET CONTRIBUTE" ,pendingIntent2) .build() |
How to Push Notification in Android?
Notification is a message which appears outside of our Application’s normal UI. A notification can appear in different formats and locations such as an icon in the status bar, a more detailed entry in the notification drawer, etc. Through the notification, we can notify users about any important updates, events of our application. By clicking the notification user can open any activity of our application or can do some action like opening any webpage etc.
How Does Notification Look?
Let see the basic design of a notification template that appears in the navigation drawer.
Part of a Notification |
Method for defining contents |
Type of argument needs to pass into the method |
---|---|---|
Small Icon | setSmallIcon() | need to pass a drawable file as an ID that is an Int type. |
App Name | By default, App Name is provided by the System and we can’t override it. | |
Time Stamp | By default, timeStamp is provided by the System but we can override it by setWhen() method. | A Long type of data should be passed. |
Title | setContentTitle() | A String type of data should be passed. |
Text | setContentText() | A String type of data should be passed. |
Large Icon | setLargeIcon() | A Bitmap! type image file data should be passed. |
Contact Us