[iOS] Firebase 7.0.0 업데이트 트러블 슈팅

프로젝트에 적용되어 있던 Firebase 라이브러리들을 6버전대에서 7버전대(7.0.0~)로 업데이트하면서 발생한 이슈들에 대한 기록입니다. 

 

---

Error 1

 

🗒 에러 메세지

Parameter of 'messaging(_:didReceiveRegistrationToken:)' has different optionality than required by protocol 'MessagingDelegate'

 

 

🚀 에러 원인

FirebaseMessaging 7.0.0에서 토큰 삭제 문제를 해결하기 위해 옵션이 변경되었습니다. 삭제된 토큰에 대해 이 메서드는 fcmToken값 nil로 호출됩니다.

 

 

🚀 해결 방법

BEFORE

func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String) {
    print("Firebase registration token: \(String(describing: fcmToken))")
    let dataDict:[String: String] = ["token": fcmToken]
}

 

AFTER

func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
    print("Firebase registration token: \(String(describing: fcmToken))")
    let dataDict:[String: String] = ["token": fcmToken ?? ""]
}

- fcmToken의 타입을 String에서 String?으로 수정

- dataDict nil값 처리 (?? "" 추가)

 

 

---

 

 

Error 2

 

🗒 에러 메세지

Cannot find type 'MessagingRemoteMessage' in scope

 

 

🚀 에러 원인

FirebaseMessaging 7.0.0에서 메서드 타입이 변경되었습니다.

 

 

🚀 해결 방법

BEFORE

func messaging(_ messaging: Messaging, didReceive remoteMessage: MessagingRemoteMessage) {
    print("Received data message: \(remoteMessage.appData)")
}

 

AFTER

func messaging(_ messaging: Messaging, didReceive remoteMessage: MessagingDelegate) {
    print("Received data message: \(remoteMessage.description)")
}

- remoteMessage의 타입을 MessagingRemoteMessage에서 MessagingDelegate로 수정

- appData를 description으로 수정

 

 

---

 

 

Error 3

 

🗒 에러 메세지

Framework not found FIRAnalyticsConnector

Framework not found Protobuf

 

 

🚀 에러 원인

FirebaseAnalytics가 의존성을 갖고 있던 FIRAnalyticsConnector와 FirebaseMessaging이 의존성을 갖고 있던 Protobuf가 Firebase7.0.0 업데이트와 함께 의존성이 제거되면서 기존 프로젝트의 Linker Flag에서도 제거가 필요해졌습니다.

 

 

🚀 해결 방법

Target > Build Settings > FIRAnalyticsConnector / Protobuf 검색 > Other Linker Flags에서 다음 라인 삭제

-framework
"FIRAnalyticsConnector"
-framework
"Protobuf"

 

 

* Other Linker Flag란?

Xcode 프로젝트에서 서드파티 라이브러리를 사용할 때, 컴파일 파임에 서드파티 라이브러리를 링크하기 위해 설정해주어야 하는 플래그입니다. 그 중에서도 -Objc 플래그는 링커가 Objective-C 클래스나 카테고리로 정의된 라이브러리에 속한 객체 파일들을 모두 적재하게 해 주는 플래그로, 가장 많이 사용되는 플래그 중 하나입니다.