[Android] Notification 정리

Minjun Kim·2023년 10월 9일

android lecture

Android

목록 보기

45/47

📝 SeSAC의 'JetPack과 Kotlin을 활용한 Android App 개발' 강좌를 정리한 글 입니다.

❓ Notification 이란

상태방에 앱의 정보를 출력하는 것을 알림(Notifiaction) 이라고 한다.
상태바는 시스템에 의해 관리되는 곳
앱이 직접 제어 불가
앱의 상태를 상태바에 출력해 유저에게 무언가의 상황을 알려주는 기능

앱이 자신의 액티비티를 출력하고 있는 상황이면 굳이 알림을 발생할 필요가 없다.
그래서 주력으로 사용하는 것이 Receiver 혹은 Service 이다.

💬 알림 발생 과정

알림은 NotificationManager 의 notify() 함수로 발생
Notification 객체는 NotificationCompat.Builder 에 의해 생성
NotificationChannel 로 NotificationCompat.Builder 생성
NotificationCompat.Builder 가 필요한데 Builder 를 만드는 방법이 API Level 26(Android 8) 버전부터 변경

API 26부터 Channel 개념이 도입되면서 분기 처리를 해주어야 한다.

1. `Mnanger` 가 `notify()` 로 알림을 발생 

2. 이 알림 내용을 `Notification 객체` 가 갖음

3. 이 객체를 `Builder` 가 생성

4. 이 Builder 를 만들 때 `Channel` 개념이 도입됨

💬 NotificationManager

❓ NotificationManager 란

Builder(context: Context!) - API Level 26(Android 8) 이전 버전
Builder(context: Context!, channelId: String!) - API Level 26(Android 8) 부터

API 26 이전에는 그냥 Context 만 주면 알림을 만들 수 있었다.
그런데 채널 개념이이 도입되면서 채널 을 같이 던져 주어야 한다.

❓ NotificationChannel 이란

핸드폰 환경 설정에서 앱에 대한 알림을 제어할 수 있는데, 채널 도입 이전에는 그냥 앱 자체 가 대상이었다. 그런데 앱에서 보내는 알림은 종류가 여러가지다. 그래서 앱에서 보내는 각각의 알림을 제어할 수 있게끔 도입된 개념이 채널 이다.

📓 생성 방법

NotificationChannel(id: String!, name: CharSequence!, importance: Int)

위험도	내용
NotificationManager.IMPORTANCE_HIGH	긴급 상황이며 알림음이 울리며 헤드업으로 표시
NotificationManager.IMPORTANCE_DEFAULT	높은 중요도이며 알림음이 울림
NotificationManager.IMPORTANCE_LOW	중간 중요도이며 알림음이 울리지 않음
NotificationManager.IMPORTANCE_MIN	낮은 중요도이며 알림음이 없고 상태표시줄에 표시되지 않음

🔎 Notification 구성

Notification 은 알림에 출력될 이미지, 문자열 등의 정보를 담는 객체

📝 구성 방법

builder.setSmallIcon(android.R.drawable.ic_notification_overlay)
builder.setWhen(System.currentTimeMillis())
builder.setContentTitle("Content Title")
builder.setContentText("Content Massage")

🧩 실습 예제

❕ 퍼미션 추가

AndroidManifest.kt

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

🎨 액티비티 레이아웃

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
	xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="notification"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

📂 메인 소스 코드

MainActivity.kt

package com.kotdev99.android.c74

class MainActivity : AppCompatActivity() {

	private lateinit var btn: Button

	override fun onCreate(savedInstanceState: Bundle?) {
		super.onCreate(savedInstanceState)
		setContentView(R.layout.activity_main)

		btn = findViewById(R.id.button)
		btn.setOnClickListener {
			initNotification()
		}
	}

	private fun initNotification() {
		val manager = getSystemService(NOTIFICATION_SERVICE) as NotificationManager
		val builder: NotificationCompat.Builder

		// channel 정보 입력
		if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
			val channelId = "one-channel"
			val channelName = "My One Channel"
			val channel = NotificationChannel(
				channelId,
				channelName,
				NotificationManager.IMPORTANCE_HIGH
			)

			// channel 에 주는 정보
			channel.description = "My Channel One Description"	// 환경설정에 출력되는 설명
			channel.setShowBadge(true)
			val uri = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION)
			val audio = AudioAttributes.Builder()
				.setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
				.setUsage(AudioAttributes.USAGE_ALARM)
				.build()
			channel.setSound(uri, audio)
			channel.enableLights(true)			// 알림 시에 빛남 (제공 여부는 기종에 따라 다름)
			channel.lightColor = Color.RED		// 불빛 색상
			channel.enableVibration(true)
			channel.vibrationPattern = longArrayOf(100, 200, 100, 200)

			manager.createNotificationChannel(channel)

			builder = NotificationCompat.Builder(this, channelId)
		} else {
			builder = NotificationCompat.Builder(this)
		}
		builder.setSmallIcon(android.R.drawable.ic_notification_overlay)
		builder.setWhen(System.currentTimeMillis())
		builder.setContentTitle("Title")
		builder.setContentText("message")

		manager.notify(1, builder.build())
	}
}

