문제 상황
CocoaPods를 통한 iOS 의존성 설치 중 다음과 같은 에러가 발생했습니다:
[!] :
In snapshot (Podfile.lock):
Firebase/Auth (= 11.0.0)
In Podfile:
firebase_auth depends on Firebase/Auth (= 11.6.0)발생 원인 분석
- Firebase 패키지 버전 간의 불일치
- CocoaPods 스펙 저장소의 만료
- Podfile.lock과 실제 의존성 요구사항의 충돌
에러 유형별 해결 방법
1. 버전 불일치 에러
Could not find compatible versions for pod "Firebase/Auth"해결 방법:
- pubspec.yaml의 Firebase 패키지 버전 동기화:
dependencies: firebase_core: ^2.24.2 firebase_auth: ^4.15.3 firebase_analytics: ^10.7.4- 이전 설치 정보 제거:
cd ios rm -rf Pods/ rm -rf Podfile.lock
2. CocoaPods 스펙 저장소 만료
Error: CocoaPods's specs repository is too out-of-date to satisfy dependencies.해결 방법:
pod repo remove trunk
pod setup
pod install3. 의존성 충돌
[!] CocoaPods could not resolve dependencies for target 'Runner'해결 방법:
- 의존성 캐시 정리:
pod deintegrate pod cache clean --all- Podfile 업데이트:
platform :ios, '12.0'
platform :ios, '12.0'
target 'Runner' do
use_frameworks!
use_modular_headers!
flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '12.0'
end
end
endCocoaPods 의존성 관리 이해하기
Podfile.lock의 역할
- 설치된 의존성의 정확한 버전을 기록
- 팀원 간 동일한 버전 사용 보장
- 의존성 잠금으로 예기치 않은 업데이트 방지
버전 지정 방식
pod 'Firebase/Auth', '11.6.0' # 정확한 버전
pod 'Firebase/Auth', '~> 11.6.0' # 패치 업데이트만 허용
pod 'Firebase/Auth', '>= 11.6.0' # 최소 버전 지정CDN vs. Git Sources
# CDN 사용
source 'https://cdn.cocoapods.org/'
# Git 소스 사용
pod 'CustomPod', :git => 'https://github.com/user/repo.git'종합적인 해결 프로세스
- 의존성 초기화:
cd ios rm -rf Pods/ rm -rf Podfile.lock pod deintegrate- CocoaPods 업데이트:
pod repo update pod install --repo-update- Flutter 프로젝트 클린:
cd .. flutter clean flutter pub get- 재설치:
cd ios pod install
문제 해결 Tips
- 버전 호환성 확인
- Firebase 등 주요 패키지의 호환성 매트릭스 확인
- Flutter 버전과 iOS 최소 지원 버전 확인
- Pod 설치 옵션
pod install --verbose # 자세한 로그 확인 pod update --no-repo-update # 저장소 업데이트 없이 설치 pod install --repo-update # 저장소 업데이트 포함 설치- CocoaPods 캐시 관리
# 특정 Pod 캐시 삭제 pod cache clean 'Firebase'
전체 캐시 삭제
pod cache clean --all
```