[50살에 플러터 개발 도전기] 파이어스토어 Storage 설치 후 iOS 빌드 안되는 문제 해결하기

안녕하세요! 오늘은 Flutter 프로젝트에서 Firebase의 firebase_storage를 설치한 후 iOS 빌드가 안 되는 문제를 해결했던 경험을 공유하려고 합니다.

저는 50세의 남자로, Flutter 개발자가 되는 것을 꿈꾸고 있습니다.

때때로 개발 중에 예상치 못한 문제들이 발생하는데, 오늘도 그 중 하나를 해결했어요.

문제 발생

Flutter 프로젝트에 Firebase Storage를 추가한 후, iOS 빌드를 시도했더니 갑자기 빌드가 실패하는 문제가 발생했습니다.

오류 메시지나 특정한 힌트는 없었지만, 빌드가 되지 않는 상태였습니다.

몇 번의 시도 후, 문제가 Firebase 관련 라이브러리 버전 충돌 때문임을 알게 되었습니다.

해결 방법

문제를 해결하기 위해, Podfile과 Podfile.lock 파일을 수정해주었습니다.

1. Podfile 수정
ios/Podfile에서 FirebaseFirestore 버전 충돌 문제를 해결하기 위해, FirebaseFirestore의 버전을 명시적으로 설정해주었습니다. 제가 추가한 코드는 다음과 같습니다.

flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
//추가해야할 부분
pod 'FirebaseFirestore', :git => 'https://github.com/invertase/firestore-ios-sdk-frameworks.git', :tag => '11.4.0'
//
target 'RunnerTests' do
    inherit! :search_paths
  end
end

 

여기서 11.4.0 버전을 사용하려고 했습니다. firebase_storage와 firestore는 서로 다른 버전에서 충돌할 수 있기 때문에, 이 버전을 고정해주었습니다.

 

2. Podfile.lock 삭제
다음으로, Podfile.lock 파일을 삭제하여 이전의 의존성 캐시를 제거하고, 새로운 설정을 반영하도록 했습니다. 이를 위해 터미널에서 다음 명령어를 실행했습니다.

rm Podfile.lock
pod install

 

 

3. 최신 버전 적용
만약 나중에 버전이 바뀐다면, 위와 같은 방법으로 GitHub 주소를 통해 최신 버전을 사용하도록 설정할 수 있습니다.

최신 버전은 GitHub에서 제공하는 링크를 통해 쉽게 업데이트할 수 있기 때문에, 버전 관리에 유용합니다.

 

Podfile을 수정하고 Podfile.lock을 삭제한 후, pod install을 다시 실행하니 문제가 해결되었습니다.

이제 Firebase Storage가 정상적으로 작동하고, iOS 빌드가 문제없이 완료되었습니다.

최신 버전으로 업데이트하기

Firebase의 버전이 변경되면, GitHub에서 최신 버전을 확인한 후 Podfile을 수정하여 적용하면 됩니다.

예를 들어, FirebaseFirestore의 최신 버전이 11.5.0이라면, Podfile에 아래와 같이 변경하면 됩니다.

pod 'FirebaseFirestore', :git => 'https://github.com/invertase/firestore-ios-sdk-frameworks.git', :tag => '11.5.0'

이렇게 하면 Firebase의 최신 버전을 손쉽게 적용할 수 있습니다.

 

이번 문제는 Firebase SDK 버전 충돌로 인한 iOS 빌드 오류였습니다.

Podfile과 Podfile.lock을 적절히 수정한 후, 빌드가 정상적으로 되었습니다.

이러한 문제는 Flutter 개발을 하면서 자주 겪을 수 있기 때문에, 기본적인 CocoaPods 관리 방법을 알고 있으면 유용합니다.

앞으로도 개발 중에 만나는 다양한 문제들을 해결해 나가며, Flutter 개발자로서 한 걸음씩 나아가겠습니다.

 

 

구독!! 공감과 댓글,

광고 클릭은 저에게 큰 힘이 됩니다.

 

Starting Google Play App Distribution! "Tester Share" for Recruiting 20 Testers for a Closed Test.

Tester Share [테스터쉐어] - Google Play 앱