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 ihre 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, 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 wir die Swift-Erweiterungen nicht mehr veröffentlichen.
★ 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
Oktober 2023
Die Swift-Erweiterungs-SDKs wurden in die Haupt-SDKs zusammengeführt und dann zugunsten der Haupt-SDKs eingestellt. Weitere Informationen finden Sie in den Versionshinweisen zu Version 10.17.0, in denen diese Änderung angekündigt wird.
Sie können die Swift-Erweiterungs-SDK-APIs jetzt direkt aus den Haupt-SDK-Modulen verwenden. Die Verwendung der Erweiterungs-SDKs ist bis zur nächsten Hauptversion möglich, führt aber zu einer Warnung wegen der Einstellung.
Ab Februar 2024
Wir werden keine neuen Versionen der Swift-Erweiterungen mehr veröffentlichen und die Swift-Erweiterungen aus Package.swift von Firebase entfernen. Ältere Versionen funktionieren weiterhin, erhalten aber keine Updates mehr.
So migrieren Sie zur Verwendung von Swift-nativen APIs aus dem Hauptmodul
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.
Änderungen im Arbeitsbereich
Swift Package Manager
Aktualisieren Sie Firebase auf Version 10.17.0 oder höher. Rufen Sie dann in den Einstellungen Ihres Ziels den Tab „Allgemein“ auf und entfernen Sie im Bereich „Frameworks, Bibliotheken und eingebettete Inhalte“ das Swift-Erweiterungs-SDK (z. B. FirebaseFirestoreSwift).
CocoaPods
Aktualisieren Sie Firebase auf Version 10.17.0 oder höher. Rufen Sie dann Ihre Podfile auf und entfernen Sie die Zeile, die der Abhängigkeit Ihres Projekts vom Hinzufügen des Frameworks-Bereichs für Ihr Ziel entspricht, und entfernen Sie das Swift-Erweiterungs-SDK (z. B. pod FirebaseFirestoreSwift). Führen Sie dann den Befehl pod install noch einmal aus.
Zip-Distribution und Carthage
Aktualisieren Sie Firebase auf Version 10.17.0 oder höher und entfernen Sie alle xcframeworks der Swift-Erweiterung 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 Import der Swift-Erweiterung durch den Import des Haupt-SDK ersetzen. Löschen Sie dazu das
Swiftam Ende der Zeile. - Wenn Sie die explizite Modulnamensraumfunktion von Swift verwendet haben, um auf Typen des Swift-Erweiterungs-SDK zu verweisen, müssen Sie diese durch das entsprechende Haupt-SDK ersetzen. Beispielsweise muss
FirebaseFirestoreSwift.QueryPredicateinFirebaseFirestore.QueryPredicateumbenannt werden.