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

Łączymy nasze pakiety SDK rozszerzeń Swift z głównymi pakietami SDK, aby szerzej udostępnić natywne interfejsy API w tej technologii i w przyszłości zwiększyć nasze możliwości obsługi nowych funkcji w tym języku. Wprowadzane przez nas zmiany i ich spodziewany wpływ na Twoje projekty znajdziesz poniżej.

Co się zmienia?

Począwszy od pakietu SDK Firebase dla Apple 10.17.0, pakiety SDK rozszerzeń Swift zostały scalone z odpowiadającymi im 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ą modułów głównych, więc pakiety SDK rozszerzeń nie są już wymagane i zostały wycofane. Uwzględnienie lub używanie pakietów SDK rozszerzeń Swift będzie skutkować ostrzeżeniem dotyczącym kompilatora, a w lutym 2024 r. całkowicie przestaniemy publikować rozszerzenia Swift.

★ Uwaga: wszystkie obecnie lub wcześniej opublikowane wersje rozszerzeń Swift będą nadal działać. Zalecamy jednak przeprowadzenie migracji aplikacji do interfejsów API Swift z modułu głównego, aby zapewnić sobie dostęp do poprawek oraz możliwości korzystania ze zmian i nowych funkcji.

Ważne daty dotyczące tej zmiany

W październiku 2023 r.

Pakiety SDK rozszerzeń Swift zostały połączone z głównymi pakietami SDK, a potem wycofane i zastąpione głównymi pakietami SDK. Zapoznaj się z informacjami o wersji 10.17.0, w których informujemy o tej zmianie.

Możesz teraz używać interfejsów API pakietu SDK rozszerzeń Swift bezpośrednio z głównych modułów SDK. Korzystanie z pakietów SDK rozszerzeń będzie możliwe do czasu pojawienia się kolejnej wersji głównej, ale w przypadku ich użycia pojawi się ostrzeżenie o wycofaniu.

Od lutego 2024 r.

Nie będziemy już udostępniać nowych wersji rozszerzeń Swift i usuniemy je z Package.swift Firebase. Starsze wersje będą nadal działać, ale nie będą otrzymywać aktualizacji.

Przejście na natywne interfejsy API w języku Swift z modułu głównego

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 poniższe zmiany.

Zmiany w obszarze roboczym

Menedżer pakietów Swift

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

CocoaPods

Po zaktualizowaniu Firebase do wersji 10.17.0 przejdź do pliku Podfile i usuń wiersz odpowiadający zależności projektu od dodania sekcji platform dla celu oraz usuń pakiet SDK rozszerzenia Swift (np. pod FirebaseFirestoreSwift). Następnie ponownie uruchom polecenie pod install.

Dystrybucja kodu i Kartagina

Po zaktualizowaniu Firebase do wersji 10.17.0 lub nowszej usuń wszystkie rozszerzenia Swift xcframeworks w projekcie (takie jak FirebaseFirestoreSwift.xcframework).

Zmiany w kodzie źródłowym

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

Usuń wszystkie instrukcje importu, które odwołują się do pakietu SDK rozszerzenia Swift. Jeśli główny pakiet SDK nie został zaimportowany oddzielnie, musisz zastąpić import rozszerzenia Swift importem głównego pakietu SDK, usuwając Swift na końcu wiersza.
Jeśli do odwoływania się do dowolnych typów pakietów SDK rozszerzeń Swift używasz jawnych nazw modułów w tym module, musisz zastąpić te pakiety odpowiednim głównym pakietem SDK. Na przykład FirebaseFirestoreSwift.QueryPredicate należy zmienić na FirebaseFirestore.QueryPredicate.