Swift'e özgü API'leri daha geniş çapta kullanılabilir hale getirmek ve gelecekte yeni Swift dil özelliklerini destekleme yeteneğimizi artırmak için Swift uzantı SDK'larımızı ana SDK'larla birleştiriyoruz. Yaptığımız değişiklikler ve bunların projeleriniz üzerindeki beklenen etkileri aşağıda belgelenmiştir.
Ne değişiyor?
Apple SDK 10.17.0 için Firebase'den başlayarak, Swift uzantı SDK'ları ilgili ana SDK'larla birleştirildi. Örneğin, FirebaseFirestoreSwift modülündeki tüm API'ler FirebaseFirestore eklenmiştir, dolayısıyla bu API'lere erişmek için artık FirebaseFirestoreSwift modülünü içe aktarmanız gerekmez.
Artık tüm Swift uzantıları ana modüllerin parçası olduğundan, uzantı SDK'larına artık gerek yoktur ve kullanımdan kaldırılmıştır. Swift uzantı SDK'larını eklemek veya kullanmak bir derleyici uyarısına neden olacaktır ve Şubat 2024'ten itibaren Swift uzantılarını tamamen yayınlamayı bırakacağız.
★ Not: Swift uzantılarının şu anda veya daha önce yayınlanmış sürümleri çalışmaya devam edecektir. Ancak düzeltmeleri almaya devam ettiğinizden ve değişikliklerden ve yeni özelliklerden yararlanabildiğinizden emin olmak için uygulamanızı ana modülden Swift API'lerini kullanacak şekilde taşımanızı öneririz.
Bu değişiklik için önemli tarihler
Ekim 2023'te
Swift eklenti SDK'ları ana SDK'larla birleştirildi ve ardından ana SDK'lar lehine kullanımdan kaldırıldı. Bu değişikliği duyuran sürüm 10.17.0 sürüm notlarına bakın.
Artık Swift eklenti SDK API'lerini doğrudan ana SDK modüllerinden kullanabilirsiniz. Uzantı SDK'larının kullanımı bir sonraki ana sürüm sürümüne kadar hâlâ mümkün olacak ancak kullanıldığında kullanımdan kaldırılma uyarısı verilecek.
Şubat 2024 gibi erken bir tarihte
Swift uzantılarının yeni sürümlerini yayınlamayı durduracağız ve Swift uzantılarını Firebase'in Package.swift dosyasından kaldıracağız. Eski sürümler çalışmaya devam edecek ancak güncelleme almayacaktır.
Ana modülden Swift yerel API'lerini kullanmak için nasıl geçiş yapılır?
Şu anda Swift uzantı SDK'larını kullanmıyorsanız herhangi bir işlem yapmanıza gerek yoktur. Swift eklenti SDK'sı kullanıyorsanız projenizde aşağıdaki değişiklikleri yapın.
Çalışma alanı değişiklikleri
Swift Paket Yöneticisi
Firebase'i 10.17.0+ sürümüne güncelledikten sonra, hedefinizin ayarlarının Genel sekmesindeki Çerçeveler, Kitaplıklar ve Gömülü İçerik bölümüne gidin ve Swift uzantı SDK'sını ( FirebaseFirestoreSwift gibi) kaldırın.
CocoaPod'lar
Firebase'i 10.17.0+ sürümüne güncelledikten sonra Pod dosyanıza gidin ve projenizin hedefinize yönelik çerçeveler bölümünü ekleme bağımlılığına karşılık gelen satırı kaldırın ve Swift uzantı SDK'sını (pod FirebaseFirestoreSwift gibi) kaldırın. Ardından pod install komutunu yeniden çalıştırın.
Posta dağıtımı ve Kartaca
Firebase'i 10.17.0+ sürümüne güncelledikten sonra, projenizdeki xcframeworks Swift uzantılarını kaldırın ( FirebaseFirestoreSwift.xcframework gibi).
Kaynak kodu değişiklikleri
Daha önce kullandığınız tüm Swift eklenti SDK'ları için aşağıdaki işlemleri yapın:
- Swift eklenti SDK'sına başvuran tüm içe aktarma ifadelerini silin. Ana SDK ayrı olarak içe aktarılmadıysa satırın sonundaki
Swiftsilerek Swift uzantısını içe aktarmayı ana SDK içe aktarmayla değiştirmeniz gerekecektir. - Herhangi bir Swift uzantı SDK türüne referans vermek için Swift'in açık modül ad alanını kullandıysanız, bunları karşılık gelen ana SDK ile değiştirmeniz gerekecektir. Örneğin,
FirebaseFirestoreSwift.QueryPredicateFirebaseFirestore.QueryPredicateolarak yeniden adlandırılması gerekir.