Wir führen unsere Swift-Erweiterungs-SDKs in die Haupt-SDKs ein, um nativ in Swift geschriebene APIs breiter verfügbar zu machen und unsere Möglichkeiten zur Unterstützung neuer Swift-Sprachfunktionen in Zukunft zu verbessern. Unten finden Sie Informationen zu den geplanten Änderungen und ihren erwarteten Auswirkungen auf Ihre Projekte.
Was ändert sich?
Ab dem 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. Durch Einbinden oder Verwenden der Swift-Erweiterungs-SDKs wird eine Compiler-Warnung ausgelöst. Ab Februar 2024 werden die Swift-Erweiterungen dann nicht mehr veröffentlicht.
★ Hinweis: Alle derzeit oder in der Vergangenheit veröffentlichten Versionen der Swift-Erweiterungen funktionieren weiterhin. Wir empfehlen jedoch, Ihre App auf die Verwendung von Swift APIs aus dem Hauptmodul umzustellen, damit Sie weiterhin Fehlerkorrekturen erhalten und Änderungen und neue Funktionen nutzen können.
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 finden Sie in den Versionshinweisen zu Version 10.17.0, in der diese Änderung angekündigt wird.
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. Bei der Verwendung wird jedoch eine Warnung zur Einstellung angezeigt.
Bereits 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 mehr.
Migration zur Verwendung von nativen Swift-APIs aus dem Hauptmodul
Wenn Sie die Swift-Erweiterungs-SDKs derzeit nicht verwenden, sind keine Maßnahmen erforderlich. 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 des Ziels auf dem Tab „Allgemein“ 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 Ihre Podfile auf und entfernen Sie die Zeile, die der Abhängigkeit Ihres Projekts vom Hinzufügen des Abschnitts „Frameworks“ für Ihr Ziel entspricht. Entfernen Sie auch 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).
Quellcodeänderungen
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-Namensgebung von Swift verwendet haben, um auf SDK-Typen von Swift-Erweiterungen zu verweisen, müssen Sie diese durch das entsprechende Haupt-SDK ersetzen. Beispiel:
FirebaseFirestoreSwift.QueryPredicatemuss inFirebaseFirestore.QueryPredicateumbenannt werden.