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

Android için Firebase'i anlama

Firebase'i kullanarak Android projenizi geliştirirken veya Firebase'e özgü kavramlar olabilir. Bu sayfa, bu soruların yanıtlarını veya sizi daha fazla bilgi edinmeniz için kaynaklara yönlendirir.

Bu sayfada ele alınmayan bir konuyla ilgili sorularınız varsa şu adresi ziyaret edebilirsiniz: online topluluklarımızdan biri olmaktır. Bir sonraki videoda bu sayfayı düzenli aralıklarla yeni konularla güncelleyin. Bu nedenle, daha önce , hakkında bilgi edinmek istediğiniz konuyu ekledi!

Android Studio için Firebase Asistan eklentisi

Firebase Assistant, Android uygulamanızı kaydeden bir Android Studio eklentisidir uygulamasını bir Firebase projesiyle yükleyip gerekli Firebase yapılandırma dosyalarını Android projenize yönelik eklentiler ve bağımlılıklar (hepsi Android'in içinden) Stüdyo!

Şu adresteki talimatları uygulayın: Android cihazlar için başlangıç sayfasında Firebase Assistant Google Etiket Yöneticisi'nin en güncel sürümlerini hem Android Studio hem de Firebase Asistan (Dosya > Güncellemeleri kontrol et'e gidin).

Uygulamanıza eklenecek belirli Firebase ürünlerini seçtiğinizde Firebase, Asistan, app/build.gradle dosyası yükleyin. Ancak, özellikleri varsa bazı uygulamalar için manuel olarak bazı değişikliklere değineceğiz:

Firebase Android BoM'u kullanmak istiyorsanız bağımlılıkları güncelleyin. modülünüzün (uygulama düzeyinde) Gradle dosyanızda (genellikle app/build.gradle) BoM platformunu içe aktarıyorsunuz. Ayrıca her bir klasörden sürümleri kaldırmanız Firebase kitaplığı bağımlılık satırı.
Kotlin uzantı kitaplığı kullanmak istiyorsanız bağımlılığı değiştirin satır, modül (uygulama düzeyi) Gradle dosyanıza (genellikle app/build.gradle) tıklayın.ktx

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ı akılda kalıcı bir yolunu sunar.

Firebase'i Android projenize Firebase konsolunda, Management REST API'yi veya Firebase CLI eklentiyi ve yapılandırma dosyasını projenize manuel olarak eklemeniz gerekir. Ancak, Firebase Asistan kullanıyorsanız aşağıdaki görevler otomatik olarak yapılır.

Şurayı ziyaret edin: Android dokümanları bölümünü ziyaret edin.

Firebase Android BoM (Malzeme Listesi)

Firebase Android BoM (Bill of Materials) tüm verilerinizi yönetmenize olanak tanır. Yalnızca bir sürüm (BoM) belirterek Firebase kitaplık sürümleri sürümünü değil.

Uygulamanızda Firebase BoM'u kullandığınızda, BoM otomatik olarak BoM sürümüyle eşlenen bağımsız kitaplık sürümlerinde. Tüm ayrı kitaplık sürümleri uyumlu olacaktır. BoM'un sürümünüz varsa uygulamanızda kullandığınız tüm Firebase kitaplıkları bu BoM sürümüyle eşlenen sürümlere güncelleyin.

Hangi Firebase kitaplık sürümlerinin belirli bir BoM ile eşlendiğini öğrenmek için hakkında daha fazla bilgi için sürüm notlarına BoM sürümü. Aynı sürümle eşlenen kitaplık sürümlerini karşılaştırmanız gerekirse BoM sürümünü başka bir BoM sürümüyle karşılaştırdığınızda karşılaştırma widget'ını inceleyin.

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

modül (uygulama düzeyinde) Gradle dosyası (genellikle app/build.gradle). BoM, bağımlılık satırlarında tek tek kitaplık sürümlerini belirtmez.

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

  // 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'nin kullanımıyla ilgili sık sorulan sorulardan bazılarını aşağıda bulabilirsiniz:

Şurada belirtilenden farklı bir kitaplık sürümünü nasıl kullanabilirim? sorumlu mu?

BoM'de belirtilen bir kitaplık sürümünün nasıl geçersiz kılınacağı aşağıda açıklanmıştır:

BoM platformunu içe aktarma hattını koruyun.

Kitaplığın bağımlılık satırında istediğiniz kitaplık sürümünü belirtin. Örneğin, 18.0.0 sürümünü kullanmak istiyorsanız bağımlılıkları nasıl bildireceğinizi buradan öğrenebilirsiniz. BoM'da hangi sürümün tanımlandığından bağımsız olarak, ancak şunun için BoM'un sürümlerini kullanmak Kimlik doğrulama ve Cloud Firestore:

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

  // 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. Uygulamanızda Firebase kitaplıklarını eklemek ve kullanmak için şunları beyan etmeniz gerekir: her kitaplığı, modülünüz (uygulama düzeyi) Gradle'ınızda ayrı bir bağımlılık satırı olarak dosyasıdır (genellikle app/build.gradle).

