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

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 için Firebase SDK'sı 10.17.0 sürümünden itibaren Swift uzantı SDK'ları, ilgili ana SDK'larıyla birleştirildi. Örneğin, FirebaseFirestoreSwift modülündeki tüm API'ler FirebaseFirestore modülüne 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ı artık gerekli değildir ve kullanımdan kaldırılmıştır. Swift uzantısı SDK'larını dahil etmek veya kullanmak, derleyici uyarısına neden olur ve Şubat 2024'ten itibaren Swift uzantılarını yayınlamayı tamamen durduracağı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 etmek, 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ısı SDK'ları ana SDK'larla birleştirildi ve ardından ana SDK'lar lehine kullanımdan kaldı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ısı SDK API'lerini doğrudan ana SDK modüllerinden kullanabilirsiniz. Uzantı SDK'ları, bir sonraki ana sürüm yayınlanana kadar kullanılabilir ancak kullanıldığında desteğin sonlandırılmasıyla ilgili bir uyarı gösterilir.

Ş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 sayfasından 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ı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 hedef ayarlarınızın Genel sekmesindeki Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümüne gidin ve Swift uzantısı 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çeve ekleme bölümüne olan 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. FirebaseFirestoreSwift.xcframework) xcframeworks kaldırın.

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:

  1. 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 Swift ifadesini silerek Swift uzantısı içe aktarma işlemini ana SDK içe aktarma işlemiyle değiştirmeniz gerekir.
  2. Swift'in açık modül ad alanını kullanarak Swift uzantısı SDK türlerine referans verdiyseniz bunları ilgili ana SDK ile değiştirmeniz gerekir. Örneğin, FirebaseFirestoreSwift.QueryPredicate dosyasının adı FirebaseFirestore.QueryPredicate olarak değiştirilmelidir.