Firebase iOS SDK, 2026년 10월부터 CocoaPods 배포 중단... SPM 마이그레이션 필수

iOS 앱에 Firebase를 붙여 쓰는 개발자라면 2026년 10월을 기점으로 설치 방식을 반드시 점검해야 합니다. 9년 6개월간 이어진 이 저장소(스타 6,840개)가 CocoaPods 배포를 멈추고 SPM 중심으로 전환하기 때문입니다. 이번 글에서는 바뀐 설치 정책과 권장 마이그레이션 경로, 새롭게 프리뷰로 열린 Gemini 기반 AI Logic까지 한눈에 정리합니다.

Firebase iOS SDK란 무엇인가요

Firebase iOS SDK 저장소는 2017년 4월에 처음 만들어져 9년 6개월 동안 이어져 온 애플 플랫폼용 Firebase 공식 SDK 소스 코드예요. ⭐ 6,840개, 포크 1,805개를 기록 중이며 주 언어는 C++이고 라이선스는 Apache-2.0이에요. Analytics를 제외한 모든 Firebase Apple 라이브러리가 이곳에 모여 있어요.

포함된 주요 프로덕트

• Firebase AI Logic (Gemini 파운데이션 모델 어댑터 미리보기 제공)
• Authentication (FirebaseAuth)
• Cloud Firestore
• Cloud Messaging (푸시 알림)
• Cloud Storage
• App Check
• App Distribution
• Crashlytics
• Performance Monitoring
• Remote Config
• In-App Messaging
• Vertex AI 연동 등

README에서는 Swift Package Manager(SPM) 사용을 권장하고 있어요. 2026년 10월부터 CocoaPods 배포가 중단되기 때문인데, 기존 CocoaPods 버전은 계속 쓸 수 있지만 새 버전은 SPM·GitHub·프레임워크·Carthage(실험적) 경로로만 받을 수 있어요. Swift 전용 래퍼(*Swift 접미사)가 있으면 그걸 쓰면 Swift 코드에서 더 자연스럽게 쓸 수 있어요.

https://github.com/firebase/firebase-ios-sdk

왜 지금 설치 방식을 바꿔야 하나요

2026년 10월부터 Firebase iOS SDK의 신규 버전이 CocoaPods에 올라오지 않습니다. 이미 배포된 버전은 계속 쓸 수 있지만, 앞으로 나올 기능·보안 패치·버그 수정을 받으려면 다른 설치 방식으로 옮겨야 해요. Firebase 팀은 Swift Package Manager(SPM)을 공식 권장 경로로 제시합니다.

왜 SPM으로 바꾸는 게 좋은가요

• Swift 네이티브 도구라 Xcode와 자연스럽게 통합되고 별도 Ruby 환경(CocoaPods)이 필요 없습니다.
• 의존성 그래프를 Xcode가 직접 관리해 빌드 속도가 빨라집니다(증분 빌드·병렬 처리 이점).
• 패키지 버전 관리가 Package.swift 한 파일로 끝나 설정 파일이 단순해집니다.
• Swift 전용 API(…Swift 접미사 라이브러리)를 바로 쓸 수 있어 코드가 더 간결해집니다.

