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

Łączymy nasze pakiety SDK rozszerzeń Swift z głównymi pakietami SDK, aby udostępnić interfejsy API natywne dla Swift i zwiększyć możliwość obsługi nowych funkcji języka Swift w przyszłości. Poniżej znajdziesz informacje o wprowadzanych zmianach i ich przewidywanym wpływie na Twoje projekty.

Co się zmienia?

Od wersji 10.17.0 pakietu Firebase SDK dla Apple pakiety SDK rozszerzeń Swift zostały połączone 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ć dostęp do tych interfejsów API.

Ponieważ wszystkie rozszerzenia Swift są teraz częścią głównych modułów, pakiety SDK rozszerzeń nie są już wymagane i zostały wycofane. Dołączenie lub użycie pakietów SDK rozszerzeń Swift spowoduje wyświetlenie ostrzeżenia kompilatora, a już w lutym 2024 r. przestaniemy całkowicie udostępniać rozszerzenia Swift.

★ Uwaga: wszystkie obecnie i wcześniej opublikowane wersje rozszerzeń Swift będą nadal działać. Zalecamy jednak migrację aplikacji do korzystania z interfejsów API Swift z głównego modułu, aby nadal otrzymywać poprawki i korzystać ze zmian oraz nowych funkcji.

Ważne daty dotyczące tej zmiany

Październik 2023 r.

Pakiety SDK rozszerzeń Swift zostały połączone 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 rozszerzeń Swift bezpośrednio z modułów głównego pakietu SDK. Korzystanie z pakietów SDK rozszerzeń będzie nadal możliwe do czasu wydania następnej wersji głównej, ale podczas korzystania z nich będzie wyświetlane ostrzeżenie o wycofaniu.

Już w lutym 2024 r.

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

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

Jeśli obecnie nie używasz pakietów SDK rozszerzeń Swift, nie musisz podejmować żadnych działań. Jeśli używasz pakietu SDK rozszerzeń Swift, wprowadź w projekcie te zmiany.

Zmiany w obszarze roboczym

Swift Package Manager

Po zaktualizowaniu Firebase do wersji 10.17.0 lub nowszej otwórz sekcję Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone) na karcie General (Ogólne) w ustawieniach celu i usuń pakiet SDK rozszerzeń 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 do celu oraz usuń pakiet SDK rozszerzeń 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 (np. FirebaseFirestoreSwift.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 rozszerzeń Swift. Jeśli główny pakiet SDK nie został zaimportowany osobno, musisz zastąpić import rozszerzenia Swift importem głównego pakietu SDK, usuwając słowo Swift na końcu wiersza.
  2. Jeśli do odwoływania się do typów pakietów SDK rozszerzeń Swift używasz jawnej przestrzeni nazw modułu Swift, musisz zastąpić je odpowiednim głównym pakietem SDK. Na przykład FirebaseFirestoreSwift.QueryPredicate trzeba zmienić na FirebaseFirestore.QueryPredicate.