Firebase Cloud Messaging HTTP v1을 사용하여 Android SDK 푸시 알림 등록

이 문서는 FCM(Firebase Cloud Messaging) 푸시 알림과 함께 Android SDK를 사용하는 통화 및 채팅 애플리케이션에 적용됩니다. FCM은 이전에는 GCM/FCM(Google Cloud Messaging)으로 알려져 있었습니다.

2023년 6월 20일에 Google은 FCM 레거시 API를 사용한 메시지 전송을 사용 중단한다고 공지했습니다. Google은 2024년 6월에 서비스에서 레거시 FCM을 제거할 예정입니다. Google에서는 레거시 FCM API에서 FCM HTTP v1로 마이그레이션을 권장합니다.

기존 Android 애플리케이션에서 푸시 알림 기능을 사용하는 경우 FCM HTTP v1 엔드포인트로 마이그레이션해야 합니다.

새 Android 애플리케이션이 있거나 Google FCM을 사용한 적이 없는 경우 다음 단계에 따라 FCM HTTP v1을 사용하여 Android SDK 푸시 알림을 등록합니다.

다음 단계를 완료하여 푸시 알림을 FCM HTTP v1로 마이그레이션합니다.

1. Firebase 콘솔에서 프라이빗 키 생성

  1. Firebase 콘솔에서 프로젝트를 엽니다.

  2. 프로젝트 설정>서비스 계정을 엽니다.

  3. 프로그래밍 언어를 선택합니다.

  4. 새 프라이빗 키가 포함된 JSON 파일을 다운로드하려면 새 프라이빗 키 생성을 클릭합니다.

    Firebase 콘솔에서 FMC v1용 새 프라이빗 키를 생성하는 방법을 보여주는 스크린샷.

  5. 다운로드한 JSON 파일을 찾아 엽니다. 다음 단계에서 이 파일의 값이 필요합니다.

2. Google(FCM v1)에 프라이빗 키 자격 증명 제공

  1. Azure Portal에서 Azure Communication Services 알림 허브를 엽니다.

  2. 설정>Google(FCM v1)을 엽니다.

  3. 프라이빗 키, 클라이언트 이메일프로젝트 ID 텍스트 상자에 다운로드한 JSON 파일의 값을 입력합니다.

    Azure Portal 설정에서 FCM v1에 대한 새 프라이빗 키 자격 증명을 제공하는 방법을 보여주는 스크린샷.

  4. 저장을 클릭합니다.

3. 애플리케이션이 푸시 알림을 수신하는지 확인

  1. 알림 허브에서 변경한 내용이 적용될 때까지 몇 분 정도 기다립니다. 이 시간 동안 애플리케이션에서 중복된 푸시 알림이나 누락된 알림이 발생할 수 있습니다.

  2. 애플리케이션이 오류 없이 푸시 알림을 받는지 확인합니다.

문제 해결

애플리케이션이 푸시 알림을 받을 수 없는 경우 새 FCM v1 자격 증명이 올바른지 확인합니다. 필요에 따라 이 문서의 단계를 반복하여 Firebase 콘솔에서 프라이빗 키를 생성하거나 Google(FCM v1)에 프라이빗 키 사용자 인증 정보를 제공합니다.

애플리케이션이 여전히 푸시 알림을 받을 수 없는 경우 Microsoft Azure 도움말+ 지원에서 Azure Communication Services에 문의하세요.

Android 채팅 앱에서 푸시 알림 사용통화에 푸시 알림 사용