[Android 기초] 14. 알림 (Notification)

 

 

 

 

알림 개요  |  Views  |  Android Developers

 

 

1. 알림 (Notification)

 

• 앱의 UI와 별도로 사용자에게 앱과 관련한 정보를 보여주는 기능
• 알림을 터치하여 해당 앱을 열 수 있고, 바로 간단한 작업(예 : 문자 답하기)을 할 수 있음 (Android 7.0부터)
• 보통 단말기 상단 부분에 표시되고, 앱 아이콘의 배지로도 표시 (Android 8.0부터)

 

 

 

2.  알림 채널 만들기

알림 채널 만들기 및 관리  |  Views  |  Android Developers

 

• Android 8.0이상의 경우는 알림을 만들기 전에 알림 채널을 먼저 만들어야함
• 알림 채널은 알림을 그룹하여 알림 활성화나 방식을 변경 할 수 있음
• 현재 앱이 실행 중인 안드로이드 버전을 확인하여 8.0이상인 경우만 채널 생성

 

private val myNotificationID = 1
private val channelID = "default"

private fun createNotificationChannel() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { // Android 8.0
        val channel = NotificationChannel(channelID, "default channel",
            NotificationManager.IMPORTANCE_DEFAULT)
        channel.description = "description text of this channel."
        val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.createNotificationChannel(channel)
    }
}

• 고유한 채널 ID, 사용자에게 표시되는 이름, 중요도 수준을 사용하여 NotificationChannel 객체를 구성
• 필요한 경우 setDescription()를 사용하여 시스템 설정에서 사용자에게 표시되는 설명을 지정
• 알림 채널을 createNotificationChannel()에 전달하여 등록

 

 

3. 알림 생성

알림 만들기  |  Views  |  Android Developers

private val myNotificationID = 1

private fun showNotification() {
    val builder = NotificationCompat.Builder(this, channelID)
        .setSmallIcon(R.mipmap.ic_launcher)
        .setContentTitle("title")
        .setContentText("notification text")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
    NotificationManagerCompat.from(this).notify(myNotificationID, builder.build())
}

• 1) NotificationCompat.Builder 객체에서 알림에 대한 UI정보와 작업을 지정
        - setSmallIcon() : 작은 아이콘
        - setContentTitle() : 제목
        - setContentText() : 세부 텍스트
• 2) NotificationCompat.Builder.build()호출
        - Notification객체를 반환
• 3) NotificationManagerCompat.notify()를 호출해서 시스템에 Notification객체를 전달

 

 

 

4. 알림 중요도

Android 8.0 이상에서는 사용자가 각 채널의 중요도를 변경할 수 있음

• Android 7.1 (API 수준 25) 이하에서는 알림의 중요도가 알림의 priority에 의해 결정
  NotificationCompat.Builder(this,channelID).setPriority(NotificationCompat.PRIORITY_DEFAULT)
• Android 8.0 (API 수준 26) 이상에서 알림의 중요도는 알림이 게시된 채널의 importance에 의해 결정
  NotificationChannel  - (channelID, "defaultchannel", NotificationManager.IMPORTANCE_DEFAULT)
• 사용자는 시스템 설정에서 알림 채널의 중요도를 변경할 수 있음

 

 

 

5. 알림 확장뷰

알림 만들기  |  Views  |  Android Developers

 

5-1. 긴 텍스트

아래 코드를 추가
	builder.setStyle(NotificationCompat.BigTextStyle() 
		.bigText("Much longer text that cannot fit one line..."))

예시

var builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Much longer text that cannot fit one line...")
        .setStyle(NotificationCompat.BigTextStyle()
                .bigText("Much longer text that cannot fit one line..."))
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)

 

5-2. 이미지

아래 코드를 추가
			.setStyle(NotificationCompat.BigPictureStyle()
				.bigPicture(myBitmap))

예시

val notification = NotificationCompat.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.new_post)
        .setContentTitle(imageTitle)
        .setContentText(imageDescription)
        .setLargeIcon(myBitmap)
        .setStyle(NotificationCompat.BigPictureStyle()
                .bigPicture(myBitmap)
                .bigLargeIcon(null)) // 알림을 확장할 때 아이콘을 숨김
        .build()

 

5-3. 버튼 추가

• 알림에 사용자가 신속하게 응답할 수 있는 작업 버튼을 최대 3개까지 제공 가능
• 이러한 작업 버튼은 사용자가 알림을 탭할 때 실행되는 작업과 중복되지 않아야 함
• 작업 버튼을 추가하려면 PendingIntent를 addAction() 메서드에 전달
  이는 활동을 실행하는 대신 알림의 기본 탭 작업을 설정하는 것과 같음
