CocoaPods hat angekündigt dass es im Dezember 2026 in den schreibgeschützten Modus versetzt 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.
Übersicht
- Was ändert sich? CocoaPods wird in den schreibgeschützten Modus versetzt und Firebase wird ab Oktober 2026 keine neuen Versionen mehr in CocoaPods veröffentlichen.
- Wird meine App nicht mehr funktionieren? Nein. Vorhandene Versionen von Firebase-Bibliotheken bleiben in der CocoaPods-Registrierung auf unbestimmte Zeit verfügbar und Ihre Apps, die diese CocoaPod-Versionen verwenden, funktionieren weiterhin.
- Warum migrieren? Wenn Sie weiterhin die neuesten Funktionen, Leistungs verbesserungen und kritischen Fehlerkorrekturen erhalten möchten, sollten Sie zu Swift Package Manager oder manuellen Installationmigrieren.
Aufgrund der Ankündigung von CocoaPods wird Firebase ab Oktober 2026 keine neuen Versionen mehr in CocoaPods veröffentlichen. Diese Änderungen betreffen alle folgenden Pods und ihre Unterabhängigkeiten:
| 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, Firebase C++ SDK und FlutterFire.
Apple-Apps migrieren
Wenn Sie andere (nicht von Firebase stammende) Abhängigkeiten von CocoaPods migrieren, sollten Sie beachten, dass es in der Branche üblich ist, für das gesamte Projekt eine einzige Installationsmethode zu verwenden. Die Kombination von CocoaPods und Swift Package Manager (SPM) innerhalb desselben Ziels kann zu komplexen Abhängigkeitszyklen und Build-Fehlern führen. Wenn Ihre nicht von Firebase stammenden Abhängigkeiten SPM noch nicht unterstützen, ist die manuelle Installation von Firebase-Bibliotheken die stabilste Möglichkeit, Ihren Workflow bei der Migration zu konsolidieren.
Swift Package Manager (SPM)
Was ist Swift Package Manager?
Swift Package Manager (SPM) ist das native Tool von Apple für die 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-Datei mehr benötigt wird.
Zu Swift Package Manager migrieren
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-Installationsskripten basieren.
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 von Firebase stammenden Abhängigkeiten in ihren GitHub-Repositories oder auf den Produktseiten prüfen. Wenn einige Ihrer nicht von Firebase stammenden Abhängigkeiten SPM nicht unterstützen, ist die Verwendung der manuellen 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-Datei.
- 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 über Xcode. - Fügen Sie Ihre App-Abhängigkeiten mit File > Add Package Dependencies (Datei > Paketabhängigkeiten hinzufügen) wieder 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 Archiv Firebase.zip heruntergeladen, das vorkompilierte XCFrameworks für alle Firebase-Produkte enthält. So können Sie bestimmte SDKs direkt in Ihr Xcode-Projekt ziehen und ablegen, 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-Datei.
- 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
Für die meisten Unity- und Flutter-Entwickler ist keine Aktion erforderlich. Wenn Sie auf die neueste Version von Firebase unter Unity oder Flutter aktualisieren, wird Ihr zugrunde liegender Abhängigkeitsmanager auf Apple-Plattformen automatisch zu Swift Package Manager migriert.
Beachten Sie, dass Sie, wenn Sie nicht von Firebase stammende Abhängigkeiten über CocoaPods verwalten, diese möglicherweise manuell migrieren müssen.
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 kann ich meine App weiterhin ausführen?
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. Wir bieten keine offizielle Unterstützung für die Installation von Firebase direkt aus der Podspec-Datei, nachdem die Unterstützung für CocoaPods im Oktober 2026 eingestellt wurde. 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 kann?
Wir haben uns für Oktober entschieden, um sicherzustellen, dass die endgültigen Versionen, die in CocoaPods veröffentlicht werden, stabil sind, bevor die Registrierung im Dezember gesperrt wird. Dieser Zeitplan bietet einen notwendigen Puffer, um diese endgültigen Updates sicher zu koordinieren. Außerdem haben plattformübergreifende SDKs, die vom nativen SDK abhängig sind, aber verzögerte Release-Zyklen haben, genügend Zeit, ihre eigenen Releases vorzubereiten.
Funktioniert meine App nicht mehr, wenn ich sie nicht aktualisiere?
Nein. Diese Einstellung betrifft nur zukünftige Releases von Firebase-Bibliotheken. Vorhandene Versionen in CocoaPods können weiterhin installiert werden und bereitgestellte Apps, die diese Pod-Versionen verwenden, sind nicht betroffen.
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“ (Firebase-Bibliothek nicht gefunden). Wie kann ich das beheben?
Prüfen Sie, ob Sie das Firebase-Paket zu 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 in diesem Schritt vergessen, ein Framework hinzuzufügen, können Sie es jederzeit später in den Einstellungen Ihres Ziels unter Build Phases > Link Binary with Libraries (Build-Phasen > Binärdatei mit Bibliotheken verknüpfen) hinzufügen. Wenn Ihr Projekt mehrere Ziele enthält, prüfen Sie, ob Firebase zu den richtigen Zielen hinzugefügt wurde.
Wirkt sich diese Umstellung auf meine CI/CD-Pipelines aus?
Nein. Pipelines, die pod install oder pod update ausführen, funktionieren weiterhin für vorhandene Versionen. Sie rufen jedoch keine neuen Firebase-Bibliotheksupdates ab, die nach Oktober 2026 veröffentlicht wurden.