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

Łączymy pakiety SDK rozszerzeń Swift z głównymi pakietami SDK, aby udostępnić interfejsy API natywne dla Swifta większej liczbie użytkowników i w przyszłości lepiej obsługiwać nowe funkcje języka Swift. Poniżej znajdziesz informacje o wprowadzanych przez nas zmianach i ich przewidywanym wpływie na Twoje projekty.

Co się zmienia?

Od wersji 10.17.0 pakietu SDK Firebase dla Apple pakiety SDK rozszerzeń Swift zostały połączone z odpowiednimi 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ą głównych modułów, dlatego 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 i wcześniejsze wersje rozszerzeń Swift będą nadal działać. Zalecamy jednak przeniesienie aplikacji na interfejsy Swift z modułu głównego, aby mieć pewność, że nadal będziesz otrzymywać poprawki oraz korzystać z nowych funkcji i zmian.

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 na rzecz głównych pakietów 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. Do czasu wydania kolejnej głównej wersji pakietów SDK rozszerzeń będzie można nadal z nich korzystać, 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ą już aktualizowane.

Jak przejść na korzystanie z interfejsów API natywnych dla Swift w module głównym

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

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 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ń w projekcie wszystkie rozszerzenia Swiftxcframeworks (np.FirebaseFirestoreSwift.xcframework).

Zmiany w kodzie źródłowym

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

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. Aby to zrobić, usuń Swift na końcu wiersza.
Jeśli do odwołania się do dowolnych typów pakietu SDK rozszerzenia Swift używasz nazw modułów w ramach ścisłego przestrzeni nazw, musisz je zastąpić odpowiednim głównym pakietem SDK. Na przykład identyfikator FirebaseFirestoreSwift.QueryPredicate trzeba by zmienić na FirebaseFirestore.QueryPredicate.