Swift yerel API'lerini daha geniş çapta kullanıma sunmak ve gelecekte yeni Swift dili özelliklerini destekleme becerimizi artırmak için Swift uzantı SDK'larımızı ana SDK'larla birleştiriyoruz. Yaptığımız değişiklikler ve bu değişikliklerin projeleriniz üzerindeki beklenen etkileri aşağıda açıklanmıştır.
Neler değişiyor?
Apple SDK 10.17.0 için Firebase'den başlayarak Swift uzantı SDK'ları, karşılık gelen ana SDK'larıyla birleştirilmiştir. Örneğin, FirebaseFirestoreSwift modülündeki tüm API'ler FirebaseFirestore ürününe eklendiğinden bu API'lere erişmek için artık 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ı artık gerekli değildir ve kullanımdan kaldırılmıştır. Swift uzantı SDK'larını eklemek veya kullanmak bir derleyici uyarısı oluşturur. Şubat 2024'ten itibaren ise Swift uzantılarını yayınlamayı tamamen durduracağız.
★ Not: Swift uzantılarının şu anda veya daha önce yayınlanan tüm sürümleri çalışmaya devam edecektir. Bununla birlikte, düzeltmeleri almaya devam etmek ve değişiklikler ile yeni özelliklerden yararlanmak için uygulamanızı ana modülden Swift API'lerini kullanacak şekilde taşımanızı öneririz.
Bu değişiklikle ilgili önemli tarihler
Ekim 2023'te
Swift uzantı SDK'ları ana SDK'larla birleştirildi ve ardından ana SDK'ların yerini alacak şekilde kullanımdan kaldırıldı. Bu değişikliği duyuran 10.17.0 sürümünün sürüm notlarına göz atın.
Artık Swift uzantı SDK'sı API'lerini doğrudan ana SDK modüllerinden kullanabilirsiniz. Uzantı SDK'ları bir sonraki ana sürüme kadar kullanılmaya devam edebilir ancak kullanıldıklarında bir kullanımdan kaldırma uyarısı gönderir.
Şubat 2024'ten itibaren
Swift uzantılarının yeni sürümlerini yayınlamayı durduracağız ve Swift uzantılarını Firebase'in Package.swift etiketinden kaldıracağız. Eski sürümler çalışmaya devam eder ancak güncelleme almaz.
Ana modülden Swift'te yerel API'leri kullanmak için geçiş yapma
Şu anda Swift uzantı SDK'larını kullanmıyorsanız herhangi bir işlem yapmanız gerekmez. Swift uzantı 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 veya sonraki bir sürüme güncelledikten sonra hedef ayarlarınızın Genel sekmesindeki Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümüne gidin ve Swift uzantı SDK'sını (ö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ü eklemesi konusundaki 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 kodu dağıtımı ve Kartaca
Firebase'i 10.17.0 veya sonraki bir sürüme güncelledikten sonra projenizdeki tüm Swift
xcframeworks uzantılarını (ör. FirebaseFirestoreSwift.xcframework) kaldırın.
Kaynak kodu değişiklikleri
Daha önce kullandığınız tüm Swift uzantı SDK'ları için aşağıdaki işlemleri yapın:
- Swift uzantısı SDK'sına referans veren içe aktarma ifadelerini silin. Ana SDK ayrı olarak içe aktarılmadıysa satırın sonundaki
Swiftkodunu silerek Swift uzantısını 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ını kullandıysanız bunları ilgili ana SDK ile değiştirmeniz gerekir. Örneğin,
FirebaseFirestoreSwift.QueryPredicateöğesininFirebaseFirestore.QueryPredicateolarak yeniden adlandırılması gerekir.