푸시
이 문서는 React Native에 대한 푸시 알림을 설정하는 방법을 다룹니다. 푸시 알림을 통합하려면 각 기본 플랫폼을 별도로 설정해야합니다. 나열된 각 안내서를 따라 설치를 완료하십시오.
1. 플랫폼 별 초기 설정
iOS
Dfinery Console에 APNs 인증키 등록
푸시메시지를 사용하기 위해 Apple로부터 발급받은 .p8 APNs 인증키를 DFINERY 콘솔에 등록해주세요. 콘솔의 부가 설정 / 채널 부가 설정 / 푸시 / iOS 설정 관리에서 등록할 수 있습니다.
Capabilities 설정
아래 스크린샷과 같이 PushNotification, Background Modes/Remote Notifications에 대한 Capabilities를 추가해 주세요.
Notification Service Extension 추가
아래 스크린샷과 같이 Notification Service Extension을 추가해주세요
cocoapods 연동
ios 디렉토리 내 podfile에 추가한 NotificationServiceExtension에 대한 타겟과 디파이너리 의존성을 추가합니다.
target 'NotificationServiceExtension' do
pod 'DfinerySDKServiceExtension'
end이후 pod install을 통해 SDK를 설치합니다.
iOS 네이티브 코드 수정
생성한 Notification Service Extension 프로젝트 내에 DfinerySDKServiceExtension을 import 후 코드를 수정합니다.
Swift
import UserNotifications
import DfinerySDKServiceExtension
class NotificationService: UNNotificationServiceExtension {
var contentHandler: ((UNNotificationContent) -> Void)?
var bestAttemptContent: UNMutableNotificationContent?
override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
self.contentHandler = contentHandler
bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
if let bestAttemptContent = bestAttemptContent {
if DfineryServiceExtension.canHandle(content: bestAttemptContent, contentHandler: contentHandler) {
return
}
contentHandler(bestAttemptContent)
}
}
// ...
}Objective-C
#import "NotificationService.h"
#import <DfinerySDKServiceExtension/DfinerySDKServiceExtension.h>
// ...
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
self.contentHandler = contentHandler;
self.bestAttemptContent = [request.content mutableCopy];
if (self.bestAttemptContent) {
if ([DfineryServiceExtension canHandleWithContent:self.bestAttemptContent contentHandler:contentHandler]) {
return;
}
}
self.contentHandler(self.bestAttemptContent);
}
// ...2. 런타임 알림 권한 요청하기
react-native-permissions 패키지를 활용한 푸시 알림 권한 요청 예시입니다.
requestNotifications(['alert', 'sound', 'badge']).then(({status, settings}) => {
if (status === 'granted') {
Dfinery.getPushToken().then((token)=>{
Dfinery.setPushToken(token);
});
}
}).catch((error) => {
console.error('Notification permission error:', error);
});
3. 토큰을 Dfinery에 연동하기
Firebase/APNS에서 발급된 토큰을 Dfinery에 연동하기 위해서 다음과 같이 작성해주시기 바랍니다.
아래는 가장 최근에 발급받은 푸시 토큰을 가져오고 Dfinery에 연동하는 예제입니다.
import React, { useEffect } from "react";
import Dfinery from '@igaworks/dfinery-react-native-sdk';
const App = () => {
useEffect(() => {
Dfinery.getPushToken().then((token)=>{
Dfinery.setPushToken(token);
});
}, []);
return (
<div>
...
</div>
)
}4. 푸시 클릭시 호출되는 딥링크 연동하기
iOS
Apple의 가이드 대로 딥링크 스킴을 설정 후
AppDelegate 클래스에 다음과 같이 메소드를 추가해주세요
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
return RCTLinkingManager.application(app, open: url, options: options)
}5. 푸시 알림 수신 허용 유무 반영하기
광고성 목적이 있는 푸시의 경우 정보통신망법 에 따라 사용자에게 사전 수신동의를 받아야 합니다. 사용자에게 푸시 알림이 허용되었다는 정보를 Dfinery에 반영하기 위해서 다음의 일련의 작업을 수행하여 주시기 바랍니다.
1. 사용자에게 푸시 알림 허용에 대한 고지하기
2. 사용자의 허용/거부 의사에 대한 값을 반영하기 위해 다음의 코드를 작성
알림 수신 동의 설정하기를 참고하여 사용자가 동의한 항목에 대해 값을 입력해주시기 바랍니다. 아래 코드는 광고성 수신 동의를 허용한 예시입니다.
const param = {
[DFUserProfile.PUSH_ADS_OPTIN]: true
};
Dfinery.setUserProfiles(param);6. 완료
이제 Dfinery에서 알림을 사용하기 위한 모든 준비가 완료되었습니다.
Last updated