1. Xcode에서 패키지 추가

   File → Add Package Dependencies → 저장소 URL(https://github.com/firebase/firebase-ios-sdk) 입력 → 원하는 제품 선택

2. CocoaPods 의존성 제거

   Podfile에서 Firebase 관련 pod 줄 삭제 → pod deintegrate 실행 → xcworkspace 대신 xcodeproj 열기

3. 빌드·테스트

   Clean Build Folder(⇧⌘K) 후 빌드해 SPM 기반으로 정상 동작하는지 확인

지금부터 SPM으로 전환해 두면 10월 이후에도 새 SDK를 막힘 없이 받아 쓸 수 있고, Swift 중심 개발 환경의 이점도 바로 누릴 수 있습니다.

설치·마이그레이션 3단계 따라하기

Firebase iOS SDK는 현재 5가지 설치 방법(SPM·CocoaPods·GitHub 직접 설치·Carthage·바이너리 프레임워크)을 지원합니다. 그 중 Swift Package Manager(SPM) 가 가장 권장되는 경로이며, 이번 섹션에서는 CocoaPods에서 SPM으로 전환하는 구체적인 3단계를 안내드릴게요.

먼저 기존 CocoaPods 설정을 정리하고, Xcode 프로젝트에 SPM을 추가한 뒤, 빌드를 정리하고 테스트하면 마이그레이션이 완료됩니다. 이 과정을 차근차근 따라 하면 기존 코드와 설정을 크게 바꾸지 않고도 최신 Firebase 버전을 사용할 수 있어요.

1. 1️⃣ CocoaPods 설정 제거

   Podfile에서 Firebase 관련 pod 선언을 삭제하고, pod install을 다시 실행해 남은 CocoaPods 캐시를 정리합니다.

2. 2️⃣ SPM으로 Firebase 추가

   Xcode → File → Add Packages… 메뉴에서 https://github.com/firebase/firebase-ios-sdk 를 입력하고, 최신 버전을 선택해 FirebaseAnalytics 등 필요한 제품을 추가합니다. Swift suffix가 있는 라이브러리를 선택하면 Swift 코드와 더 잘 맞아요.

3. 3️⃣ 빌드 정리 및 검증

   프로젝트를 Clean(Build → Clean Build Folder)하고, 앱을 실행해 Firebase 초기화가 정상 동작하는지 확인합니다. 콘솔에 오류가 없으면 마이그레이션 완료입니다.

한눈에 보는 설치 방식 비교표

CocoaPods에서 SPM으로 마이그레이션이 필요한 상황입니다. 기존 CocoaPods 버전은 계속 사용 가능하지만, 2026년 10월 이후 신규 버전이 제공되지 않으니 SPM 사용이 필수입니다.

1. SPM으로 마이그레이션

   1. Xcode에서 Swift Package Manager를 열고 Firebase 의존성 추가.

2. CocoaPods 사용 중단

   2. Podfile에서 Firebase 관련 줄을 제거하고 pod install 실행.

3. 확인 및 테스트

   3. 프로젝트 빌드 및 실행하여 정상 동작 여부 확인.

주의할 점: CocoaPods 유지 시 생기는 제약

CocoaPods로 계속 개발해도 기존 프로젝트는 당장 깨지지 않아요. 하지만 2026년 10월 이후 신규 버전이 CocoaPods에 올라오지 않기 때문에 Firebase AI Logic 프리뷰 같은 새 기능을 쓰거나 보안 패치를 제때 받으려면 결국 SPM으로 옮겨야 합니다. 미루면 미룰수록 의존성 충돌·빌드 스크립트 수정 등 기술 부채만 커집니다.

마이그레이션 체크리스트

• Podfile·Podfile.lock 백업 후 pod deintegrate 실행
• File ▸ Add Packages… 에서 https://github.com/firebase/firebase-ios-sdk 추가
• 필요 모듈(FirebaseAuth, FirebaseAI 등) 타깃에 연결
• import FirebaseCore 등 기존 import 문은 그대로 사용
• CI/CD 스크립트에서 pod install 제거·swift package resolve 추가
• 팀원·문서·온보딩 가이드 동시 업데이트

위 항목을 한 번에 다 하려 하지 말고, 다음 스프린트부터 하나씩 처리하면 리스크를 줄일 수 있습니다. 특히 Firebase AI Logic 프리뷰를 테스트하려면 SPM 전환이 선결 조건이므로, AI 기능 도입 계획이 있다면 우선순위를 높이세요.

정리: 지금 당장 할 일 체크리스트

Firebase iOS SDK의 최신 버전은 이번 달(2026년 10월)에 마지막으로 업데이트되었습니다. 이후 CocoaPods로는 신규 버전이 올라오지 않으니, 즉시 SPM 마이그레이션을 진행하셔야 합니다.

• SPM 추가 방법: Xcode > File > Swift Packages > Add Package Dependency
• 마이그레이션 가이드 링크: https://firebase.google.com/docs/ios/cocoapods-deprecation
• AI Logic 프리뷰 테스트 링크: https://firebase.google.com/docs/ai-logic/apple-foundation-models-framework/get-started

1. SPM에 Firebase 추가5분

   Xcode에서 File > Swift Packages > Add Package Dependency를 선택하고, https://github.com/firebase/firebase-ios-sdk 를 입력한 뒤, 원하는 Firebase 모듈(예: FirebaseAuth, FirebaseFirestore 등)을 선택합니다.

2. CocoaPods 사용 중단 준비3분

   pod install 명령은 2026년 10월까지는 동작하지만, 이후 버전 설치가 불가능합니다. 기존 프로젝트에 영향을 주지 않도록 SPM으로 전환합니다.

3. AI Logic 프리뷰 실행4분

   위 AI Logic 프리뷰 테스트 링크를 방문해 문서를 확인하고, FirebaseAI 모듈을 SPM으로 추가한 뒤, 샘플 코드를 실행해 동작을 검증합니다.

• SPM으로 Firebase 모듈 설치 완료
• AI Logic 프리뷰 테스트 실행
• 프로젝트 빌드 테스트

• 원문 보기