Ana modüllerde Swift uzantı API'lerini kullanmaya geçiş yapın

Swift'e özgü API'leri daha geniş bir kitlenin kullanımına sunmak ve gelecekte yeni Swift dil özelliklerini destekleme kapasitemizi 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 olası etkileri aşağıda açıklanmıştır.

Neler değişiyor?

Apple için Firebase SDK'sı 10.17.0'dan itibaren Swift uzantı SDK'ları, ilgili ana SDK'larıyla birleştirildi. Örneğin, FirebaseFirestoreSwift modülündeki tüm API'ler FirebaseFirestore'e eklendi. Bu nedenle, 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ına artık gerek yoktur ve bu SDK'ların desteği sonlandırılmıştır. Swift uzantı SDK'larını dahil etmek veya kullanmak derleyici uyarısı oluşturur. Ş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ınlanan tüm sürümleri çalışmaya devam edecektir. Ancak düzeltmeleri almaya devam etmek ve değişikliklerden ve yeni özelliklerden yararlanmak 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ı SDK'ları ana SDK'larla birleştirildi ve daha sonra ana SDK'lar lehine desteği sonlandırıldı. Bu değişikliğin duyurulduğu 10.17.0 sürümünün sürüm notlarına göz atın.

Artık Swift uzantı SDK API'lerini doğrudan ana SDK modüllerinden kullanabilirsiniz. Uzatma SDK'ları, sonraki büyük sürüm yayınlanana kadar kullanılabilir ancak kullanıldığında kullanımdan kaldırılma uyarısı gösterilir.

Şubat 2024'ten itibaren

Swift uzantılarının yeni sürümlerini yayınlamayı durduracak ve Swift uzantılarını Firebase'ın Package.swift'ten 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ş

Ş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 Package Manager

Firebase'i 10.17.0 veya sonraki bir sürüme güncelledikten sonra hedefinizin ayarlarındaki Genel sekmesinde Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümüne gidin ve Swift uzantı SDK'sını (FirebaseFirestoreSwift gibi) kaldırın.

CocoaPods

Firebase'i 10.17.0 veya sonraki bir sürüme güncelledikten sonra Podfile 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ı (ör. kapsül FirebaseFirestoreSwift) kaldırın. Ardından pod install komutunu yeniden çalıştırın.

Posta kodu dağılımı ve Carthage

Firebase'i 10.17.0 veya sonraki bir sürüme güncelledikten sonra projenizdeki tüm Swift uzantılarını xcframeworks (ör. FirebaseFirestoreSwift.xcframework) kaldırın.

Kaynak kodunda yapılan değişiklikler

Daha önce kullandığınız tüm Swift uzantı SDK'ları için aşağıdaki işlemleri yapın:

Swift uzantı SDK'sına atıfta bulunan tüm içe aktarma ifadelerini silin. Ana SDK ayrı olarak içe aktarılmadıysa satırın sonundaki Swift öğesini silerek Swift uzantısı içe aktarma işlemini ana SDK içe aktarma işlemiyle değiştirmeniz gerekir.
Swift uzantı SDK'sı türlerine referans vermek için Swift'in açık modül adlandırma alanını kullandıysanız bunları ilgili ana SDK ile değiştirmeniz gerekir. Örneğin, FirebaseFirestoreSwift.QueryPredicate'ün FirebaseFirestore.QueryPredicate olarak yeniden adlandırılması gerekir.