CocoaPods hat angekündigt, dass die Plattform 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 erfahren, wie Sie Ihre Anwendungen zu anderen Installationsmanagern migrieren.
Ü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 mehr in CocoaPods veröffentlicht.
- Wird meine App nicht mehr funktionieren? Nein. Vorhandene Versionen von Firebase-Bibliotheken bleiben in der CocoaPods-Registry verfügbar und 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 auf Swift Package Manager oder die manuelle Installation umstellen.
Aufgrund der Ankündigung von CocoaPods veröffentlicht Firebase ab Oktober 2026 keine neuen Versionen mehr für CocoaPods. 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-bezogene) Abhängigkeiten von CocoaPods migrieren, sollten Sie beachten, dass es sich bewährt hat, eine einzige Installationsmethode für Ihr gesamtes Projekt zu verwenden. Das Mischen von CocoaPods und Swift Package Manager (SPM) innerhalb desselben Ziels kann zu komplexen Abhängigkeitszyklen und Build-Fehlern führen. Wenn Ihre Nicht-Firebase-Abhängigkeiten SPM noch nicht unterstützen, ist die manuelle Installation für 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 Befehlszeilen-Tools wie CocoaPods erforderlich sind. Außerdem wird die Projektstruktur vereinfacht, da für die meisten Standardkonfigurationen keine .xcworkspace mehr erforderlich ist.
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 CocoaPods-Installationsskripts stark nutzen.
So migrieren Sie von CocoaPods zu Swift Package Manager:
- Prüfen Sie, ob alle 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 auf den Produktseiten prüfen. Wenn einige Ihrer Nicht-Firebase-Abhängigkeiten SPM nicht unterstützen, ist die manuelle Installation anstelle von SPM der stabilste Migrationspfad weg von CocoaPods.
- Entfernen Sie CocoaPods bei geschlossenem Xcode aus Ihrem Projekt:
- Deinstallieren Sie die 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 die 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 über Xcode. - Fügen Sie die App-Abhängigkeiten über Datei > Paketabhängigkeiten hinzufügen wieder hinzu.
- Öffnen Sie die
- Nachdem das Firebase-Paket hinzugefügt wurde, können Sie die Firebase-Bibliotheken, die Sie benötigen, aktualisieren. Rufen Sie dazu die Projekteinstellungen in Xcode auf, wählen Sie das App-Ziel aus und aktualisieren Sie die Bibliotheken unter Frameworks, Libraries, and Embedded Content.
Weitere Informationen zur Verwendung von SPM in Xcode finden Sie in der Apple-Dokumentation.
Manuelle Installation
Was ist eine 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 direkt per Drag-and-drop in Ihr Xcode-Projekt einfügen, ohne einen Abhängigkeitsmanager zu verwenden.
Zur manuellen Installation migrieren
- Entfernen Sie CocoaPods bei geschlossenem Xcode aus Ihrem Projekt:
- Deinstallieren Sie die 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 die CocoaPods-Abhängigkeiten, indem Sie den folgenden Befehl in Ihrem Projektverzeichnis ausführen:
- Folgen Sie den Schritten in unserem Installationsanleitung, 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 aktuelle Version von Firebase in Unity oder Flutter aktualisieren, wird der zugrunde liegende 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 der obigen Migrationsanleitung folgen, um Ihre Firebase-CocoaPod-Abhängigkeiten so zu aktualisieren, dass stattdessen Swift Package Manager verwendet wird.
FAQ
Ich muss CocoaPods nach Oktober 2026 weiterhin verwenden. Wie sorge ich dafür, dass meine App weiter ausgeführt wird?
Sie können entweder die alten Versionen von Firebase-Pods verwenden oder die Firebase-Podspecs von GitHub kopieren und in Ihrem eigenen Spezifikations-Repository hosten.
In beiden Fällen empfehlen wir, so bald wie möglich von CocoaPods zu migrieren. Nach der Einstellung des CocoaPods-Supports im Oktober 2026 bieten wir keinen offiziellen Support mehr für die Installation von Firebase direkt über die 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, wenn CocoaPods noch bis Dezember 2026 veröffentlicht werden können?
Wir haben den Oktober gewählt, damit die endgültigen Versionen, die auf CocoaPods veröffentlicht werden, stabil sind, bevor die Registry im Dezember gesperrt wird. Dieser Zeitplan bietet einen notwendigen 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 Releasezyklen haben, genügend Zeit haben, ihre eigenen Releases vorzubereiten.
Funktioniert meine App nicht mehr, 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 wird. Vorhandene Versionen (v12 und früher) in CocoaPods bleiben installierbar und funktionsfähig, solange das CocoaPods-Ökosystem unterstützt wird.
Wirkt sich das auf die Projektabrechnung aus?
Nein.
Ich erhalte den Fehler „FirebaseLibrary nicht gefunden“, wenn ich mein Projekt nach der Migration zu Swift Package Manager kompiliere. Wie kann ich dies korrigieren?
Achten Sie darauf, dass Sie das Firebase-Paket Ihrem Xcode-Projekt hinzugefügt haben.
Wenn Sie das Firebase-Paket hinzufügen, werden Sie von Xcode aufgefordert, Firebase-Frameworks zu den Build-Zielen Ihrer App hinzuzufügen. Wenn Sie vergessen, in diesem Schritt ein Framework hinzuzufügen, können Sie es später in den Einstellungen Ihres Ziels unter Build Phases > Link Binary with Libraries hinzufügen. Wenn Ihr Projekt mehrere Ziele enthält, müssen Sie Firebase den richtigen Zielen hinzufügen.
Werden meine CI/CD-Pipelines durch diese Umstellung unterbrochen?
Nein, Pipelines, die pod install oder pod update ausführen, funktionieren weiterhin für vorhandene Versionen. Sie erhalten jedoch keine neuen Firebase-Bibliotheksupdates, die nach Oktober 2026 veröffentlicht werden.