[TIL] 🌼24/07/08🌼#FCM #Firebase Cloud Messaging(1)

[TIL] 🌼24/07/08🌼

• 지난 한 달간 <농림축산식품부 공공데이터 활용 창업경진대회 공모전>을 준비했다.
  프로젝트 개발 중에는 TIL이 늘 우선순위에서 밀려나게 된다.
  (내배캠 때부터 고치려 했지만 아직도 고쳐지지 않은 고질병)

• 내일부터는 <관광데이터 활용 공모전> 준비를 시작할 예정이다.
  이번에는 TIL을 밀리지 않고 작성해야지. 꼬옥...

Firebase Cloud Messaging(1)

FCM

• FCM?
  • Firebase 클라우드 메세징
  • 메세지를 안정적으로 무료 전송할 수 있는 크로스 플랫폼 메세징 솔루션
• 주요 기능
  • 알림 메세지/데이터 메세지 전송
  • 단일 기기/기기 그룹/주제를 구독한 기기의 클라이언트 앱에 메세지 배포 가능
  • 클라이언트 앱에서 메세지 전송

• 알림 메세지 vs 데이터 메세지?
  • 알림 메세지
    • FCM SDK에서 자동으로 처리
      • 클라이언트 앱이 백그라운드에서 실행 중일 때: FCM SDK가 앱을 대신하여 메세지 표시
      • 클라이언트 앱이 포그라운드에서 실행 중일 때: 앱 코드에 따라 동작 결정
    • 사전 정의된 키 모음 O
    • 데이터 페이로드(커스텀 키-값 쌍) 포함 가능
      -> 알림 페이로드: FCM이 처리 담당
      -> 데이터 페이로드: 클라이언트 앱이 처리 담당
  • 데이터 메세지
    • 클라이언트 앱이 메세지 처리 담당
    • 예약 키 이름 X, 사용자가 정의한 커스텀 키-값 쌍만 O

알림 메세지

• 예) JSON 형식 알림 메세지

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "notification":{
      "title":"Portugal vs. Denmark",
      "body":"great match!"
    }
  }
}

• 앱이 백그라운드 상태인 경우: 알림 메세지 알림 목록으로 전송됨
• 앱이 포그라운드 상태인 경우: 콜백 함수가 메세지 처리

• 예) JSON 형식 데이터 페이로드가 포함된 알림 메세지

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "notification":{
      "title":"Portugal vs. Denmark",
      "body":"great match!"
    },
    "data" : {
      "Nick" : "Mario",
      "Room" : "PortugalVSDenmark"
    }
  }
}

• 앱이 백그라운드 상태인 경우:
  • 알림 페이로드가 알림 목록으로 전송됨
  • 사용자가 알림을 탭한 경우 -> 앱에서 데이터 페이로드 처리
• 앱이 포그라운드 상태인 경우: 콜백 함수가 메세지 처리

데이터 메세지

• 예) JSON 형식 데이터 메세지

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "data":{
      "Nick" : "Mario",
      "body" : "great match!",
      "Room" : "PortugalVSDenmark"
    }
  }
}

• 커스텀 키-값 쌍으로 데이터 페이로드 전송
  • 정보는 공통 data 키에 캡슐화
  • 클라이언트 앱이 콜백 함수로 컨텐츠 해석

• 데이터 메세지 암호화
  • Android 전송 레이어에서 지점 간 암호화 사용
  • 필요에 따라 엔드 투 엔드 암호화 추가 가능
    • FCM에서 엔드 투 엔드 솔루션 제공 X
    • 외부 솔루션(ex. Capillary, DTLS) 사용 가능

Cloud Messaging 연동하기

• Firebase Console에 프로젝트 추가하기
• Android Studio 좌측 배너 Project 뷰로 변경 -> app 패키지에 google-services.json 추가하기
• plugin & dependency 추가하기

// project gradle
plugins {
    id("com.google.gms.google-services") version "4.4.2" apply false
}

// module gradle
plugins {
    id("com.google.gms.google-services")
}


dependencies {
    implementation(platform(libs.firebase.bom))
    implementation(libs.firebase.analytics)
    implementation(libs.firebase.cloud.messaging)
}

// libs.versions.toml
[versions]
firebaseCloudMsg = "23.2.1"
firebaseBom = "33.1.1"

[libraries]
firebase-cloud-messaging = { module = "com.google.firebase:firebase-messaging-ktx", version.ref = "firebaseCloudMsg" }
firebase-analytics = { module = "com.google.firebase:firebase-analytics" }
firebase-bom = { module = "com.google.firebase:firebase-bom", version.ref = "firebaseBom" }

• Cloud Messaging 연동 잘 됐는지 확인하기
  • Firebase token 받아와 출력하기
  • Firebase Console에서 해당 token으로 테스트 알람 보내기

    // onCreate() 내부에서 호출
    private fun initFirebase() {
        FirebaseMessaging.getInstance().token.addOnCompleteListener { task ->
            if (task.isSuccessful) tokenTextView.text = task.result
        }
    }