• 백그라운드에서 작업을 실행하는 BroadcastReceiver를 시작해 작업이 이미 열려 있는 앱을 방해하지 않도록 하는 등 다른 작업을 할 수 있음

val ACTION_SNOOZE = "snooze"

val snoozeIntent = Intent(this, MyBroadcastReceiver::class.java).apply {
    action = ACTION_SNOOZE
    putExtra(EXTRA_NOTIFICATION_ID, 0)
}
val snoozePendingIntent: PendingIntent =
    PendingIntent.getBroadcast(this, 0, snoozeIntent, 0)
val builder = NotificationCompat.Builder(this, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setContentTitle("My notification")
        .setContentText("Hello World!")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setContentIntent(pendingIntent)
        .addAction(R.drawable.ic_snooze, getString(R.string.snooze),
                snoozePendingIntent)

혹은 intent로 Activity를 시작함 (Snooze 버튼을 누르면 TestActivity 실행 예시)

val intent = Intent(this, TestActivity::class.java)
val pendingIntent = PendingIntent.getActivity(this, 0, intent, 0)
val builder = NotificationCompat.Builder(this, channelID)
	.setSmallIcon(R.mipmap.ic_launcher)
    .setContentTitle("Notification Title")
    .setContentText("Notification body")
    .setPriority(NotificationCompat.PRIORITY_DEFAULT)
    .addAction(R.drawable.android_hsu, "Snooze", pendingIntent)
NotificationManagerCompat.from(this).notify(myNotificationID, builder.build())

 

5-4. 프로그레스바 추가

• 언제든지 완료된 작업의 양을 추정할 수 있는 경우 setProgress(max, progress, false)를 호출
• 첫 번째 매개변수는 '완료' 값(예: 100) / 두 번째는 얼마나 완료되었는지 진행정도 / 마지막은 확정된 진행률 표시줄
• 작업이 진행됨에 따라 업데이트된 progress 값으로 setProgress(max, progress, false)를 계속 호출하고 알림을 다시 발행. 작업이 끝나면 progress는 max와 같아야 함
• 진행률 표시줄을 삭제하려면 setProgress(0, 0, false)를 호출
• 참고로 프로그레스바를 사용하려면 앱이 지속적으로 알림을 업데이트해야 하므로, 이 코드가 백그라운드 서비스에서 실행되도록 해야함
• 참고로 나중에 파일을 다운로드하는 어플을 구상한다면 다운로드 진행률을 추적하는 자체 알림을 제공하는 DownloadManager를 사용하는 게 좋음

val builder = NotificationCompat.Builder(this, CHANNEL_ID).apply {
    setContentTitle("Picture Download")
    setContentText("Download in progress")
    setSmallIcon(R.drawable.ic_notification)
    setPriority(NotificationCompat.PRIORITY_LOW)
}
val PROGRESS_MAX = 100
val PROGRESS_CURRENT = 0
NotificationManagerCompat.from(this).apply {
    // Issue the initial notification with zero progress.
    builder.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false)
    notify(notificationId, builder.build())

    // Do the job that tracks the progress here.
    // Usually, this is in a worker thread.
    // To show progress, update PROGRESS_CURRENT and update the notification with:
    // builder.setProgress(PROGRESS_MAX, PROGRESS_CURRENT, false);
    // notificationManager.notify(notificationId, builder.build());

    // When done, update the notification once more to remove the progress bar.
    builder.setContentText("Download complete")
            .setProgress(0, 0, false)
    notify(notificationId, builder.build())
}

 

 

 

6. 알림에 액티비티 연결

• 알림을 클릭할 때 알림은 사라지고, SecondActivity가 실행되도록 구현
• SecondActivity가 실행된 상태에서 Back이나 Up을 누르면 MainActivity가 나오도록 구현
• 알림을 터치하면 일반 액티비티인 SecondActivity가 시작, 이 때 MainActivity위에 SecondActivity가 있는 백스택 생성
• (사실 MainAcitivity가 이미 백스택에 있기 때문에 TaskStackBuilder로 백스택을 조작하지 않아도 동일하게 동작)
• 백스택에 없는 다른 액티비티를 SecondActivity의 parentActivity로 하면 달라짐

AndroidManifest.xml의 SecondActivity 정의 부분

<activity android:name=".SecondAcitivty" android:parentActivityName=".MainActivity" />

PendingIntent 생성하고 알림 등록

