Firebase Messaging Capacitor 플러그인

@capgo/capacitor-firebase-messaging 사용하기

Firebase Cloud Messaging (FCM)을 위한 Capacitor 플러그인

설치

bun add @capgo/capacitor-firebase-messaging
bunx cap sync

bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.

가져오기

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

API 한눈에 보기

메서드	설명
checkPermissions	푸시 알림 수신 권한을 확인합니다.
requestPermissions	푸시 알림 수신 권한을 요청합니다.
isSupported	필요한 모든 API가 존재하는지 확인합니다.
getToken	푸시 알림 수신을 위해 앱을 등록합니다. 해당 Messaging 인스턴스로 푸시 메시지를 보낼 때 사용할 수 있는 FCM token을 반환합니다.
deleteToken	FCM token을 삭제하고 앱 등록을 해제하여 푸시 알림 수신을 중단합니다. 사용자 로그아웃 시 호출할 수 있습니다.
getDeliveredNotifications	알림 화면에 표시되는 알림 목록을 가져옵니다.
removeDeliveredNotifications	알림 화면에서 특정 알림을 삭제합니다.
removeAllDeliveredNotifications	알림 화면에서 모든 알림을 삭제합니다.
subscribeToTopic	백그라운드에서 토픽을 구독합니다.
unsubscribeFromTopic	백그라운드에서 토픽 구독을 해제합니다.
createChannel	알림 채널을 생성합니다.
deleteChannel	알림 채널을 삭제합니다.
listChannels	사용 가능한 알림 채널 목록을 가져옵니다.

예시

checkPermissions()

푸시 알림 수신 권한을 확인합니다.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.checkPermissions();
console.log(result);

requestPermissions()

푸시 알림 수신 권한을 요청합니다.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.requestPermissions();
console.log(result);

isSupported()

필요한 모든 API가 존재하는지 확인합니다.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.isSupported();
console.log(result);

getToken()

푸시 알림 수신을 위해 앱을 등록합니다. 해당 Messaging 인스턴스로 푸시 메시지를 보낼 때 사용할 수 있는 FCM token을 반환합니다.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.getToken();
// The result holds sensitive values: use it without logging it.

deleteToken()

FCM token을 삭제하고 앱 등록을 해제하여 푸시 알림 수신을 중단합니다. 사용자 로그아웃 시 호출할 수 있습니다.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

await FirebaseMessaging.deleteToken();

getDeliveredNotifications()

알림 화면에 표시되는 알림 목록을 가져옵니다.

import { FirebaseMessaging } from '@capgo/capacitor-firebase-messaging';

const result = await FirebaseMessaging.getDeliveredNotifications();
console.log(result);

위 표에는 13개의 핵심 메서드가 나열되어 있습니다. Listener와 version helper, 각 메서드의 전체 계약은 다음에 문서화되어 있습니다: GitHub 리포지토리.

이벤트 수신

addListener 핸들을 반환합니다. 호출하세요 handle.remove() 화면이 언마운트될 때, 또는 FirebaseMessaging.removeAllListeners() 모든 리스너를 해제하려면.

전체 레퍼런스

• GitHub 리포지토리
• 문서
• API 레퍼런스

@capgo/capacitor-firebase-messaging 사용하기 다음 단계

사용 중이라면 @capgo/capacitor-firebase-messaging 사용하기 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트의 구현 세부 사항은, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우와, Capgo Native Build Capgo Native Builds의 제품 워크플로우를 위해.