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 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 sind weiterhin auf unbestimmte Zeit in der CocoaPods-Registrierung verfügbar und Ihre Apps, die diese CocoaPod-Versionen verwenden, funktionieren weiterhin.
- 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 mischen, 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 zum Verwalten 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.
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, bei denen Installationsskripts von CocoaPods intensiv verwendet werden.
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 in den GitHub-Repositories oder auf den Produktseiten Ihrer Nicht-Firebase-Abhängigkeiten nachsehen, ob diese SPM unterstützen. 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, wenn 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 über File > Add Package Dependencies (Datei > Paketabhängigkeiten hinzufügen) noch einmal hinzu.
- Öffnen Sie die
- Nachdem Sie das Firebase-Paket hinzugefügt haben, können Sie die Firebase-Bibliotheken, von denen Sie abhängig sind, 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 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, wenn 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 in Unity oder Flutter aktualisieren, wird Ihr zugrunde liegender Abhängigkeitsmanager auf Apple-Plattformen automatisch zu Swift Package Manager migriert.
Beachten Sie, dass Sie Nicht-Firebase-Abhängigkeiten über CocoaPods möglicherweise manuell migrieren müssen.
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 zu aktualisieren und stattdessen Swift Package Manager zu verwenden.
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. Nachdem die Unterstützung für CocoaPods im Oktober 2026 eingestellt wurde, bieten wir keinen offiziellen Support für die direkte Installation von Firebase über die Podspec-Datei mehr an. 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 in 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. 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“. 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 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, 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. Es werden jedoch keine neuen Firebase-Bibliotheksupdates abgerufen, die nach Oktober 2026 veröffentlicht werden.