⏰ Android FCM 푸시 알림

목차

 

📦 FCM ( Firebase Cloud Messaging )

 Firebase Console

Firebase 클라우드 메시징(FCM)은 메시지를 안정적으로 전송할 수 있는 크로스 플랫폼 메시징 솔루션입니다. 직접 구현한 서버에서 애플리케이션에 알림/메시지를 전송하기 위해서는 애플리케이션과 서버가 연결을 계속 유지하고 있어야 합니다. 하지만 FCM을 이용하면, 연결을 유지하고 있지 않아도 메시지를 전송하고 받을 수 있습니다.

 

🎯 Notification과 Data

 FCM 메시지 정보  
 Android FCM Data와 Notification - 해리의 유목코딩

푸시 알림으로 보낼 수 있는 메시지는 아래와 같이 2가지 유형으로 나뉩니다. Notification은 앱이 포그라운드일 때만 푸시 알림이 오고 Data는 앱이 포그라운드에 있든 백그라운드에 있든 상관없이 푸시 알림이 옵니다. 또한 Notification과 Data를 같이 사용하는 경우도 있습니다.

메시지 처리

Notification

Data

 

👨‍👨‍👧‍👦 누구에게 보낼 것인가? ( 푸시 알림 대상 )

 Android에서 주제 메시징(topic messagin)
 Android의 기기 그룹에 메시지 보내기

1. 특정 대상 1명

특정 기기의 Token 값을 이용하여 해당 기기에만 알림을 전송하는 방법입니다. 

2. 여러 명 ( topic을 구독한 사람들 )

특정 topic을 구독한 여러 기기에 메시지를 보내는 방법으로 날씨와 같이 공개적으로 제공되는 정보에 사용하면 적합한 방법입니다. 클라이언트인 앱에서 기존 topic을 구독하거나 새 topic을 만들 수 있습니다. Firebase 프로젝트에 아직 없는 새 topic을 구독하면 FCM에서 이 이름으로 새 topic이 만들어지고, 이후에 다른 클라이언트에서 그 topic을 구독할 수 있습니다. Firebase Admin SDK를 사용하면 서버 측에서 기본적인 topic 관리 작업을 수행할 수 있습니다. 등록 토큰을 알고 있으면 서버 로직을 사용하여 클라이언트 앱 인스턴스를 일괄 구독하거나 구독 취소할 수 있습니다. 속도보다 처리량을 위주로 최적화되어 있는 기능으로 빠르고 안전하게 전송하고 싶다면 다른 방법을 사용하라고 권고되어 있습니다.

3. 여러 명 ( 기기 그룹에 속한 사람들 )

그룹에 속한 기기에만 알림을 보내는 방법입니다. 기기 그룹 메시징은 앱 내에서 관리하는 것이 아니라 서버에서 기기 그룹을 관리합니다. 예를 들어, 기기 모델에 따라서 다른 메시지를 보내려면 서버에서 알맞은 그룹에 등록/삭제하여 각 그룹에 적절한 메시지를 보냅니다. 하지만 알림키 하나 그룹에 최대 20명까지만 속할 수 있습니다.

 

 🚘 FCM 알림을 전송하는 전체 과정

FCM 메시지 전송 과정

 

📥 Android 앱에서 푸시 알림 받기

1. Firebase 구성 파일 추가

Android에서 Firebase 클라우드 메시징 클라이언트 앱 설정  |  Firebase Documentation

2. FirebaseMessagingService를 상속

알림을 수신할 수 있는 Service 코드를 작성해야 합니다. 2개의 메서드를 오버라이딩 해야 합니다. 

onNewToken()은 FCM 서버에 앱이 등록되었을 때 호출되고, 파라미터로 Token 값이 전달됩니다. 이 Token 값은 각각의 앱을 구분하기 위한 고유한 키입니다.

onMessageReceived()는 FCM 서버에서 메시지를 전송하면 호출됩니다. 

class ChordFirebaseMessagingService : FirebaseMessagingService() {

    override fun onNewToken(token: String) {
        Log.i("onNewToken", "Success save token")
        sendRegistrationToServer(token) // Token을 서버로 전송
    }

    // 메시지를 수신하는 메서드
    override fun onMessageReceived(remoteMessage: RemoteMessage) {
        if (remoteMessage.data.isNotEmpty()) {
            sendNotification(
                remoteMessage.data["title"].toString(),
                remoteMessage.data["body"].toString()
            )
        } else {
            remoteMessage.notification?.let {
                sendNotification(
                    remoteMessage.notification!!.title.toString(),
                    remoteMessage.notification!!.body.toString()
                )
            }
        }
    }