BoM'u kullandığınızda, sistemdeki Firebase kitaplıklarının sürümlerinin uyumlu olsa da BoM bu Firebase'i eklemez kullanabilirsiniz.

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

Evet! Belirli Firebase kitaplığı bağımlılık satırlarınızı bildirirken şunu kullanmanız yeterlidir: KTX kitaplığının adını seçin:

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

  // 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-ktx'
  implementation 'com.google.firebase:firebase-firestore-ktx'
}

Aşağıdakilere ait olmayan Android kitaplıklarını eklemek için BoM'u kullanabilir miyim: Firebase mi?

Hayır. Firebase Android BoM yalnızca Firebase için kitaplık sürümlerini yönetir kitaplıklar. Tek istisna, Google Mobile Ads SDK'sının eklenmesidir. çünkü Firebase uygulamalarında çok yaygın bir şekilde kullanıldığından.

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

Her Firebase kitaplığının sürümü bağımsız olsa da her bir Firebase kitaplığının sürümü emin olmak için her kitaplığın en son sürümünün birlikte çalışır.

Uygulamanızın Firebase kitaplığı sürümlerini yönetmek için BoM'u kullandığınızda bir Firebase kitaplığının hangi sürümünün başka bir sürümle uyumlu olduğunu Firebase kitaplığı.

Şu anda uygulamanızda yalnızca bir Firebase kitaplığı kullansanız bile BoM kullanmanızı öneririm çünkü başka bir Firebase kitaplığı.

Uygulamamda 5.0'dan önceki bir Gradle sürümü kullanılıyor. Yine de BoM?

Evet, BoM'u kullanmaya devam edebilirsiniz. Gradle 5.0 ve sonraki sürümler için BoM desteği: otomatik olarak etkinleştirilir. Ancak Gradle'ın önceki sürümlerinde tek yapmanız gereken BoM özelliğini etkinleştirme biraz farklı bir şekilde içe aktarıyoruz.

settings.gradle dosyanıza şunu ekleyin: enableFeaturePreview('IMPROVED_POM_SUPPORT').

Modül (uygulama düzeyinde) Gradle dosyanıza (genellikle app/build.gradle) içeriyorsa BoM'u normal bir kitaplık gibi içe aktarın ( platform değiştiricisi), örneğin:

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

  // 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 nasıl bulunabilirim?

Şurayı ziyaret edin: GitHub'da Firebase Android SDK deposu.

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

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

Kotlin uzantıları (KTX) API'leri ilgili ana modüllerinde yer alır. Örneğin, firebase-perf-ktx alanındaki tüm API'ler altında firebase-perf pozisyonuna eklendi com.google.firebase.perf paketi.

Bu değişiklik, Kotlin geliştiricilerinin artık temel yerine üçüncü taraf modüllerini (ör. KTX modüllerini Firebase BoM 32.5.0 ve sonraki sürümü veya BoM v32.5.0+ sürümünde listelenen ana modül sürümleri).

Bu değişiklik kapsamında, her KTX modülündeki KTX API'leri artık desteği sonlandırıldı. Nisan 2024 itibarıyla KTX modüllerini sonlandırmayacağız ve ayrıca KTX kitaplıklarını da Firebase Android BoM'dan kaldıracağız. oluşturabilirsiniz.

KTX modüllerinden KTX API'lerini kullanıyorsanız şunları yapmanızı öneririz: uygulamanızı ana modüllerden KTX API'lerini kullanacak şekilde taşıyın ) başlıklı makaleyi okuyabilirsiniz. Ayrıntılar için Bu girişimle ilgili SSS.

Firebase Kotlin uzantıları (KTX) kitaplık modülleri, ana Firebase kitaplık modüllerini kullanabilirsiniz. Bunları kullanarak deyimsel Kotlin kodu.

Uygulamanızda KTX kitaplık modülü kullanmak için bağımlılığınızı -ktx son eki Her KTX modülünün otomatik olarak ana modüle kitaplık modülü sayesinde, her iki bağımlılığı da uygulamanıza dahil etmenize gerek yoktur.

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

  // Declare the main module
  implementation 'com.google.firebase:firebase-analytics'

  // Declare the KTX module instead (which automatically has a dependency on the main module)
  implementation 'com.google.firebase:firebase-analytics-ktx'
}

Her KTX modülü, ana modülün farklı söz dizimsel uzantılarını sağlar. Örneğin, Analytics KTX modülü etkinlikleri günlüğe kaydetmeyi kolaylaştırır:

Önce (ana modülü kullanarak)

val analytics = FirebaseAnalytics.getInstance();
val bundle = Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
analytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM, bundle);

Sonra (bunun yerine KTX modülünü kullanarak)

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}MainActivity.kt

Tüm Firebase ürünleri bir KTX modülü şunlar hariç: Firebase ML ve App Indexing.

Henüz yapmadıysanız KTX modülleri için API referans belgeleri.

Özellik modülleri ve Play Feature Delivery