val intent = Intent(this, SecondActivity::class.java)
val pendingIntent = with (TaskStackBuilder.create(this)) {
	addNextIntentWithParentStack(intent)
    getPendingIntent(0, PendingIntent.FLAG_UPDATE_CURRENT)
}
val builder = NotificationCompat.Builder(this, channelID)
	.setSmallIcon(R.mipmap.ic_launcher)
    .setContentTitle("Notification Title")
    .setContentText("Notification body")
    .setPriority(NotificationCompat.PRIORITY_DEFAULT)
    .setContentIntent(pendingIntent)
    .setAutoCancel(true) // 유저가 터지하면 알림 자동 삭제
NotificationManagerCompat.from(this).notify(myNotificationID, builder.build())

 

 

 

 

 

💡 Android API 33이상에서 권한 시스템 변경

알림 런타임 권한  |  Views  |  Android Developers

• 안드로이드 12(API 레벨 33)부터, POST_NOTIFICATIONS 권한을 앱의 매니페스트 파일에 명시적으로 추가 필수
• 사용자의 프라이버시를 강화하고, 앱이 사용자의 동의 없이 알림을 보내는 것을 방지하기 위함
• 사용자는 앱 설치 후 처음 알림을 수신할 때 이 권한을 부여할지 결정하는 대화상자를 볼 수 있음 

 

AndroidManifest.xml 에 권한 추가

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp">

    <!-- API 33 이상을 위한 알림 권한 추가 -->
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

    ...
</manifest>

사용자 권한을 확인하고 권한 요청

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    if (!NotificationManagerCompat.from(this).areNotificationsEnabled()) {
        // 알림 권한이 없다면, 사용자에게 권한 요청
        val intent = Intent(Settings.ACTION_APP_NOTIFICATION_SETTINGS).apply {
            putExtra(Settings.EXTRA_APP_PACKAGE, packageName)
        }
        startActivity(intent)
    }
}

 

 

💡 알림 구현 예시

 

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/notificationButton"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="알림 보내기"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

 

 

MainActivity.kt


class MainActivity : AppCompatActivity() {
    private val binding by lazy { ActivityMainBinding.inflate(layoutInflater) }
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(binding.root)
        binding.notificationButton.setOnClickListener{
            notification()
        }
    }

    fun notification(){
        val manager = getSystemService(NOTIFICATION_SERVICE) as NotificationManager

        val builder: NotificationCompat.Builder
        if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.O){
            // 26 버전 이상
            val channelId="one-channel"
            val channelName="My Channel One"
            val channel = NotificationChannel(
                channelId,
                channelName,
                NotificationManager.IMPORTANCE_DEFAULT
            ).apply {
                // 채널에 다양한 정보 설정
                description = "My Channel One Description"
                setShowBadge(true)
                val uri: Uri = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION)
                val audioAttributes = AudioAttributes.Builder()
                    .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION)
                    .setUsage(AudioAttributes.USAGE_ALARM)
                    .build()
                setSound(uri, audioAttributes)
                enableVibration(true)
            }
            // 채널을 NotificationManager에 등록
            manager.createNotificationChannel(channel)

            // 채널을 이용하여 builder 생성
            builder = NotificationCompat.Builder(this, channelId)

        }else {
            // 26 버전 이하
            builder = NotificationCompat.Builder(this)
        }

				val bitmap = BitmapFactory.decodeResource(resources, R.drawable.flower)
        val intent = Intent(this, SecondActivity::class.java)
        intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TASK
        val pendingIntent = PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE)
        // 알림의 기본 정보
        builder.run {
            setSmallIcon(R.mipmap.ic_launcher)
            setWhen(System.currentTimeMillis())
            setContentTitle("새로운 알림입니다.")
            setContentText("알림이 잘 보이시나요.")
            setStyle(NotificationCompat.BigTextStyle()
                .bigText("이것은 긴텍스트 샘플입니다. 아주 긴 텍스트를 쓸때는 여기다 하면 됩니다.이것은 긴텍스트 샘플입니다. 
아주 긴 텍스트를 쓸때는 여기다 하면 됩니다.이것은 긴텍스트 샘플입니다. 아주 긴 텍스트를 쓸때는 여기다 하면 됩니다."))
            setLargeIcon(bitmap)
//            setStyle(NotificationCompat.BigPictureStyle()
//                    .bigPicture(bitmap)
//                    .bigLargeIcon(null))  // hide largeIcon while expanding
            addAction(R.mipmap.ic_launcher, "Action", pendingIntent)
        }


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

}