CocoaPods hat angekündigt, dass es im Dezember 2026 schreibgeschützt wird. Danach können keine neuen Pod-Versionen mehr veröffentlicht werden. In den folgenden Abschnitten finden Sie weitere Informationen zu dieser Änderung und dazu, wie Sie Ihre Apps zu anderen Installationsmanagern migrieren können.
Übersicht
- Was ändert sich? CocoaPods wird in den Lesemodus versetzt. Firebase 12 ist die letzte Hauptversion, die in CocoaPods veröffentlicht wird. Ab Oktober 2026 werden keine neuen Versionen von Firebase mehr in CocoaPods veröffentlicht.
- Wird meine App nicht mehr funktionieren? Nein. Vorhandene Versionen von Firebase-Bibliotheken sind weiterhin in der CocoaPods-Registrierung verfügbar. Ihre Apps, die diese CocoaPods-Versionen verwenden, funktionieren weiterhin, solange das CocoaPods-Ökosystem unterstützt wird.
- Warum migrieren? Wenn Sie weiterhin die neuesten Funktionen, Leistungsverbesserungen und wichtigen Fehlerkorrekturen erhalten möchten, sollten Sie die Verwendung auf Swift Package Manager oder die manuelle Installation umstellen.
Aufgrund der Ankündigung von CocoaPods werden ab Oktober 2026 keine neuen Firebase-Versionen mehr für CocoaPods veröffentlicht. Diese Änderungen wirken sich auf alle folgenden Pods und ihre Unterabhängigkeiten aus:
| Betroffene Firebase-Pods | ||
|---|---|---|
Firebase |
FirebaseAuth |
FirebaseInstallations |
FirebaseABTesting |
FirebaseCore |
FirebaseMessaging |
FirebaseAI |
FirebaseCrashlytics |
FirebaseMLModelDownloader |
FirebaseAILogic |
FirebaseDatabase |
FirebasePerformance |
FirebaseAnalytics |
FirebaseFirestore |
FirebaseRemoteConfig |
FirebaseAppCheck |
FirebaseFunctions |
FirebaseStorage |
FirebaseAppDistribution |
FirebaseInAppMessaging |
Diese Änderungen wirken sich zusätzlich auf alle Firebase-Distributionen aus, die das native Firebase Apple SDK umschließen, einschließlich des Firebase Unity SDK, des Firebase C++ SDK und von FlutterFire.
Apple-Apps migrieren
Wenn Sie andere (nicht Firebase-)Abhängigkeiten von CocoaPods migrieren, beachten Sie, dass es in der Branche als Best Practice gilt, eine einzelne Installationsmethode für Ihr gesamtes Projekt zu verwenden. Wenn Sie CocoaPods und Swift Package Manager (SPM) im selben Ziel verwenden, kann das zu komplexen Abhängigkeitszyklen und Build-Fehlern führen. Wenn Ihre Nicht-Firebase-Abhängigkeiten SPM noch nicht unterstützen, ist die manuelle Installation von Firebase-Bibliotheken die stabilste Methode, um Ihren Workflow während der Migration zu konsolidieren.
Swift Package Manager (SPM)
Was ist Swift Package Manager?
Swift Package Manager (SPM) ist das native Tool von Apple zur Verwaltung der Codeverteilung. Es ist direkt in Xcode integriert, sodass keine externen CLI-Tools wie CocoaPods erforderlich sind. Außerdem wird die Projektstruktur vereinfacht, da für die meisten Standardkonfigurationen keine .xcworkspace mehr benötigt wird.
Auf Swift Package Manager umstellen
Bei den meisten Projekten ist für die Migration zu Swift Package Manager keine Änderung des Anwendungscodes erforderlich, es sei denn, Ihr Projekt hat benutzerdefinierte Xcode-Konfigurationen oder Abhängigkeiten, die stark auf CocoaPods-Installationsskripts basieren.
So migrieren Sie von CocoaPods zu Swift Package Manager:
- Prüfen Sie, ob die einzelnen Abhängigkeiten Ihrer App Swift Package Manager unterstützen. Alle Firebase-Bibliotheken unterstützen SPM. Sie müssen jedoch die SPM-Unterstützung für Ihre Nicht-Firebase-Abhängigkeiten in den entsprechenden GitHub-Repositories oder Produktseiten prüfen. Wenn einige Ihrer Nicht-Firebase-Abhängigkeiten SPM nicht unterstützen, ist die manuelle Installation anstelle von SPM der stabilste Migrationspfad von CocoaPods.
- Entfernen Sie CocoaPods aus Ihrem Projekt, während Xcode geschlossen ist:
- Deinstallieren Sie Ihre CocoaPods-Abhängigkeiten, indem Sie den folgenden Befehl in Ihrem Projektverzeichnis ausführen:
pod deintegrate
- Löschen Sie die von CocoaPods generierte
.xcworkspace.
- Deinstallieren Sie Ihre CocoaPods-Abhängigkeiten, indem Sie den folgenden Befehl in Ihrem Projektverzeichnis ausführen:
- Aktualisieren Sie Ihr Projekt in Xcode mit Swift Package Manager-Abhängigkeiten:
- Öffnen Sie die
.xcodeproj-Datei Ihres Projekts in Xcode. - Fügen Sie die App-Abhängigkeiten mit File > Add Package Dependencies (Datei > Paketabhängigkeiten hinzufügen) noch einmal hinzu.
- Öffnen Sie die
- Nachdem das Firebase-Paket hinzugefügt wurde, können Sie die Firebase-Bibliotheken, von denen Sie abhängig sind, aktualisieren. Rufen Sie dazu die Projekteinstellungen in Xcode auf, wählen Sie Ihr App-Ziel aus und aktualisieren Sie die Bibliotheken unter Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte).
Weitere Informationen zur Verwendung von SPM in Xcode finden Sie in der Apple-Dokumentation.
Manuelle Installation
Was ist die manuelle Installation?
Bei der manuellen Installation wird das Firebase.zip-Archiv heruntergeladen, das vorkompilierte XCFrameworks für alle Firebase-Produkte enthält. So können Sie bestimmte SDKs per Drag-and-drop direkt in Ihr Xcode-Projekt einfügen, ohne einen Abhängigkeitsmanager zu verwenden.
Zur manuellen Installation migrieren
- Entfernen Sie CocoaPods aus Ihrem Projekt, während Xcode geschlossen ist:
- Deinstallieren Sie Ihre CocoaPods-Abhängigkeiten, indem Sie den folgenden Befehl in Ihrem Projektverzeichnis ausführen:
pod deintegrate
- Löschen Sie die von CocoaPods generierte
.xcworkspace.
- Deinstallieren Sie Ihre CocoaPods-Abhängigkeiten, indem Sie den folgenden Befehl in Ihrem Projektverzeichnis ausführen:
- Folgen Sie der Anleitung in unserem Installationsleitfaden, um Firebase manuell zu Ihrem Projekt hinzuzufügen.
Unity-, C++- und Flutter-Apps migrieren
Firebase Unity SDK und FlutterFire
Die meisten Unity- und Flutter-Entwickler müssen nichts weiter tun. Wenn Sie auf die neueste Version von Firebase für Unity oder Flutter aktualisieren, wird Ihr zugrunde liegender Abhängigkeitsmanager auf Apple-Plattformen automatisch zu Swift Package Manager migriert.
Wenn Sie Nicht-Firebase-Abhängigkeiten über CocoaPods verwalten, müssen Sie diese möglicherweise manuell migrieren.
Firebase C++ SDK
Wenn Sie die zugrunde liegenden iOS-Abhängigkeiten über CocoaPods eingebunden haben, können Sie die Migrationsanleitung oben befolgen, um Ihre Firebase-CocoaPod-Abhängigkeiten so zu aktualisieren, dass stattdessen Swift Package Manager verwendet wird.
FAQ
Ich muss CocoaPods auch nach Oktober 2026 verwenden. Wie kann ich dafür sorgen, dass meine App ausgeführt wird?
Sie können entweder die alten Versionen der Firebase-Pods verwenden oder die Firebase-Podspecs von GitHub kopieren und in Ihrem eigenen Specs-Repository hosten.
In beiden Fällen empfehlen wir Ihnen, so schnell wie möglich von CocoaPods zu migrieren. Nach der Einstellung der CocoaPods-Unterstützung im Oktober 2026 bieten wir keinen offiziellen Support mehr für die direkte Installation von Firebase über das Podspec. Wenn Sie Ihre eigenen Podspecs hosten, sind Sie dafür verantwortlich, sie auf dem neuesten Stand zu halten.
Warum wird die Unterstützung für CocoaPods im Oktober 2026 eingestellt, obwohl CocoaPods bis Dezember 2026 veröffentlicht werden können?
Wir haben uns für Oktober entschieden, damit die endgültigen Versionen, die auf CocoaPods veröffentlicht werden, stabil sind, bevor die Registrierung im Dezember gesperrt wird. Dieser Zeitrahmen bietet den nötigen Puffer, um diese letzten Updates sicher zu koordinieren. Außerdem wird so sichergestellt, dass plattformübergreifende SDKs, die vom nativen SDK abhängen, aber verzögerte Release-Zyklen haben, genügend Zeit haben, ihre eigenen Releases vorzubereiten.
Wird meine App nicht mehr funktionieren, wenn ich sie nicht aktualisiere?
Nein. Diese Einstellung betrifft nur zukünftige Versionen von Firebase-Bibliotheken. Firebase 12 ist die letzte Hauptversion, die in CocoaPods veröffentlicht wurde. Bestehende Versionen (Version 12 und früher) in CocoaPods können weiterhin installiert und verwendet werden, solange das CocoaPods-Ökosystem unterstützt wird.
Wirkt sich das auf die Projektabrechnung aus?
Nein.
Beim Kompilieren meines Projekts nach der Migration zu Swift Package Manager erhalte ich den Fehler „FirebaseLibrary not found“. Wie kann ich dies korrigieren?
Achten Sie darauf, dass Sie das Firebase-Paket zu Ihrem Xcode-Projekt hinzugefügt haben.
Wenn Sie das Firebase-Paket hinzufügen, werden Sie in Xcode aufgefordert, den Build-Zielen Ihrer App Firebase-Frameworks hinzuzufügen. Wenn Sie in diesem Schritt vergessen, ein Framework hinzuzufügen, können Sie es später in den Einstellungen des Ziels unter Build Phases > Link Binary with Libraries hinzufügen. Wenn Ihr Projekt mehrere Ziele enthält, muss Firebase den richtigen Zielen hinzugefügt werden.
Werden meine CI/CD-Pipelines durch diese Umstellung unterbrochen?
Nein. Pipelines, die pod install oder pod update ausführen, funktionieren für bestehende Versionen weiterhin. Es werden jedoch keine neuen Firebase-Bibliotheksupdates abgerufen, die nach Oktober 2026 veröffentlicht werden.