Mayıs 2021'den itibaren (Firebase BoM 28.0.0), Firebase Android SDK'ları Temel platformunuzdan ayrı olarak yüklenen dinamik özellik modüllerinde kullanılır. modülünü kullanabilirsiniz.

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

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

Artık dinamik modül desteğini eklediğinize göre Firebase SDK'sını ekleyebilirsiniz Firebase BoM'u olan veya olmayan) uygulamanızı varlık ve uygulamaları her zamanki gibi kullanın.

Örneğin, uygulamanız belirli bir gerçek zamanlı analizi desteklemek için Realtime Database kullanıyorsa firebase-database bağımlılığını build.gradle öğesine ekleyebilirsiniz. özellik modülünün temel modülü yerine Bu işlem, indirme sayısını azaltır boyuta sahip olması gerekir.

Özellik modüllerinde Firebase SDK'larını kullanırken aşağıdaki uyarıları göz önünde bulundurun:

Analytics'i temel alan Dynamic Links veya Firebase Uygulama İçi Mesajlaşma gibi ürünler first_open etkinliği, bir dinamik özellik modülünde kullanıldığında bu etkinliği kaçırabilir.
Cloud Firestore ve Authentication'ı birlikte kullanırken bunları her zaman dahil etmelisiniz aynı boyutta bir çerçevedir. Bu mümkün değilse Kimlik Doğrulama özelliğinin Cloud Firestore'dan önce yüklenmiş olmalıdır; aksi halde bazı Cloud Firestore işlemleri kimlik doğrulama durumu yanlış.
Bir dinamik özelliğin bağımlılığı olarak firebase-crashlytics-ndk kullanılırken modülünde, uygulamanızın ayarlarında unstrippedNativeLibsDir özelliğini build.gradle dosyası, Crashlytics NDK belgeleri.

Özellik modülleri ve Play Feature Delivery hakkında daha fazla bilgi için şu adresi ziyaret edin: Play Feature Delivery'ye genel bakış.

Google hizmetleri Gradle eklentisi - Google Play hizmetleri - Google Play Store

Google, Firebase ve Android ekosisteminin birçok parçasında benzerlikler bulunur. inceleyeceğiz. Aşağıda her birinin kısa bir açıklaması verilmiştir:

Google hizmetleri Gradle eklentisi: Derleme zamanında çalışan bir Gradle eklentisi (com.google.gms.google-services) Uygulamanızın Firebase ve Google'a erişmek için doğru yapılandırmaya sahip olduğundan emin olun API'ler; Adına rağmen bu eklentinin Google Play Hizmetleri ile hiçbir ilişkisi yoktur ( sonraki giriş) başlar ve uygulamanızın çalışma zamanında yapabileceklerini etkilemez.; Bu eklenti, eklediğiniz google-services.json dosyasını da işler Firebase kurulumunun bir parçası olarak uygulamanızı öneririz. Şu konu hakkında daha fazla bilgi edinin: Google hizmetleri Gradle eklentisi.
Google Play hizmetleri: Bir Android cihazda çalışan ve Google Haritalar ve Google ile Oturum Açma gibi bazı ortak Google API'leri cihaz; Bu ortak API'leri tek bir hizmette merkezileştirerek boyutunu küçültür ve bir cihazın otomatik güvenlik güncellemeleri almasına ve güvenlik güncellemeleri almasına güncelleme yapılmadan sunulan özellik geliştirmeleridir. Daha fazla bilgi: Google Play Hizmetleri.
Google Play Store: Android cihaza uygulama, film, kitap ve diğer içerikleri indirebileceğiniz bir mağaza; Geliştirici olarak, uygulamanızın dağıtımını, sürümlerini vb. şuradan yönetirsiniz: Google Play Console. Bir cihazda Google Play Store varsa Google Play hizmetlerini çalıştırma (önceki girişe bakın). Şu konu hakkında daha fazla bilgi edinin: Geliştiriciler için Google Play Store.
Google Play Games services: Mobil oyun geliştiricilerine yönelik bir dizi API; Daha fazla bilgi: Google Play Games hizmetleri ve Firebase'i Google Play Games hizmetleri projenize entegre edin.

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

Firebase, açık kaynak geliştirmeyi destekler ve topluluğunu katkı ve geri bildirim sağlar.

Firebase Android SDK'ları

Firebase Android SDK'larının çoğu, herkese açık alanda açık kaynak kitaplıklar olarak geliştirilmiştir. Firebase GitHub deposu. Özel olarak geliştirilmiş Firebase'in geri kalanını diğer platformlara da taşımak için kütüphaneler yakında herkese açık GitHub'ımızda yer alacak!

Hızlı başlangıç örnekleri

Firebase, Google Cloud Platform'da bulunan çoğu Firebase API'si için Android Herkese açık bu hızlı başlangıç kılavuzlarını edinin Firebase GitHub hızlı başlangıç deposu.

Her hızlı başlangıç kılavuzunu Android Studio projesi olarak açabilir, ardından bir mobil cihaz veya sanal cihaz Dilerseniz bu hızlı başlangıç kılavuzlarını Firebase SDK'larını kullanmaya yönelik örnek kod.