Android SDK 푸시 알림을 Firebase 클라우드 메시징 HTTP v1로 마이그레이션
이 문서는 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 애플리케이션이 있거나 Google FCM을 사용한 적이 없다면 FCM v1을 사용하여 Android SDK 푸시 알림 등록 문서를 참조하세요.
Android 애플리케이션이 푸시 알림 기능을 사용하는 경우 다음 단계를 완료하여 푸시 알림을 FCM HTTP v1로 마이그레이션합니다.
1. Firebase 콘솔에서 프라이빗 키 생성
Firebase 콘솔에서 프로젝트를 엽니다.
프로젝트 설정>서비스 계정을 엽니다.
프로그래밍 언어를 선택합니다.
새 프라이빗 키가 포함된 JSON 파일을 다운로드하려면 새 프라이빗 키 생성을 클릭합니다.
다운로드한 JSON 파일을 찾아 엽니다. 다음 단계에서는 이 파일의 값이 필요합니다.
2. Google(FCM v1)에 대한 프라이빗 키 자격 증명을 제공합니다.
Azure Portal에서 Azure Communication Services 알림 허브를 엽니다.
설정>Google(FCM v1)을 엽니다.
프라이빗 키, 클라이언트 이메일 및 프로젝트 ID 텍스트 상자에 다운로드한 JSON 파일의 값을 입력합니다.
저장을 클릭합니다.
3. Google의 레거시 자격 증명 제거(GCM/FCM)
Azure Portal에서 Azure Communication Services 알림 허브를 엽니다.
설정>Google(GCM/FCM)을 엽니다.
API 키 텍스트 상자를 지웁니다.
저장을 클릭합니다.
4. 애플리케이션이 푸시 알림을 수신하는지 확인
알림 허브에서 변경한 내용이 적용될 때까지 몇 분 정도 기다립니다. 이 시간 동안 애플리케이션에서 중복된 푸시 알림이나 누락된 알림이 발생할 수 있습니다.
애플리케이션이 오류 없이 푸시 알림을 받는지 확인합니다.
문제 해결
애플리케이션이 푸시 알림을 받을 수 없는 경우 새 FCM v1 자격 증명이 올바른지 확인합니다. 필요에 따라 이 문서의 단계를 반복하여 Firebase 콘솔에서 프라이빗 키를 생성하거나 Google(FCM v1)에 프라이빗 키 사용자 인증 정보를 제공합니다.
애플리케이션이 여전히 푸시 알림을 받을 수 없는 경우 Microsoft Azure 도움말+ 지원에서 Azure Communication Services에 문의하세요.
관련된 문서
Android 채팅 앱에서 푸시 알림을 사용하도록 설정합니다.통화에 대해 푸시 알림을 사용하도록 설정합니다.