Bu sayfa, Cloud Translation API ile çevrilmiştir.

Android için Firebase'i anlama

Android projenizi Firebase kullanarak geliştirirken Firebase'e özgü veya aşina olmadığınız kavramlarla karşılaşabilirsiniz. Bu sayfa, bu soruları yanıtlamayı veya daha fazla bilgi edinmek için kaynaklara yönlendirmeyi amaçlamaktadır.

Bu sayfada ele alınmayan bir konuyla ilgili sorunuz varsa online topluluklarımızdan birini ziyaret edebilirsiniz. Ayrıca bu sayfayı düzenli olarak yeni konularla güncelleyeceğiz. Bu nedenle, öğrenmek istediğiniz konunun eklenip eklenmediğini görmek için sayfayı tekrar ziyaret edin.

Android Studio için Firebase Assistant eklentisi

Firebase Asistanı, Android uygulamanızı bir Firebase projesine kaydeden ve gerekli Firebase yapılandırma dosyalarını, eklentilerini ve bağımlılıklarını Android projenize ekleyen bir Android Studio eklentisidir. Tüm bu işlemler Android Studio'da yapılır.

Firebase Asistanı'nı kullanmak için Android'de kullanmaya başlama sayfasındaki talimatları uygulayın. Hem Android Studio'nun hem de Firebase Asistanı'nın en güncel sürümlerini kullandığınızdan emin olun (Dosya > Güncellemeleri kontrol et'e gidin).

Uygulamanıza eklemek için belirli Firebase ürünlerini seçtiğinizde Firebase Asistan, gerekli bağımlılıkları app/build.gradle dosyanızda otomatik olarak tanımlar. Firebase Android BoM (önerilen) kullanmak istiyorsanız modülünüzdeki (uygulama düzeyinde) Gradle dosyasındaki (genellikle app/build.gradle) bağımlılıkları güncelleyerek BoM platformunu içe aktarmanız gerektiğini unutmayın. Ayrıca, sürümleri her Firebase kitaplığı bağımlılığı satırından da kaldırmanız gerekir.

Ayrıca, bazı Firebase ürünlerini kullanmak için Android Studio dışında API'leri etkinleştirmeniz veya kaynakları sağlamanız gerekir. Firebase Asistanı'ndaki her ürünle ilgili talimatlarda yapmanız gereken ek işlemler açıklanır. Örneğin, Cloud Firestore kullanmak için veritabanınızı ve kurallarınızı Firebase konsolunda ayarlamanız gerekir.

Google hizmetleri: eklenti ve yapılandırma dosyası

Firebase'i Android projenize eklerken google-services eklentisini ve google-services.json yapılandırma dosyasını projenize eklemeniz gerekir.

Firebase'i Android projenize Firebase konsolu, Yönetim REST API'si veya Firebase KSA üzerinden eklerseniz eklentiyi ve yapılandırma dosyasını projenize manuel olarak eklemeniz gerekir. Ancak Firebase Asistanı'nı kullanırsanız bu görevler kurulum sırasında sizin için otomatik olarak yapılır.

Google hizmetleri eklentisi ile yapılandırma dosyasının birlikte nasıl çalıştığı hakkında bilgi edinmek için Android belgelerini ziyaret edin.

Firebase Android BoM (Bill of Materials)

Firebase Android BoM (Bill of Materials), yalnızca bir sürümü (BoM'ın sürümü) belirterek tüm Firebase kitaplık sürümlerinizi yönetmenize olanak tanır.

Uygulamanızda Firebase BoM kullandığınızda BoM, BoM'nin sürümüyle eşlenen bağımsız kitaplık sürümlerini otomatik olarak getirir. Tüm kitaplık sürümleri uyumlu olacaktır. Uygulamanızdaki BoM sürümünü güncellediğinizde, uygulamanızda kullandığınız tüm Firebase kitaplıkları bu BoM sürümüyle eşlenen sürümlere güncellenir.

Hangi Firebase kitaplığı sürümlerinin belirli bir BoM sürümle eşlendiğini öğrenmek için ilgili BoM sürümün sürüm notlarına göz atın. Bir BoM sürümüne eşlenen kitaplık sürümlerini başka bir BoM sürümüyle karşılaştırmanız gerekiyorsa aşağıdaki karşılaştırma widget'ını kullanın.

Gradle'ın BoM platformlar için desteği hakkında daha fazla bilgi edinin.

Firebase Android BoM kullanarak modülünüzde (uygulama düzeyinde) Gradle dosyasında (genellikle app/build.gradle) bağımlılıkları nasıl tanımlayacağınız aşağıda açıklanmıştır. BoM kullanırken bağımlılık satırlarında kitaplık sürümlerini ayrı ayrı belirtmezsiniz.

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.0.0')

  // Declare the dependencies for the desired Firebase products without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

Firebase Android BoM kullanımıyla ilgili sık sorulan bazı soruları aşağıda bulabilirsiniz:

BoM içinde belirtilenden farklı bir kitaplık sürümünü nasıl kullanabilirim?

BoM içinde belirtilen bir kitaplık sürümünü geçersiz kılmak için aşağıdaki adımları uygulayın:

BoM platformunu içe aktarmak için satırı koruyun.

Kitaplığın bağımlılık satırında istediğiniz kitaplık sürümünü belirtin. Örneğin, App Indexing sürümünde hangi sürüm belirtilirse belirtilsin App Indexing'nın 18.0.0 sürümünü kullanmak ancak Authentication ve Cloud Firestore için BoM sürümlerini kullanmak istiyorsanız bağımlılıkları nasıl bildireceğiniz aşağıda açıklanmıştır:BoM

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.0.0')

  // Declare the dependency for the App Indexing library and specify a version
  // This specified library version overrides the version designated in the BoM.
  implementation 'com.google.firebase:firebase-appindexing:18.0.0'

  // Declare the dependencies for the other Firebase libraries without specifying versions
  // These libraries will use the versions designated in the BoM.
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

BoM, tüm Firebase kitaplıklarını uygulamama otomatik olarak ekler mi?

Hayır. Firebase kitaplıklarını uygulamanıza ekleyip kullanmak için her kitaplığı modül (uygulama düzeyi) Gradle dosyanızda (genellikle app/build.gradle) ayrı bir bağımlılık satırı olarak tanımlamanız gerekir.

BoM kullanıldığında uygulamanızdaki Firebase kitaplıklarının sürümlerinin uyumlu olması sağlanır ancak BoM bu Firebase kitaplıklarını uygulamanıza eklemez.

Firebase Kotlin uzantıları (KTX) kitaplıkları BoM tarafından destekleniyor mu?

Temmuz 2025'te (BoM v34.0.0) Firebase Kotlin uzantıları (KTX) kitaplıkları BoM'dan kaldırıldı. v34.0.0'dan önceki bir BoM sürümü kullanıyorsanız uygulamanızda KTX kitaplıklarını kullanmaya devam edebilirsiniz.

Ancak uygulamanızı ana modüllerden KTX API'lerini kullanacak şekilde taşımanızı öneririz. Aksi takdirde, BoM'nın daha yeni sürümlerine ve dolayısıyla Firebase ürün kitaplıklarının daha yeni sürümlerine güncelleyemezsiniz. Ayrıntılı bilgi için Bu girişimle ilgili SSS bölümüne bakın.

Firebase'e ait olmayan Android kitaplıklarını eklemek için BoM kullanabilir miyim?

Hayır. Firebase Android BoM yalnızca Firebase kitaplıklarının kitaplık sürümlerini yönetir.

Firebase kitaplık sürümlerini yönetmek için neden BoM önerilir?

Her Firebase kitaplığı bağımsız olarak sürüm oluşturulsa da her kitaplığın en son sürümünün diğerleriyle uyumlu olması için birlikte oluşturulur.

Uygulamanızın Firebase kitaplık sürümlerini yönetmek için BoM kullanıldığında bir Firebase kitaplığının hangi sürümünün başka bir Firebase kitaplığıyla uyumlu olduğunu izlemeniz gerekmez.

Uygulamanızda şu anda yalnızca bir Firebase kitaplığı kullanıyor olsanız bile, başka bir Firebase kitaplığı kullanmak isteyebileceğiniz zamanlar olabileceğinden BoM kullanmanızı öneririz.

Uygulamamda 5.0'dan eski bir Gradle sürümü kullanılıyor. Yine de BoM kullanabilir miyim?

Evet, BoM uygulamasını kullanmaya devam edebilirsiniz. Gradle 5.0 ve sonraki sürümlerde BoM desteği otomatik olarak etkinleştirilir. Ancak Gradle'ın önceki sürümlerinde BoM özelliğini etkinleştirmeniz ve BoM öğesini biraz farklı şekilde içe aktarmanız yeterlidir.

settings.gradle dosyanıza aşağıdakileri ekleyin: enableFeaturePreview('IMPROVED_POM_SUPPORT').

Modülünüzün (uygulama düzeyinde) Gradle dosyasına (genellikle app/build.gradle), BoM öğesini normal bir kitaplık gibi (platform değiştiricisi olmadan) şu şekilde içe aktarın:

dependencies {
  // Import the Firebase BoM
  implementation 'com.google.firebase:firebase-bom:34.0.0'

  // Declare the dependencies for the desired Firebase products, without specifying versions
  // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
  implementation 'com.google.firebase:firebase-auth'
  implementation 'com.google.firebase:firebase-firestore'
}

BoM ile ilgili sorunları nasıl bildirebilirim veya geri bildirimde bulunabilirim?

GitHub'daki Firebase Android SDK deposunu ziyaret edin.

Firebase BoM sürümlerini karşılaştırma

Kotlin uzantıları (KTX) kitaplık modülleri

Kotlin uzantıları (KTX) API'leri, ilgili ana modüllere eklendi. Örneğin, firebase-perf-ktx'daki tüm API'ler com.google.firebase.perf paketi altında firebase-perf'ya eklenmiştir. Bu değişiklik, Kotlin geliştiricilerin artık KTX modülleri yerine ana modüllere bağımlı olması gerektiğ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.

Daha önce yayınlanan KTX modüllerindeki KTX API'lerini kullanıyorsanız uygulamanızı ana modüllerdeki KTX API'lerini kullanacak şekilde taşımanızı öneririz. Ayrıntılı bilgi için Bu girişimle ilgili SSS bölümüne bakın.

Özellik modülleri ve Play Feature Delivery

Mayıs 2021'den (Firebase BoM v28.0.0) itibaren Firebase Android SDK'ları, temel uygulama modülünüzden ayrı olarak yüklenen dinamik özellik modüllerinde kullanılabilir.

Dinamik özellik modülleri desteğini etkinleştirmek için base modülünüzün build.gradle dosyasına aşağıdaki bağımlılığı ekleyin:

dependencies {
  implementation 'com.google.firebase:firebase-dynamic-module-support:16.0.0-beta04'
}

Dinamik modül desteğini eklediğinize göre artık Firebase SDK bağımlılıklarını (Firebase BoM ile veya Firebase BoM olmadan) uygulamanızın özellik modüllerine ekleyebilir ve bunları normal şekilde kullanabilirsiniz.

Örneğin, uygulamanız belirli bir anlık özelliği desteklemek için Realtime Database kullanıyorsa firebase-database bağımlılığını temel modül yerine özellik modülünün build.gradle bölümüne ekleyebilirsiniz. Bu, çoğu kullanıcının indirme boyutunu azaltır.

Özellik modüllerinde Firebase SDK'larını kullanırken aşağıdaki uyarıları dikkate alın:

Dynamic Links veya Firebase In-App Messaging gibi Analytics first_open etkinliğine dayanan ürünler, dinamik özellik modülünde kullanıldığında bu etkinliği kaçırabilir.
Cloud Firestore ve Authentication birlikte kullanılırken her ikisi de aynı modülde yer almalıdır. Bu mümkün değilse Authentication öğesinin Cloud Firestore öncesinde yüklendiğinden emin olun. Aksi takdirde, bazı Cloud Firestore işlemlerinin kimlik doğrulama durumu yanlış olabilir.
firebase-crashlytics-ndk dinamik özellik modülünün bağımlılığı olarak kullanıldığında, Crashlytics NDK belgelerinde açıklandığı gibi uygulamanızın build.gradle dosyasında unstrippedNativeLibsDir özelliğini ayarlamanız gerekir.

Özellik modülleri ve Play Feature Delivery hakkında daha fazla bilgi için Play Feature Delivery'ye genel bakış başlıklı makaleyi inceleyin.

Google hizmetleri Gradle eklentisi, Google Play Hizmetleri ve Google Play Store karşılaştırması

Google, Firebase ve Android ekosisteminin çeşitli parçaları benzer adlandırma kurallarına sahiptir. Her biriyle ilgili kısa bir açıklama aşağıda verilmiştir:

Google hizmetleri Gradle eklentisi: Uygulamanızın Firebase ve Google API'lerine erişmek için doğru yapılandırmaya sahip olmasını sağlamak üzere derleme sırasında çalışan bir Gradle eklentisi (com.google.gms.google-services).; Bu eklenti, adının aksine Google Play Hizmetleri ile ilişkili değildir (sonraki girişe bakın) ve uygulamanızın çalışma zamanındaki özelliklerini etkilemez.; Bu eklenti, Firebase'i ayarlama kapsamında uygulamanıza eklediğiniz google-services.json dosyasını da işler. Google hizmetleri Gradle eklentisi hakkında daha fazla bilgi edinin.
Google Play hizmetleri: Android cihazda çalışan ve cihazdaki uygulamalara çeşitli ortak Google API'leri (ör. Google Haritalar ve Google ile Giriş) sağlayan görünmez bir arka plan hizmeti; Bu ortak API'leri tek bir hizmette merkezileştirerek diğer uygulamaların boyutunu küçültür ve cihazın, işletim sistemi güncellemesi olmadan otomatik güvenlik güncellemeleri ve özellik geliştirmeleri almasına olanak tanır. Google Play Hizmetleri hakkında daha fazla bilgi edinin.
Google Play Store: Android cihazlarda uygulama, film, kitap ve daha fazlasını indirmek için kullanılan mağaza; Geliştirici olarak, uygulamanızın dağıtımını, sürümlerini vb. Google Play Console üzerinden yönetirsiniz. Google Play Store'un yüklü olduğu cihazlarda Google Play Hizmetleri de çalışır (önceki girişe bakın). Geliştiriciler için Google Play Store hakkında daha fazla bilgi edinin.
Google Play Games services: Mobil oyun geliştiriciler için bir dizi API; Google Play Games Hizmetleri ve Firebase'i Google Play Games Hizmetleri projenize entegre etme hakkında daha fazla bilgi edinin.

Firebase Android SDK'ları için açık kaynaklı kaynaklar

Firebase, açık kaynak geliştirmeyi destekler. Topluluğun katkılarını ve geri bildirimlerini bekliyoruz.

Firebase Android SDK'ları

Çoğu Firebase Android SDK'sı, herkese açık Firebase GitHub depomuzda açık kaynak kitaplıklar olarak geliştirilir. Geriye kalan özel olarak geliştirilmiş Firebase kitaplıklarını kısa süre içinde herkese açık GitHub hesabımıza taşımak için çalışmalarımızı sürdürüyoruz.

Hızlı başlangıç örnekleri

Firebase, Android'deki çoğu Firebase API'si için hızlı başlangıç örnekleri koleksiyonu sunar. Bu hızlı başlangıç kılavuzlarını herkese açık Firebase GitHub hızlı başlangıç deposunda bulabilirsiniz.

Her hızlı başlangıcı Android Studio projesi olarak açabilir, ardından bunları mobil cihazda veya sanal cihazda (AVD) çalıştırabilirsiniz. Alternatif olarak, bu hızlı başlangıçları Firebase SDK'larını kullanmayla ilgili örnek kod olarak da kullanabilirsiniz.