Flutter: include of non-modular header inside framework module 'firebase_core.FLTFirebasePlugin'

예전 프로젝트를 업데이트하고 다시 빌드하려는데, 갑자기 다음과 같은 에러가 발생했습니다.

include of non-modular header inside framework module 'firebase_core.FLTFirebasePlugin'

Firebase 관련 헤더 파일에서 발생하는 이 에러는 대부분 iOS의 Build Settings 설정 문제로 발생합니다. 처음에는 뭔가 복잡한 문제일 줄 알고 이것저것 시도해봤는데, 알고 보니 아주 간단한 설정 하나로 해결됐습니다.

해결 방법

1. Xcode에서 프로젝트를 엽니다.
2. 상단 탭에서 Build Settings로 이동한 후, All을 선택합니다.
3. 검색창에 Allow Non-modular Includes In Framework Modules를 입력합니다.
4. 해당 항목을 Yes로 변경합니다.
5. 변경 후, Clean(Build > Clean Build Folder) 을 하고 다시 빌드합니다.

이렇게 설정을 바꾸고 나니 오류 없이 정상적으로 빌드가 되었습니다.

정리

Flutter와 Firebase를 함께 사용할 때 iOS 쪽에서 종종 발생할 수 있는 이슈입니다. 만약 비슷한 에러로 빌드가 막히는 경우, 위 설정을 꼭 확인해보시길 추천드립니다. 간단하지만 놓치기 쉬운 부분이니, 예전 프로젝트를 다시 빌드할 때 한 번씩 체크해보면 좋습니다.