Ana modüllerde Kotlin uzantı (KTX) API'lerini kullanmaya başlayın

Firebase, Kotlin'e olan bağlılığını artırıyor. Kotlin'i Firebase ile daha erişilebilir ve kullanımı kolay hale getirmek için Android ekosistemimizi modernize etmeye çalışıyoruz.

Bu modernizasyonu gerçekleştirmek için Android'e yönelik Firebase SDK'larımızda birkaç değişiklik yapıyoruz. Bu sayfada, bu değişiklikle ilgili önemli bilgiler açıklanmaktadır. Örneğin:

• Neler değişecek?
• Bu değişikliği yapmamızın nedeni
• Bu değişiklikle ilgili önemli tarihler
• KTX API'lerini ana modülden kullanmaya nasıl geçilir?

Uygulamanızı nasıl taşıyacağınızı öğrenin.

Neler değişiyor?

Kotlin uzantıları (KTX) API'leri, ilgili ana modüllere eklendi. Örneğin, firebase-perf-ktx içindeki tüm API'ler com.google.firebase.perf paketi altında firebase-perf'ye eklenmiştir.

Bu değişiklik, Kotlin geliştiricilerin artık KTX modülleri yerine ana modülleri kullanabileceği anlamına geliyor (Firebase BoM v32.5.0+ veya BoM v32.5.0+ sürümünde listelenen ana modül sürümleri kullanılırken).

Temmuz 2025'te KTX modüllerinin yeni sürümlerini yayınlamayı durdurduk ve KTX kitaplıklarını Firebase Android BoM'dan (v34.0.0) kaldırdık.

Bu değişikliği neden yapıyoruz?

Firebase, Android geliştiriciler için Kotlin'i öncelikli tutan bir ekosistem oluşturmaya kararlıdır. Bu paketleme modernizasyonu aşağıdaki avantajları sağlar:

• Basitleştirilmiş bağımlılık yönetimi: Artık yalnızca tek bir modüle bağımlı olmanız yeterli. Bu sayede ana modül ile Kotlin uzantıları arasında geçiş yapmanız veya her ikisine de bağımlı olmanız gerekmez.

• Gelişmiş Kotlin desteği: Android için tüm Firebase SDK'larımız artık Kotlin'i daha iyi destekleyecek. Kotlin ile uyumlu tüm yeni özellikleri doğrudan ana modüllerimize ekleyeceğiz.

Bu değişiklikle ilgili önemli tarihler

Ekim 2023'te

Ekim 2023'te Kotlin uzantıları (KTX) API'leri ilgili ana modüllerine eklendi. Bu sayede, Firebase BoM v32.5.0+ veya BoM v32.5.0+ sürümünde listelenen ana modül sürümlerini kullanırken KTX API'lerini doğrudan ana modüllerden kullanabilirsiniz.

Aynı zamanda, KTX modüllerindeki Kotlin uzantısı (KTX) API'lerinin desteği sonlandırıldı (Bu değişikliği açıklayan sürüm notlarına bakın). Desteği sonlandırılan aşamada, KTX modüllerindeki desteği sonlandırılan API'ler çalışmaya ve bakımı yapılmaya devam eder.

Temmuz 2025'te

Temmuz 2025'te KTX modüllerinin yeni sürümlerini yayınlamayı durdurduk ve KTX modüllerini Firebase BoM'dan kaldırdık (BoM v34.0.0 sürümünden itibaren).

KTX modülünün veya BoM'nın daha önce yayınlanmış tüm sürümleri çalışmaya devam edecek ancak artık bakım sonu olarak kabul edilecek. Bu nedenle, KTX modüllerine hata düzeltmeleri, geriye dönük uyumlu değişiklikler veya yeni özellikler eklemeyeceğiz. Bunun yerine, Android'de Firebase için gelecekteki tüm geliştirmeler yalnızca ana modüllerde (hem Java hem de Kotlin için) yapılacaktır.

Ana modüllerden KTX API'lerini kullanmaya geçiş yapma

Kotlin uzantıları (KTX) API'lerini kullanıyorsanız KTX modülleri yerine ana modüllerden API'leri kullanmaya başlamak için uygulamanızda aşağıdaki güncellemeleri yapın.

1. Gradle bağımlılıklarınızı, KTX modülü yerine ana modülü kullanacak şekilde düzenleyin. Örneğin, Firebase Android BoM (önerilen) kullanıyorsanız:

   ÖNCE

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:34.0.0"))
   
     // Using KTX libraries for Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth-ktx")
     implementation("com.google.firebase:firebase-firestore-ktx")
   }

   AFTER

   dependencies {
     // ...
   
     // Import the Firebase BoM as usual
     // Make sure to use Firebase BoM v32.5.0 or higher
     implementation(platform("com.google.firebase:firebase-bom:34.0.0"))
   
     // No need to use the KTX libraries; everything is now in the main module
     implementation("com.google.firebase:firebase-auth")
     implementation("com.google.firebase:firebase-firestore")
   }

   Firebase Android BoM kullanmıyorsanız

   ÖNCE

   dependencies {
     // ...
   
     // Using KTX libraries for Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth-ktx:23.2.1")
     implementation("com.google.firebase:firebase-firestore-ktx:25.1.4")
   }

   AFTER

   dependencies {
     // ...
   
     // No need to use the KTX libraries, everything is now in the main module
     // Make sure to use a version listed in Firebase BoM v32.5.0 or higher
     implementation("com.google.firebase:firebase-auth:24.0.0")
     implementation("com.google.firebase:firebase-firestore:26.0.0")
   }

   
   

2. Kodunuzu, KTX API'lerinin tüm örneklerini com.google.firebase paketi altındaki ana modülde yeniden konumlandırılan API'lerle değiştirecek şekilde güncelleyin.

   ÖNCE

   import com.google.firebase.auth.ktx.auth
   import com.google.firebase.firestore.ktx.firestore
   import com.google.firebase.firestore.ktx.toObject
   import com.google.firebase.ktx.Firebase

   AFTER

   import com.google.firebase.auth.auth
   import com.google.firebase.firestore.firestore
   import com.google.firebase.firestore.toObject
   import com.google.firebase.Firebase