Przejdź na korzystanie z interfejsów API rozszerzenia Swift w głównych modułach

Łączymy nasze zestawy SDK rozszerzeń Swift z głównymi zestawami SDK, aby szerzej udostępnić natywne interfejsy API Swift i zwiększyć naszą zdolność do obsługi nowych funkcji języka Swift w przyszłości. Zmiany, które wprowadzamy i ich oczekiwany wpływ na Twoje projekty są udokumentowane poniżej.

Co się zmienia?

Począwszy od Firebase dla Apple SDK 10.17.0, zestawy SDK rozszerzenia Swift zostały połączone z odpowiadającymi im głównymi zestawami SDK. Na przykład wszystkie interfejsy API z modułu FirebaseFirestoreSwift zostały dodane do FirebaseFirestore , więc nie trzeba już importować modułu FirebaseFirestoreSwift , aby uzyskać dostęp do tych interfejsów API.

Ponieważ wszystkie rozszerzenia Swift są teraz częścią głównych modułów, zestawy SDK rozszerzeń nie są już wymagane i są przestarzałe. Dołączenie lub używanie zestawów SDK rozszerzeń Swift spowoduje wyświetlenie ostrzeżenia dla kompilatora i już w lutym 2024 r. całkowicie przestaniemy udostępniać rozszerzenia Swift.

★ Uwaga: wszelkie obecnie lub wcześniej wydane wersje rozszerzeń Swift będą nadal działać. Zalecamy jednak migrację aplikacji w celu korzystania z interfejsów API Swift z modułu głównego, aby mieć pewność, że nadal będziesz otrzymywać poprawki i będziesz mógł korzystać ze zmian i nowych funkcji.

Ważne daty dla tej zmiany

W październiku 2023 r

Zestawy SDK rozszerzenia Swift zostały połączone z głównymi zestawami SDK, a następnie wycofane na rzecz głównych zestawów SDK. Zobacz informacje o wersji 10.17.0 informujące o tej zmianie.

Możesz teraz korzystać z interfejsów API SDK rozszerzenia Swift bezpośrednio z głównych modułów SDK. Korzystanie z zestawów SDK rozszerzeń będzie nadal możliwe aż do wydania następnej wersji głównej, ale ich użycie spowoduje wyświetlenie ostrzeżenia o wycofaniu.

Już w lutym 2024 r

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

Jak przeprowadzić migrację, aby korzystać z natywnych interfejsów API Swift z modułu głównego

Jeśli obecnie nie używasz pakietów SDK rozszerzenia Swift, nie jest konieczne żadne działanie. Jeśli korzystasz z pakietu SDK rozszerzenia Swift, wprowadź następujące zmiany w swoim projekcie.

Zmiany obszaru roboczego

Szybki menedżer pakietów

Po zaktualizowaniu Firebase do wersji 10.17.0 lub nowszej przejdź do sekcji Struktury, biblioteki i zawartość osadzona na karcie Ogólne w ustawieniach celu i usuń pakiet SDK rozszerzenia Swift (taki jak FirebaseFirestoreSwift ).

CocoaPods

Po zaktualizowaniu Firebase do wersji 10.17.0+ przejdź do swojego Podfile i usuń linię odpowiadającą zależności twojego projektu od dodania sekcji frameworków dla swojego celu i usuń SDK rozszerzenia Swift (takie jak pod FirebaseFirestoreSwift ). Następnie uruchom ponownie polecenie pod install .

Dystrybucja zip i Kartagina

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

Zmiany w kodzie źródłowym

W przypadku wszystkich używanych wcześniej zestawów SDK rozszerzenia Swift wykonaj następujące czynności:

Usuń wszystkie instrukcje importu odwołujące się do pakietu SDK rozszerzenia Swift. Jeśli główny pakiet SDK nie został zaimportowany oddzielnie, konieczne będzie zastąpienie importu rozszerzenia Swift głównym importem pakietu SDK poprzez usunięcie Swift na końcu linii.
Jeśli użyłeś jawnej przestrzeni nazw modułów Swift do odwoływania się do dowolnego typu zestawu SDK rozszerzenia Swift, będziesz musiał zastąpić je odpowiednim głównym zestawem SDK. Na przykład nazwę FirebaseFirestoreSwift.QueryPredicate należy zmienić na FirebaseFirestore.QueryPredicate .