Swift'e özgü API'leri daha geniş bir kitleye sunmak ve gelecekte yeni Swift dili özelliklerini destekleme kapasitemizi artırmak için Swift uzantısı 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 açıklanmıştır.
Neler değişiyor?
Apple SDK 10.17.0 için Firebase'den itibaren Swift uzantısı SDK'ları, ilgili ana SDK'larla birleştirildi. Örneğin, FirebaseFirestoreSwift modülündeki tüm API'ler FirebaseFirestore'ye eklendiğinden artık bu API'lere erişmek için FirebaseFirestoreSwift modülünü içe aktarmanız gerekmez.
Tüm Swift uzantıları artık ana modüllerin bir parçası olduğundan uzantı SDK'larına gerek kalmadı ve bu SDK'lar kullanımdan kaldırıldı. Swift uzantısı SDK'larını eklemek veya kullanmak derleyici uyarısına neden olur. Şubat 2024'ten itibaren Swift uzantılarını tamamen yayınlamayı durduracağız.
★ Not: Swift uzantılarının şu anda veya daha önce yayınlanmış tüm sürümleri çalışmaya devam edecektir. Ancak, düzeltmeleri almaya devam etmek ve değişikliklerden ve yeni özelliklerden yararlanabilmek için uygulamanızı ana modüldeki Swift API'lerini kullanacak şekilde taşımanızı öneririz.
Bu değişiklikle ilgili önemli tarihler
Ekim 2023'te
Swift uzantısı SDK'ları, ana SDK'larla birleştirildikten sonra ana SDK'lar lehine kullanımdan kaldırıldı. Bu değişikliği duyuran 10.17.0 sürümünün sürüm notlarına bakın.
Artık Swift uzantısı SDK API'lerini doğrudan ana SDK modüllerinden kullanabilirsiniz. Uzantı SDK'larının kullanımı, bir sonraki ana sürüm yayınlanana kadar mümkün olmaya devam edecek ancak kullanıldığında desteğin sonlandırılmasıyla ilgili uyarı gösterilecek.
Şubat 2024'ten itibaren
Swift uzantılarının yeni sürümlerini yayınlamayı durduracak ve Firebase'in Package.swift bölümünden Swift uzantılarını kaldıracağız. Eski sürümler çalışmaya devam edecek ancak güncelleme almayacak.
Ana modülden Swift'e özgü API'leri kullanmaya geçiş yapma
Şu anda Swift uzantısı SDK'larını kullanmıyorsanız herhangi bir işlem yapmanız gerekmez. Swift uzantısı SDK'sı kullanıyorsanız projenizde aşağıdaki değişiklikleri yapın.
Çalışma alanı değişiklikleri
Swift Package Manager
Firebase'i 10.17.0 veya sonraki bir sürüme güncelledikten sonra hedefinizin ayarlarındaki Genel sekmesinde bulunan Frameworks, Libraries and Embedded Content (Framework'ler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümüne gidin ve Swift uzantılı SDK'yı (ör. FirebaseFirestoreSwift) kaldırın.
CocoaPods
Firebase'i 10.17.0+ sürümüne güncelledikten sonra Podfile'ınıza gidin ve projenizin hedefiniz için çerçeveler bölümünü ekleme bağımlılığına karşılık gelen satırı kaldırın ve Swift uzantısı SDK'sını (ör. pod FirebaseFirestoreSwift) kaldırın. Ardından, pod install komutunu yeniden çalıştırın.
Zip dağıtımı ve Carthage
Firebase'i 10.17.0 veya sonraki bir sürüme güncelledikten sonra projenizdeki tüm Swift uzantılarını (ör.
xcframeworks) kaldırın (
FirebaseFirestoreSwift.xcframework).
Kaynak kodu değişiklikleri
Daha önce kullandığınız tüm Swift uzantısı SDK'ları için aşağıdaki işlemleri yapın:
- Swift uzantısı SDK'sına referans veren tüm içe aktarma ifadelerini silin. Ana SDK ayrı olarak içe aktarılmadıysa satırın sonundaki
Swiftsimgesini silerek Swift uzantısı içe aktarma işlemini ana SDK içe aktarma işlemiyle değiştirmeniz gerekir. - Herhangi bir Swift uzantısı SDK türüne referans vermek için Swift'in açık modül ad alanı özelliğini kullandıysanız bunları ilgili ana SDK ile değiştirmeniz gerekir. Örneğin,
FirebaseFirestoreSwift.QueryPredicateöğesininFirebaseFirestore.QueryPredicateolarak yeniden adlandırılması gerekir.