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. Poniżej znajdziesz informacje o wprowadzanych przez nas zmianach i ich przewidywanym wpływie na Twoje projekty.

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 modułu FirebaseFirestore, więc nie musisz już importować modułu FirebaseFirestoreSwift, aby uzyskać dostęp do tych interfejsów API.

Wszystkie rozszerzenia Swift są teraz częścią modułów głównych, więc pakiety SDK rozszerzeń nie są już wymagane i zostały wycofane. Włączenie lub użycie pakietów SDK rozszerzeń Swift spowoduje wyświetlenie ostrzeżenia kompilatora, a już w lutym 2024 r. całkowicie zaprzestaniemy wydawania rozszerzeń 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. Więcej informacji 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. Pakiety SDK rozszerzeń będą nadal dostępne do następnej dużej aktualizacji, ale podczas ich używania będzie wyświetlane ostrzeżenie o wycofaniu.

Już w lutym 2024 r.

Przestaniemy wydawać nowe wersje rozszerzeń Swift i usuniemy je z poziomu Package.swift w 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ź na karcie Ogólne w ustawieniach docelowej aplikacji do sekcji Ramy, biblioteki i zawartość osadzona 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 Twojego projektu od dodania sekcji frameworków dla docelowego pakietu SDK i usuń pakiet SDK rozszerzenia Swift (np. pod FirebaseFirestoreSwift). Następnie ponownie uruchom polecenie pod install.

Dystrybucja ZIP i Carthage

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 wcześniej używanych 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ć importowane rozszerzenie Swift importem głównego pakietu SDK, usuwając Swift na końcu wiersza.
2. Jeśli do odwołania się do dowolnych typów pakietu SDK rozszerzenia Swift używasz nazwy spakowanej w Swifta nazwy modułu, musisz ją zastąpić nazwą głównego pakietu SDK. Na przykład FirebaseFirestoreSwift.QueryPredicate należy zmienić na FirebaseFirestore.QueryPredicate.