쿠링의 FCM 과 APNs

[x-0o0]

푸시 알림 구성

서버에서 푸시 알림을 전송하는 코드는 아래와 같습니다. (링크)

Message newMessage = Message.builder()
    .setNotification(Notification
        .builder()
        .setTitle(buildTitle(messageDto.getCategoryKorName()))
        .setBody(messageDto.getSubject())
        .build())
    .putAllData(objectMapper.convertValue(messageDto, Map.class))
    .setTopic(suffixUtil.apply(messageDto.getCategory()))
    .build();

firebaseMessaging.send(newMessage);

setTitle(_:) 과 setBody(_:) 를 통해 주입된 값은 푸시 알림 페이로드의 "aps" 내 "alert" 하위 값으로 들어갑니다

{
    "aps": {
        "alert": {
            "title": "일반",
            "body": "교내 출입문 3곳(상허문, 일감문, 건국문) 차량 통제 안내 - 2022학년도 수시모집 논술고사일 - "
        }
    },
}

putAllData(_:) 를 통해 주입된 값은 인스터스의 멤버 이름을 키값으로 하여 "aps" 와 동일한 레이어에 추가 됩니다.

{
    "aps": {  }
    "type": "notice",
    "articleId": "5b4924e",
    "postedDate": "20211109",
    "subject": "교내 출입문 3곳(상허문, 일감문, 건국문) 차량 통제 안내 - 2022학년도 수시모집 논술고사일 - ",
    "category": "normal",
    "categoryKorName": "일반",
    "baseUrl": "https://www.konkuk.ac.kr/do/MessageBoard/ArticleRead.do?id=5b4924e"
}

그리고 "aps" 와 데이터는 "payload"를 키로 갖는 값에 들어갑니다. (FCM 메세지 정보 문서)

{
    "message": {
        "apns": {
            "headers": {  }
            "payload": {
                "aps": {  }
                "type": "notice",
                "articleId": "5b4924e",
                "postedDate": "20211109",
                "subject": "교내 출입문 3곳(상허문, 일감문, 건국문) 차량 통제 안내 - 2022학년도 수시모집 논술고사일 - ",
                "category": "normal",
            }
        }
    }
}

앱에서의 처리

Notifications

PushNotifications 라이브러리에 정의된 Notifications 는 다음과 같은 푸시 알림 관련 로직을 처리합니다.

• 푸시 알림을 받기 위한 등록
• FCM 토큰 저장
• 들어온 푸시 알림 처리
• 푸시 알림을 탭했을 때 이벤트 퍼블리싱

Notifications 는 UIApplicationDelegate 를 준수하고 있기 때문에 @UIApplicationDelegateAdaptor 프로퍼티래퍼를 사용하여 SwiftUI 에서 사용할 수 있습니다.

import PushNotifictions

struct KuringApp: App {
    @UIApplicationDelegateAdaptor(Notifications.self) var appDelegate
}

newMessagePublisher

푸시 알림을 탭했을 때 Notifications 에서 newMessagePublisher 퍼블리셔를 통해 Message enum 타입으로 파싱된 객체를 퍼블리싱 합니다.
Message 는 .notice, .custom 두가지 케이스를 제공하고 있으며 associatedValue 를 가지고 필요한 액션을 처리할 수 있습니다.

ContentView()
    // MARK: 푸시 알림을 탭 했을 때 호출
    .onReceive(newMessagePublisher) { message in
        switch message {
        // 새 공지
        case let .notice(notice):
            self.newNotice = notice

        // 커스텀 알림
        case let .custom(title, body, link):
            guard let link, let url = URL(string: link) else { return }
            UIApplication.shared.open(url)
        }
}