    // 알림을 생성하는 메서드
    private fun sendNotification(title: String, body: String) {
        val notifyId = (System.currentTimeMillis() / 7).toInt()

        val intent = Intent(this, MainActivity::class.java)
        intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP)
        val pendingIntent =
            PendingIntent.getActivity(this, notifyId, intent, PendingIntent.FLAG_ONE_SHOT)

        val channelId = getString(R.string.firebase_notification_channel_id)
        val soundUri = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION)

        val notificationBuilder = NotificationCompat.Builder(this, channelId)
            .setSmallIcon(R.mipmap.ic_launcher)
            .setContentTitle(title)
            .setContentText(body)
            .setPriority(NotificationManagerCompat.IMPORTANCE_HIGH)
            .setAutoCancel(true)
            .setSound(soundUri)
            .setContentIntent(pendingIntent)

        val notificationManager =
            getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            val channel = NotificationChannel(
                channelId,
                channelId,
                NotificationManager.IMPORTANCE_HIGH
            )
            notificationManager.createNotificationChannel(channel)
        }

        notificationManager.notify(notifyId, notificationBuilder.build())
    }
}

3. Manifest 파일 수정

1) 인터넷을 사용하기 위해 인터넷 퍼미션을 추가합니다. 

2) 서비스 파일은 Manifest 파일에 등록해야 합니다. 이때, 메시지를 수신하기 위한 intent-filter를 설정해줍니다.

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

        <service android:name=".network.ChordFirebaseMessagingService"
            android:exported="false">
            <intent-filter>
                <action android:name="com.google.firebase.MESSAGING_EVENT" />
            </intent-filter>
        </service>

4. Firebase Console에서 Push 테스트 하기

알림 제목과 알림 테스트를 입력 후 [테스트 메시지 전송] 버튼을 눌러줍니다. 만약 테스트 메시지 전송을 눌렀을 때 아래와 같은 화면이 표시된다면 FCM 토큰을 입력해주면 됩니다.

Android에서 얻은 FCM 토큰 값 입력하기

• 테스트 화면

Push 테스트

 

📤 Node js 푸시 알림 보내기

 기기 등록 토큰 액세스 
 앱 서버 전송 요청 작성
 FCM을 이용하여 node js 푸시 알람 구현하기 - Yusong 블로그

1. 클라이언트로부터 현재 FCM 토큰 값을 알아냅니다. ( Android 클라이언트 설정 )

FCM SDK는 앱을 처음 시작할 때 클라이언트 앱 인스턴스용 등록 토큰을 생성합니다. 이 토큰은 아래의 경우에 변경될 수 있습니다.

• 새 기기에서 앱을 복원
• 사용자가 앱 삭제/재설치
• 사용자가 앱 데이터를 제거

FirebaseMessaging.getInstance().token.addOnCompleteListener(OnCompleteListener { task ->
    if (!task.isSuccessful) {
        Log.w(TAG, "Fetching FCM registration token failed", task.exception)
        return@OnCompleteListener
    }

    // Get new FCM registration token
    val token = task.result

    // Log and toast
    val msg = getString(R.string.msg_token_fmt, token)
    Log.d(TAG, msg)
    Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show()
})

2. 특정 기기 (deviceToken에 해당하는 기기)로 푸시 알림을 전송합니다.

/**
 * Push Alarm 
 **/
const admin = require("firebase-admin"); // Firebase Admin SDK 설치
let serviceAccount = require("./firebase_admin_key.json"); // 비공개 서버키 다운로드 후 로드

admin.initializeApp({
    credential: admin.credential.cert(serviceAccount)
});

// Push Test
app.get('/pushComplete', function (req, res, next) {
    let deviceToken = "앱 FCM 토큰 값"
    let message = {
        notification: {
            title: "Test",
            body: "push test in server"
        },
        token: deviceToken
    }

    admin
        .messaging()
        .send(message)
        .then(function (response) {
            console.log('Successfully sent message: : ', response)
            return res.status(200).json({ success: true })
        })
        .catch(function (err) {
            console.log('Error Sending message!!! : ', err)
            return res.status(400).json({ success: false })
        })
})

• 테스트 화면

Server Push 테스트

 

📌 참고

당근마켓의 기술 블로그를 참고하면 많은 사용자에게 어떻게 빠르고 안정적으로 푸시 서비스를 제공하는지에 대해 서술되어 있습니다.

당근마켓의 푸시알림을 지탱하고 있는 Node.js 서비스

 

END