Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

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, söz konusu soruları yanıtlamayı veya daha fazla bilgi edinmek için kaynaklara yönlendirmeyi amaçlamaktadır.

Bu sayfada ele alınmayan bir konuyla ilgili sorularınız varsa online topluluklarımızdan birini ziyaret edebilirsiniz. Ayrıca bu sayfayı da düzenli olarak yeni konularla güncelleyeceğiz. Öğ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 kaldırmanız gerekir.

Ayrıca bazı Firebase ürünlerini kullanmak için Android Studio dışında API'leri etkinleştirmeniz veya kaynak 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, Management REST API veya Firebase CLI ü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 bağımsız 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ümüyle eşlendiğini öğrenmek için ilgili BoM sürümünü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üzün (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ılırken bağımlılık satırlarında kitaplık sürümleri ayrı ayrı belirtilmez.

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.17.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'da hangi sürüm belirtilirse belirtilsin BoM'ın 18.0.0 sürümünü kullanmak ancak Authentication ve Cloud Firestore için BoM'ın sürümlerini kullanmak istiyorsanız bağımlılıkları nasıl bildireceğiniz aşağıda açıklanmıştır:

dependencies {
  // Import the BoM for the Firebase platform
  implementation platform('com.google.firebase:firebase-bom:34.17.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'den 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.

Neden BoM, Firebase kitaplık sürümlerini yönetmek için önerilen yöntemdir?

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 enableFeaturePreview('IMPROVED_POM_SUPPORT') ekleyin.

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.17.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

Ö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 aşağıdaki bağımlılığı base modülünüzün build.gradle dosyasına 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 uygulamanızın özellik modüllerine Firebase SDK bağımlılıklarını (Firebase BoM ile veya olmadan) ekleyebilir ve bunları normalde olduğu gibi 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ı için indirme boyutunu küçültü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 dayalı ürünler, dinamik özellik modülünde kullanıldığında bu etkinliği kaçırabilir.
Cloud Firestore ve Authentication öğelerini birlikte kullanırken her zaman aynı modüle eklemeniz gerekir. 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 öğesini dinamik özellik modülünün bağımlılığı olarak kullanırken Crashlytics NDK dokümanlarında 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 uygulamaları, filmleri, kitapları ve daha fazlasını indirebileceğiniz bir 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). Google Play Store'un geliştiriciler için olan sürümü hakkında daha fazla bilgi edinin.
Google Play Games services: Mobil oyun geliştiriciler için bir dizi API; Google Play Oyun Hizmetleri ve Firebase'i Google Play Oyun 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 deposunda açık kaynaklı kitaplıklar olarak geliştirilir. Geriye kalan özel olarak geliştirilmiş Firebase kitaplıklarını yakında herkese açık GitHub hesabımıza taşımak için çalışmalarımız devam ediyor.

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.