Wir führen unsere Swift-Erweiterungs-SDKs in die 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 in die 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, werden die Erweiterungs-SDKs nicht mehr benötigt und sind eingestellt. Wenn Sie die Swift-Erweiterungs-SDKs einbinden oder verwenden, wird eine Compiler-Warnung ausgegeben. Ab Februar 2024 werden wir die Swift-Erweiterungen nicht mehr veröffentlichen.
★ Hinweis: Alle aktuell 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 Änderungen und neue Funktionen nutzen.
Wichtige Termine für diese Änderung
Oktober 2023
Die Swift-Erweiterungs-SDKs wurden in die Haupt-SDKs zusammengeführt und dann zugunsten der Haupt-SDKs eingestellt. In den Versionshinweisen zu Version 10.17.0 finden Sie weitere Informationen zu dieser Änderung.
Sie können die Swift-Erweiterungs-SDK-APIs 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 SDKs eingestellt werden.
Bereits ab Februar 2024
Wir werden keine neuen Versionen der Swift-Erweiterungen mehr veröffentlichen und die Swift-Erweiterungen aus dem Package.swift von Firebase entfernen. Ältere Versionen funktionieren weiterhin, erhalten aber keine Updates mehr.
Migration zur Verwendung von Swift-nativen APIs aus dem Hauptmodul
Wenn Sie die Swift-Erweiterungs-SDKs derzeit nicht verwenden, müssen Sie nichts unternehmen. 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 im Tab „Allgemein“ der Einstellungen Ihres Ziels den Bereich „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 beim Hinzufügen des Frameworks entspricht. Entfernen Sie außerdem den Abschnitt „Frameworks“ für Ihr Ziel und 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 Swift-Erweiterungs-SDKs, die Sie zuvor verwendet haben, 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 Swift-Erweiterungsimport durch den Haupt-SDK-Import ersetzen, indem Sie das
Swiftam Ende der Zeile löschen. - Wenn Sie die explizite Modul-Namespace-Funktion von Swift verwendet haben, um auf Swift-Erweiterungs-SDK-Typen zu verweisen, müssen Sie diese durch das entsprechende Haupt-SDK ersetzen. Beispiel:
FirebaseFirestoreSwift.QueryPredicatemüsste inFirebaseFirestore.QueryPredicateumbenannt werden.