Zu den Swift-Erweiterungs-APIs in den Hauptmodulen migrieren

Wir führen unsere Swift-Erweiterungs-SDKs mit den Haupt-SDKs zusammen, Swift-native APIs sind breiter verfügbar und bieten mehr Unterstützung Swift-Sprachfunktionen hinzu. Welche Änderungen wir vornehmen, und die erwarteten Auswirkungen auf Ihre Projekte sind unten dokumentiert.

Was ändert sich?

Ab dem Firebase for Apple SDK 10.17.0 wurden die Swift-Erweiterungs-SDKs in die entsprechenden Haupt-SDKs zusammengeführt. Zum Beispiel könnten alle APIs aus dem Modul FirebaseFirestoreSwift wurden zu FirebaseFirestore hinzugefügt, Sie müssen also nicht mehr das Modul FirebaseFirestoreSwift importieren, um auf für diese APIs.

Da alle Swift-Erweiterungen jetzt Teil der Hauptmodule sind, sind die Erweiterungs-SDKs nicht mehr erforderlich und werden eingestellt. Swift nutzen Erweiterungs-SDKs eine Compiler-Warnung auslösen. Ab Februar 2024 stellen wir die Veröffentlichung der Swift-Erweiterungen ein.

★ Hinweis: Alle derzeit oder in der Vergangenheit veröffentlichten Versionen der Swift-Erweiterungen funktionieren weiterhin. Wir empfehlen Ihnen jedoch, Ihre App zu migrieren, Swift APIs aus dem Hauptmodul, damit Sie weiterhin Fehlerkorrekturen erhalten und um von Änderungen und neuen Funktionen zu 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. Weitere Informationen zu dieser Änderung finden Sie in den Versionshinweisen zu Version 10.17.0.

Sie können die Swift Extension 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. Bei der Verwendung wird jedoch eine Warnung zur Einstellung angezeigt.

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 bleiben erhalten funktioniert, erhält aber keine Updates.

So migrieren Sie vom Hauptmodul zu den nativen Swift-APIs

Wenn Sie die SDKs der Swift-Erweiterung derzeit nicht verwenden, müssen Sie nichts weiter tun. Wenn Sie ein Swift-Erweiterungs-SDK verwenden, nehmen Sie die folgenden Änderungen an Ihrem Projekt vor.

Änderungen im Arbeitsbereich

Swift Package Manager

Nachdem Sie Firebase auf Version 10.17.0 oder höher aktualisiert haben, rufen Sie die Frameworks auf, Bibliotheken und eingebetteter Inhalte auf dem Tab „Allgemein“ der Einstellungen und entfernen Sie das SDK für die Swift-Erweiterung (z. B. FirebaseFirestoreSwift).

CocoaPods

Nachdem Sie Firebase auf Version 10.17.0 oder höher aktualisiert haben, rufen Sie Ihre Podfile-Datei auf und entfernen Sie die Zeile, die der Abhängigkeit Ihres Projekts vom Hinzufügen der Frameworks entspricht für Ihr Ziel und entfernen Sie das SDK für die Swift-Erweiterung. (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:

1. Löschen Sie alle Importanweisungen, die auf das Swift-Erweiterungs-SDK verweisen. Wenn der Parameter Haupt-SDK nicht separat importiert wurde, müssen Sie das Swift- Erweiterungsimport mit dem SDK-Hauptimport durch Löschen der Swift im das Ende der Zeile.
2. Wenn Sie die explizite Modul-Namensgebung von Swift verwendet haben, um auf SDK-Typen von Swift-Erweiterungen zu verweisen, müssen Sie diese durch das entsprechende Haupt-SDK ersetzen. FirebaseFirestoreSwift.QueryPredicate müsste beispielsweise auf umbenannt in FirebaseFirestore.QueryPredicate.