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

Łączymy nasze pakiety SDK z rozszerzeniami Swift z głównymi pakietami SDK, aby udostępnić interfejsy API w Swift i zwiększyć naszą zdolność do obsługi nowych funkcji języka Swift w przyszłości. Poniżej znajdziesz opis wprowadzanych zmian i ich przewidywany wpływ na Twoje projekty.

Co się zmienia?

Od wersji 10.17.0 pakietu SDK Firebase for 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 modułu 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łączanie lub używanie pakietów SDK rozszerzeń Swift spowoduje wyświetlenie ostrzeżenia kompilatora. Już w lutym 2024 r. przestaniemy udostępniać rozszerzenia Swift.

★ Uwaga: wszystkie obecnie i wcześniej opublikowane wersje rozszerzeń Swift będą nadal działać. Zalecamy jednak przeniesienie aplikacji do interfejsów API Swift z modułu głównego, 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 następnej głównej wersji, 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ą już aktualizowane.

Jak przejść z interfejsów API w module głównym na interfejsy API w Swift

Jeśli obecnie nie korzystasz z 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 (Frameworki, biblioteki i treści osadzone) na karcie General (Ogólne) w ustawieniach projektu 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 sekcji dodawania platform dla celu oraz 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ń z projektu wszystkie rozszerzenia Swift (np.xcframeworksFirebaseFirestoreSwift.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 znak Swift na końcu wiersza.
2. Jeśli do odwoływania się do typów pakietu SDK rozszerzenia Swift używasz jawnego określania przestrzeni nazw modułów Swift, musisz zastąpić je odpowiednimi typami głównego pakietu SDK. Na przykład FirebaseFirestoreSwift.QueryPredicate trzeba zmienić na FirebaseFirestore.QueryPredicate.