Przejdź na interfejsy API rozszerzeń Swift w modułach głównych

Łączymy pakiety SDK rozszerzeń Swift z głównymi pakietami SDK, aby interfejsy API Swift-native były szerzej dostępne i abyśmy mogli w przyszłości obsługiwać nowe funkcje języka Swift. Poniżej opisujemy zmiany, które wprowadzamy, oraz ich oczekiwany wpływ na Twoje projekty.

Co się zmienia?

Od wersji 10.17.0 pakietu SDK Firebase dla Apple pakiety SDK rozszerzeń Swift zostały scalone z odpowiednimi głównymi pakietami SDK. Na przykład wszystkie interfejsy API z modułu FirebaseFirestoreSwift zostały dodane do FirebaseFirestore, więc nie musisz już importować modułu FirebaseFirestoreSwift, aby uzyskać do nich dostęp.

Wszystkie rozszerzenia Swift są teraz częścią głównych modułów, więc pakiety SDK rozszerzeń nie są już wymagane i zostały wycofane. Dołączenie lub użycie pakietów SDK rozszerzeń Swift spowoduje wyświetlenie ostrzeżenia kompilatora, a już w lutym 2024 r. całkowicie przestaniemy udostępniać rozszerzenia Swift.

★ Uwaga: wszystkie obecnie lub wcześniej opublikowane wersje rozszerzeń Swift będą nadal działać. Zalecamy jednak przeniesienie aplikacji na interfejsy API Swift z głównego modułu, aby nadal otrzymywać poprawki i korzystać ze zmian oraz nowych funkcji.

Ważne daty związane z tą zmianą

W październiku 2023 r.

Pakiety SDK rozszerzeń Swift zostały scalone z głównymi pakietami SDK, a następnie wycofane na rzecz głównych pakietów SDK. Informacje o tej zmianie znajdziesz w informacjach o wersji 10.17.0.

Teraz możesz używać interfejsów API pakietu SDK rozszerzenia Swift bezpośrednio z głównych modułów pakietu SDK. Korzystanie z pakietów SDK rozszerzeń będzie nadal możliwe do czasu wydania kolejnej wersji głównej, ale podczas używania będzie wyświetlane ostrzeżenie o wycofaniu.

Już w lutym 2024 r.

Przestaniemy publikować nowe wersje rozszerzeń Swift i usuniemy je z Package.swift Firebase. Starsze wersje będą nadal działać, ale nie będą otrzymywać aktualizacji.

Jak przejść na interfejsy API Swift-native z głównego modułu

Jeśli obecnie nie używasz pakietów SDK rozszerzeń Swift, nie musisz nic robić. Jeśli używasz pakietu SDK rozszerzenia Swift, wprowadź w projekcie te zmiany.

Zmiany w obszarze roboczym

Swift Package Manager

Po zaktualizowaniu Firebase do wersji 10.17.0 lub nowszej przejdź do sekcji Frameworks, Libraries, and Embedded Content (Platformy, biblioteki i treści umieszczone) na karcie General (Ogólne) w ustawieniach celu i usuń pakiet SDK rozszerzenia Swift (np. FirebaseFirestoreSwift).

CocoaPods

Po zaktualizowaniu Firebase do wersji 10.17.0 lub nowszej otwórz plik Podfile i usuń wiersz odpowiadający zależności projektu od dodawania sekcji platform dla celu oraz usuń pakiet SDK rozszerzenia Swift (np. pod FirebaseFirestoreSwift). Następnie ponownie uruchom polecenie pod install.

Dystrybucja plików ZIP i Carthage

Po zaktualizowaniu Firebase do wersji 10.17.0 lub nowszej usuń z projektu wszystkie rozszerzenia Swift xcframeworks (np. FirebaseFirestoreSwift.xcframework).

Zmiany w kodzie źródłowym

W przypadku wszystkich używanych wcześniej pakietów SDK rozszerzeń Swift wykonaj te czynności:

  1. Usuń wszystkie instrukcje importu odwołujące się do pakietu SDK rozszerzenia Swift. Jeśli główny pakiet SDK nie został zaimportowany osobno, musisz zastąpić import rozszerzenia Swift importem głównego pakietu SDK, usuwając Swift na końcu wiersza.
  2. Jeśli do odwoływania się do typów pakietów SDK rozszerzeń Swift używasz jawnej przestrzeni nazw modułu Swift, musisz zastąpić je odpowiednim głównym pakietem SDK. Na przykład FirebaseFirestoreSwift.QueryPredicate trzeba zmienić na FirebaseFirestore.QueryPredicate.