Wir führen unsere Swift-Erweiterungs-SDKs mit den Haupt-SDKs zusammen, um Swift-native APIs breiter verfügbar zu machen und neue Swift-Sprachfunktionen in Zukunft besser unterstützen zu können. Die Änderungen, die wir vornehmen, und die erwarteten Auswirkungen auf Ihre Projekte sind unten dokumentiert.
Was ändert sich?
Ab Firebase for Apple SDK 10.17.0 wurden die Swift-Erweiterungs-SDKs mit den entsprechenden Haupt-SDKs zusammengeführt. Beispielsweise wurden alle APIs aus dem Modul FirebaseFirestoreSwift zu FirebaseFirestore hinzugefügt. Sie müssen das Modul FirebaseFirestoreSwift also nicht mehr importieren, um auf diese APIs zuzugreifen.
Da alle Swift-Erweiterungen jetzt Teil der Hauptmodule sind, sind die Erweiterungs-SDKs nicht mehr erforderlich und werden eingestellt. Wenn Sie die Swift-Erweiterungs-SDKs einbinden oder verwenden, wird eine Compilerwarnung ausgegeben. Ab Februar 2024 werden die Swift-Erweiterungen nicht mehr veröffentlicht.
★ Hinweis: Alle derzeit oder zuvor veröffentlichten Versionen der Swift-Erweiterungen funktionieren weiterhin. Wir empfehlen jedoch, Ihre App so zu migrieren, dass Swift APIs aus dem Hauptmodul verwendet werden. So erhalten Sie weiterhin Fehlerkorrekturen und können von Änderungen und neuen Funktionen profitieren.
Wichtige Termine für diese Änderung
Im Oktober 2023
Die Swift-Erweiterungs-SDKs wurden in die Haupt-SDKs zusammengeführt und dann zugunsten der Haupt-SDKs eingestellt. In den Versionshinweisen für Version 10.17.0 wird diese Änderung angekündigt.
Sie können die APIs des Swift-Erweiterungs-SDKs jetzt direkt über die Haupt-SDK-Module verwenden. Die Verwendung der Erweiterungs-SDKs ist bis zur Veröffentlichung der nächsten Hauptversion weiterhin möglich, führt jedoch zu einer Warnung, dass die Funktion eingestellt wurde.
Ab Februar 2024
Wir werden keine neuen Versionen der Swift-Erweiterungen mehr veröffentlichen und die Swift-Erweiterungen aus der Package.swift von Firebase entfernen. Ältere Versionen funktionieren weiterhin, erhalten aber keine Updates.
So migrieren Sie zu Swift-nativen APIs aus dem Hauptmodul
Wenn Sie die Swift-Erweiterungs-SDKs derzeit nicht verwenden, müssen Sie nichts weiter tun. Wenn Sie ein Swift-Erweiterungs-SDK verwenden, nehmen Sie die folgenden Änderungen in Ihrem Projekt vor.
Änderungen im Arbeitsbereich
Swift Package Manager
Nachdem Sie Firebase auf Version 10.17.0 oder höher aktualisiert haben, rufen Sie in den Einstellungen Ihres Ziels auf dem Tab „General“ (Allgemein) den Bereich „Frameworks, Libraries, and Embedded Content“ (Frameworks, Bibliotheken und eingebettete Inhalte) auf und entfernen Sie das Swift-Erweiterungs-SDK (z. B. FirebaseFirestoreSwift).
CocoaPods
Nachdem Sie Firebase auf Version 10.17.0 oder höher aktualisiert haben, rufen Sie Ihr Podfile auf und entfernen Sie die Zeile, die der Abhängigkeit Ihres Projekts vom Hinzufügen des Frameworks-Abschnitts für Ihr Ziel entspricht. Entfernen Sie außerdem das Swift-Erweiterungs-SDK (z. B. Pod FirebaseFirestoreSwift). Führen Sie dann den Befehl pod install noch einmal aus.
ZIP-Verteilung und Carthage
Nachdem Sie Firebase auf Version 10.17.0 oder höher aktualisiert haben, entfernen Sie alle Swift-Erweiterungen xcframeworks in Ihrem Projekt (z. B. FirebaseFirestoreSwift.xcframework).
Änderungen am Quellcode
Führen Sie für alle zuvor verwendeten Swift-Erweiterungs-SDKs die folgenden Schritte aus:
- Löschen Sie alle Importanweisungen, die auf das Swift-Erweiterungs-SDK verweisen. Wenn das Haupt-SDK nicht separat importiert wurde, müssen Sie den Import der Swift-Erweiterung durch den Import des Haupt-SDKs ersetzen. Löschen Sie dazu das
Swiftam Ende der Zeile. - Wenn Sie die explizite Modul-Namespacing-Funktion von Swift verwendet haben, um auf Swift-Erweiterungs-SDK-Typen zu verweisen, müssen Sie diese durch das entsprechende Haupt-SDK ersetzen. Beispielsweise müsste
FirebaseFirestoreSwift.QueryPredicateinFirebaseFirestore.QueryPredicateumbenannt werden.