Wir führen unsere Swift-Erweiterungs-SDKs mit den Haupt-SDKs zusammen, um Swift-native APIs breiter verfügbar zu machen und unsere Fähigkeit zu erhöhen, in Zukunft neue Swift-Sprachfunktionen zu unterstützen. Die von uns vorgenommenen Änderungen und ihre erwarteten Auswirkungen auf Ihre Projekte sind unten dokumentiert.
Was ändert sich?
Beginnend mit Firebase für Apple SDK 10.17.0 wurden die Swift-Erweiterungs-SDKs in ihre entsprechenden Haupt-SDKs zusammengeführt. Beispielsweise wurden alle APIs aus dem FirebaseFirestoreSwift -Modul zu FirebaseFirestore hinzugefügt, sodass Sie das FirebaseFirestoreSwift Modul nicht mehr importieren müssen, um auf diese APIs zuzugreifen.
Da alle Swift-Erweiterungen jetzt Teil der Hauptmodule sind, sind die Erweiterungs-SDKs nicht mehr erforderlich und veraltet. Das Einbinden oder Verwenden der Swift-Erweiterungs-SDKs führt zu einer Compiler-Warnung und bereits im Februar 2024 werden wir die Veröffentlichung der Swift-Erweiterungen vollständig einstellen.
★ Hinweis: Alle aktuell oder zuvor veröffentlichten Versionen der Swift-Erweiterungen funktionieren weiterhin. Wir empfehlen jedoch, dass Sie Ihre App migrieren, um Swift-APIs vom Hauptmodul zu verwenden, um sicherzustellen, dass Sie weiterhin Korrekturen erhalten und von Änderungen und neuen Funktionen profitieren können.
Wichtige Termine für diese Änderung
Im Oktober 2023
Die Swift-Erweiterungs-SDKs wurden mit den Haupt-SDKs zusammengeführt und dann zugunsten der Haupt-SDKs veraltet. Sehen Sie sich die Versionshinweise für Version 10.17.0 an, in denen diese Änderung angekündigt wird.
Sie können jetzt die SDK-APIs der Swift-Erweiterung direkt aus den Haupt-SDK-Modulen verwenden. Die Verwendung der Erweiterungs-SDKs ist bis zur Veröffentlichung der nächsten Hauptversion weiterhin möglich, führt jedoch bei Verwendung zu einer veralteten Warnung.
Bereits im Februar 2024
Wir werden die Veröffentlichung neuer Versionen der Swift-Erweiterungen einstellen und die Swift-Erweiterungen aus Package.swift von Firebase entfernen. Ältere Versionen funktionieren weiterhin, erhalten jedoch keine Updates.
So migrieren Sie vom Hauptmodul zur Verwendung von Swift-nativen APIs
Wenn Sie die Swift-Erweiterungs-SDKs derzeit nicht verwenden, ist keine Aktion erforderlich. Wenn Sie ein Swift-Erweiterungs-SDK verwenden, nehmen Sie die folgenden Änderungen in Ihrem Projekt vor.
Arbeitsbereichsänderungen
Swift-Paketmanager
Navigieren Sie nach dem Update von Firebase auf Version 10.17.0+ zum Abschnitt „Frameworks, Bibliotheken und eingebettete Inhalte“ auf der Registerkarte „Allgemein“ der Einstellungen Ihres Ziels und entfernen Sie das Swift-Erweiterungs-SDK (z. B. FirebaseFirestoreSwift ).
Kakaokapseln
Navigieren Sie nach dem Update von Firebase auf Version 10.17.0+ zu Ihrer Poddatei und entfernen Sie die Zeile, die der Abhängigkeit Ihres Projekts vom Hinzufügen des Frameworks-Abschnitts für Ihr Ziel entspricht, und entfernen Sie das Swift-Erweiterungs-SDK (z. B. Pod FirebaseFirestoreSwift ). Führen Sie dann den pod install erneut aus.
Postleitzahlenverteilung und Karthago
Entfernen Sie nach dem Update von Firebase auf Version 10.17.0+ alle Swift-Erweiterungen xcframeworks in Ihrem Projekt (z. B. FirebaseFirestoreSwift.xcframework ).
Änderungen am Quellcode
Führen Sie für alle Swift-Erweiterungs-SDKs, die Sie zuvor verwendet haben, die folgenden Aktionen 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 Swift-Erweiterungsimport durch den Haupt-SDK-Import ersetzen, indem Sie
Swiftam Ende der Zeile löschen. - Wenn Sie Swifts expliziten Modul-Namespace verwendet haben, um auf beliebige Swift-Erweiterungs-SDK-Typen zu verweisen, müssen Sie diese durch das entsprechende Haupt-SDK ersetzen. Beispielsweise müsste
FirebaseFirestoreSwift.QueryPredicateinFirebaseFirestore.QueryPredicateumbenannt werden.