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 ü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ı 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 ardından 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ılmaya devam edebilir 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 artık yayınlayacağız ve Swift uzantılarını Firebase'in Package.swift etiketinden 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 Paket Yöneticisi

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+ 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ğı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 kodu değişiklikleri

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

  1. 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.
  2. 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 öğesinin FirebaseFirestore.QueryPredicate olarak yeniden adlandırılması gerekir.