📲 결과

💬 Notification 구성

📚 터치 이벤트

static fun getActivity(context: Context!, requestCode: Int, intent: Intent!, flags: Int)
: PendingIntent!


static fun getBroadcast(context: Context!, requestCode: Int, intent: Intent!, flags: Int)
: PendingIntent!


static fun getService(context: Context!, requestCode: Int, intent: Intent!, flags: Int)
: PendingIntent!

❓ PendingIntent 란

인텐트 정보를 갖지고 있는데 아직 발생하지 않은 인텐트.
PendingIntent 로 시스템에 등록하면, 시스템에서 실제 이벤트가 발생했을 때 PendingIntent 내용 대로 인텐트를 발생시킨다.

📝 작성 방법

val intent = Intent(this, DetailActivity::class.java)
val pendingIntent = PendingIntent.getActivity(this, 10, intent, PendingIntent.FLAG_UPDATE_CURRENT)
builder.setContentIntent(pendingIntent)

📓 액션

알림에 최대 3개까지의 유저 이벤트를 위한 액션을 추가
마찬가지로 인텐트 내용은 우리가 준비할 수 있지만, 인텐트 발생은 시스템에서 관리하기 때문에 PendingIntent 로 의뢰한다.

val actionIntent = Intent(this, DetailActivity::class.java)
val actionPendingIntent 
	= PendingIntent.getActivity(this, 20, actionIntent, PendingIntent.FLAG_UPDATE_CURRENT)
    
builder.addAction(
	NotificationCompat.Action.Builder(
    	android.R.drawable.stat_notify_more,
        "Action",
        actionPendingIntent
	).build()
)

📓 Progress

알림을 이용해 일의 진행 상황을 표시

builder.setProgress(100, 0, false)		// (max, min, Boolean)
manager.notify(11, builder.build())

thread {
	for (i in 1..100) {
    builder.setProgress(100, i, false)
    manager.notify(11, builder.build())
    SystemClock.sleep(100)
	}
}

📓 Style

BigPictureStyle, BigTextStyle, InboxStyle, Message Style

// BigPicture Style 예시

val bigPicture = BitmapFactory.decodeResource(resources.R.drawable.logo_1)
val bigStyle = NotificationCompat.BigPictureStyle()
bigStyle.bigPicture(bigPicture)
builder.setStyle(bigStyle)

🧩 실습 예제

❕ 퍼미션 추가

AndroidManifest.kt

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

🎨 액티비티 레이아웃

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
	xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="notification"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

📂 메인 소스 코드

MainActivity.kt

package com.kotdev99.android.c75

class MainActivity : AppCompatActivity() {

	private lateinit var btn: Button

	override fun onCreate(savedInstanceState: Bundle?) {
		super.onCreate(savedInstanceState)
		setContentView(R.layout.activity_main)

		btn = findViewById(R.id.button)
		btn.setOnClickListener {
			initNotification()
		}
	}

	// Notification 구현
	private fun initNotification() {
		val manager = getSystemService(NOTIFICATION_SERVICE) as NotificationManager
		val builder: NotificationCompat.Builder

		if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
			val channelId = "one"
			val channelName = "channel name"
			val channel = NotificationChannel(
				channelId,
				channelName,
				NotificationManager.IMPORTANCE_HIGH
			)

			channel.description = "one description"
			manager.createNotificationChannel(channel)

			builder = NotificationCompat.Builder(this, channelId)
		} else {
			builder = NotificationCompat.Builder(this)
		}

		builder.setSmallIcon(android.R.drawable.ic_notification_overlay)
		builder.setWhen(System.currentTimeMillis())
		builder.setContentTitle("Title")
		builder.setContentText("Text")

		pendingIntent(builder)
		manager.notify(1, builder.build())
	}

	// PendingIntent 구현
	private fun pendingIntent(builder: NotificationCompat.Builder) {

		// 알림 PendingIntent
		val actionIntent = Intent(this, DetailActivity::class.java)
		val actionPending =
			PendingIntent.getActivity(
				this, 20, actionIntent,
				PendingIntent.FLAG_CANCEL_CURRENT or PendingIntent.FLAG_IMMUTABLE
			)
		builder.setContentIntent(actionPending)

		// Action PendingIntent
		val actionIntent2 = Intent(this, DetailActivity::class.java)
		val actionPending2 =
			PendingIntent.getActivity(
				this, 20, actionIntent2,
				PendingIntent.FLAG_CANCEL_CURRENT or PendingIntent.FLAG_IMMUTABLE
			)
		builder.addAction(
			NotificationCompat.Action.Builder(
				android.R.drawable.stat_notify_more,
				"Action",
				actionPending2
			).build()
		)

		// BigPicture Style
		val bigPicture = BitmapFactory.decodeResource(resources, R.drawable.logo_1)
		val style = NotificationCompat.BigPictureStyle()
		style.bigPicture(bigPicture)
		builder.setStyle(style)
	}
}