Firebase'i Android projenize ekleyin

Ön koşullar

  • Android Studio'yu yükleyin veya en son sürümüne güncelleyin.

  • Projenizin şu gereklilikleri karşıladığından emin olun (bazı ürünlerin daha katı gereksinimler olabileceğini unutmayın):

    • API düzeyi 19 (KitKat) veya üstünü hedefler
    • Android 4.4 veya sonraki bir sürümü çalıştıran
    • Aşağıdaki sürüm gereksinimlerinin karşılanmasını da içeren Jetpack (AndroidX) uygulamasını kullanmalıdır:
      • com.android.tools.build:gradle 7.3.0 veya sonraki sürümler
      • compileSdkVersion 28 veya üzeri

  • Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya emülatör kullanın.
    Google Play hizmetlerine bağımlılığı olan Firebase SDK'larının, cihaz veya emülatörde Google Play Hizmetleri'nin yüklü olmasını gerektirdiğini unutmayın.

  • Google Hesabınızı kullanarak Firebase'de oturum açın.

Halihazırda bir Android projeniz yoksa ve yalnızca bir Firebase ürününü denemek istiyorsanız hızlı başlangıç örneklerimizden birini indirebilirsiniz.


Android uygulamanızı Firebase'e bağlamak için aşağıdaki seçeneklerden birini kullanabilirsiniz:

  • 1. Seçenek: (önerilir) Firebase konsolu kurulum iş akışını kullanın.
  • 2. Seçenek: Android Studio Firebase Asistan'ı kullanın (ek yapılandırma gerekebilir).


1. seçenek: Firebase konsolunu kullanarak Firebase'i ekleyin

Firebase'i uygulamanıza eklemek için hem Firebase konsolunda hem de açık Android projenizde çeşitli işlemler bulunur (örneğin, Firebase yapılandırma dosyalarını konsoldan indirip Android projenize taşırsınız).

1. Adım: Firebase projesi oluşturun

Firebase'i Android uygulamanıza ekleyebilmek için önce Android uygulamanıza bağlanacak bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

2. Adım: Uygulamanızı Firebase'e kaydedin

Android uygulamanızda Firebase'i kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetmek, genellikle uygulamanızı projenize "ekleme" olarak adlandırılır.

  1. Firebase konsoluna gidin.

  2. Projeye genel bakış sayfasının ortasındaki Android simgesini () veya kurulum iş akışını başlatmak için Uygulama ekle'yi tıklayın.

  3. Android paket adı alanına uygulamanızın paket adını girin.

  4. (İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve SHA-1 imza sertifikası hata ayıklaması.

  5. Uygulamayı kaydet'i tıklayın.

3. Adım: Firebase yapılandırma dosyası ekleyin

  1. Firebase Android yapılandırma dosyasını (google-services.json) indirip uygulamanıza ekleyin:

    1. Firebase Android yapılandırma dosyanızı almak için google-services.json dosyasını indir'i tıklayın.

    2. Yapılandırma dosyanızı, uygulamanızın modül (uygulama düzeyi) kök dizinine taşıyın.

  2. google-services.json yapılandırma dosyanızdaki değerlere Firebase SDK'ları tarafından erişilebilmesini sağlamak için Google hizmetleri Gradle eklentisine (google-services) ihtiyacınız vardır.

    1. Kök düzeyindeki (proje düzeyindeki) Gradle dosyanıza (<project>/build.gradle.kts veya <project>/build.gradle) Google hizmetleri eklentisini bağımlılık olarak ekleyin:

      Kotlin 

      plugins {
  id("com.android.application") version "7.3.0" apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id("com.google.gms.google-services") version "4.4.1" apply false
}

      Groovy 

      plugins {
  id 'com.android.application' version '7.3.0' apply false
  // ...

  // Add the dependency for the Google services Gradle plugin
  id 'com.google.gms.google-services' version '4.4.1' apply false
}

    2. Modül (uygulama düzeyi) Gradle dosyanıza (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) Google hizmetleri eklentisini ekleyin:

      Kotlin 

      plugins {
  id("com.android.application")

  // Add the Google services Gradle plugin
  id("com.google.gms.google-services")
  // ...
}

      Groovy 

      plugins {
  id 'com.android.application'

  // Add the Google services Gradle plugin
  id 'com.google.gms.google-services'
  // ...
}

4. Adım: Uygulamanıza Firebase SDK'ları ekleyin

  1. Modül (uygulama düzeyinde) Gradle dosyanıza (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle), uygulamanızda kullanmak istediğiniz Firebase ürünlerinin bağımlılıklarını ekleyin. Kitaplık sürümü oluşturmayı kontrol etmek için Firebase Android BoM'u kullanmanızı öneririz.

    Analytics etkin 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.0.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // Add the dependency for the Firebase SDK for Google Analytics
  implementation("com.google.firebase:firebase-analytics")

  // TODO: Add the dependencies for any other Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    Firebase Android BoM kullanıldığında uygulamanız Firebase Android kitaplıklarının her zaman uyumlu sürümlerini kullanır.

    Kotlin'e özel bir kitaplık modülü mü arıyorsunuz? Ekim 2023'ten (Firebase BoM 32.5.0) itibaren, hem Kotlin hem de Java geliştiricileri ana kitaplık modülüne başvurabilir. (Ayrıntılar için Bu girişimle ilgili sık sorulan sorular bölümüne göz atın).

    Analiz etkin değil 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.0.0"))

  // When using the BoM, you don't specify versions in Firebase library dependencies

  // TODO: Add the dependencies for Firebase products you want to use
  // See https://firebase.google.com/docs/android/setup#available-libraries
  // For example, add the dependencies for Firebase Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}

    Firebase Android BoM kullanıldığında uygulamanız Firebase Android kitaplıklarının her zaman uyumlu sürümlerini kullanır.

    Kotlin'e özel bir kitaplık modülü mü arıyorsunuz? Ekim 2023'ten (Firebase BoM 32.5.0) itibaren, hem Kotlin hem de Java geliştiricileri ana kitaplık modülüne başvurabilir. (Ayrıntılar için Bu girişimle ilgili sık sorulan sorular bölümüne göz atın).

  2. Kullanmak istediğiniz ürünlerin bağımlılıklarını ekledikten sonra Android projenizi Gradle dosyalarıyla senkronize edin.

Hepsi bu kadar! Önerilen sonraki adımlara göz atmak için bu adımı atlayabilirsiniz.

Kurulumda sorun yaşıyorsanız Android sorun giderme ve SSS sayfasını ziyaret edin.


2. Seçenek: Firebase Asistan'ı kullanarak Firebase'i ekleme

Firebase Asistan, uygulamanızı bir Firebase projesine kaydeder ve gerekli Firebase dosyalarını, eklentileri ve bağımlılıkları Android projenize ekler. Üstelik bunların hepsini Android Studio'dan yapabilirsiniz.

  1. Android projenizi Android Studio'da açın, ardından Android Studio ve Firebase Asistan'ın en son sürümlerini kullandığınızdan emin olun:

    • Windows / Linux: Yardım > Güncellemeleri denetle
    • macOS: Android Studio > Güncellemeleri denetle

  2. Firebase Asistan'ı açın: Araçlar > Firebase.

  3. Asistan bölmesinde, uygulamanıza eklemek üzere bir Firebase ürünü seçin. İlgili bölümü genişletin ve eğitim bağlantısını tıklayın (örneğin, Analytics > Analytics etkinliği kaydedin).

    1. Android projenizi Firebase'e bağlamak için Firebase'e bağlan'ı tıklayın.

    2. İstediğiniz Firebase ürününü eklemek için düğmeyi tıklayın (ör. Analytics'i uygulamanıza ekleyin).

  4. Tüm bağımlılıklarda gerekli sürümlerin bulunduğundan emin olmak için uygulamanızı senkronize edin.

  5. Asistan bölmesinde, seçili Firebase ürününüz için kalan kurulum talimatlarını uygulayın.

  6. Firebase Asistan ile diğer Firebase ürünlerini istediğiniz kadar ekleyebilirsiniz.

Hepsi bu kadar! Önerilen sonraki adımlara mutlaka göz atın.

Kurulumda sorun yaşıyorsanız Android sorun giderme ve SSS sayfasını ziyaret edin.


Kullanılabilen kitaplıklar

Bu bölümde, Android için desteklenen Firebase ürünleri ve bunların Gradle bağımlılıkları listelenmektedir. Bu Firebase Android kitaplıkları hakkında daha fazla bilgi edinin:

Firebase Android BoM kullanırken Gradle derleme yapılandırma dosyanızda Firebase kitaplığı bağımlılıklarını tanımlarken kitaplık sürümlerini ayrı ayrı belirtmediğinizi unutmayın.

Hizmet veya Ürün Gradle bağımlılığı En yeni
sürüm		 Analytics eklensin mi?
Firebase Android BoM
(Malzeme Listesi)		 com.google.firebase:firebase-bom

En yeni Firebase BoM sürümü, her Firebase Android kitaplığının en son sürümlerini içerir. Hangi kitaplık sürümlerinin belirli bir BoM sürümüyle eşlendiğini öğrenmek için söz konusu BoM sürümünün sürüm notlarını inceleyin.

 33.0.0
AdMob com.google.android.gms:play-services-ads %
Analizler com.google.firebase:firebase-analytics 22.0.0
Uygulama Kontrolü özel sağlayıcısı com.google.firebase:firebase-appcheck 18.0.0
Uygulama Kontrolü hata ayıklama sağlayıcısı com.google.firebase:firebase-appcheck-debug 18.0.0
Uygulama Kontrolü Play Integrity sağlayıcısı com.google.firebase:firebase-appcheck-playintegrity 18.0.0
Uygulama Dağıtımı com.google.firebase:firebase-appdistribution 16.0.0-beta12
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta12
App Distribution eklentisi com.google.firebase:firebase-appdistribution-gradle %
Kimlik Doğrulama com.google.firebase:firebase-auth %
Cloud Firestore com.google.firebase:firebase-firestore %
Cloud Functions for Firebase İstemci SDK'sı com.google.firebase:firebase-functions 21.0.0
Bulut Mesajlaşma com.google.firebase:firebase-messaging 24.0.0
Cloud Storage com.google.firebase:firebase-storage 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics %
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk %
Crashlytics eklentisi com.google.firebase:firebase-crashlytics-gradle 3.0.0
Dinamik özellik modülü desteği com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dinamik Bağlantılar com.google.firebase:firebase-dynamic-links 22.0.0
Uygulama içi mesajlaşma com.google.firebase:firebase-inappmessaging 21.0.0
(zorunlu)
Uygulama İçi Mesajlaşma Ekranı com.google.firebase:firebase-inappmessaging-display 21.0.0
(zorunlu)
Firebase yüklemeleri com.google.firebase:firebase-installations 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader %
Performansı İzleme com.google.firebase:firebase-perf 21.0.0
Performance Monitoring eklentisi com.google.firebase:perf-plugin 1.4.2
Gerçek Zamanlı Veritabanı com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.0.0
Google Play Hizmetleri eklentisi com.google.gms:google-services 4.4.1
KULLANIMDAN KALDIRILMIŞ KİTAPLIKLAR
Uygulama Kontrolü SafetyNet sağlayıcısı com.google.firebase:firebase-appcheck-safetynet 16.1.2
Uygulama Dizine Ekleme com.google.firebase:firebase-appindexing %

Firebase KTX modülleri

Analizler com.google.firebase:firebase-analytics-ktx 22.0.0
Uygulama Kontrolü özel sağlayıcısı com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta12
Kimlik Doğrulama com.google.firebase:firebase-auth-ktx %
Cloud Firestore com.google.firebase:firebase-firestore-ktx %
Cloud Functions for Firebase İstemci SDK'sı com.google.firebase:firebase-functions-ktx 21.0.0
Bulut Mesajlaşma com.google.firebase:firebase-messaging-ktx 24.0.0
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx %
Dinamik Bağlantılar com.google.firebase:firebase-dynamic-links-ktx 22.0.0
Uygulama içi mesajlaşma com.google.firebase:firebase-inappmessaging-ktx 21.0.0
(zorunlu)
Uygulama İçi Mesajlaşma Ekranı com.google.firebase:firebase-inappmessaging-display-ktx 21.0.0
(zorunlu)
Firebase yüklemeleri com.google.firebase:firebase-installations-ktx 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx %
Performansı İzleme com.google.firebase:firebase-perf-ktx 21.0.0
Gerçek Zamanlı Veritabanı com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.0.0

Firebase ML Kit kitaplıkları

Firebase ML Özel Model API'leri com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API'leri com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Görüntü Etiketleme Modeli com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: Nesne Algılama ve İzleme Modeli com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: Yüz Algılama Modeli com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: Barkod Tarama Modeli com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: Natural Language API'leri com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: Dil Tanımlama Modeli com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Çeviri Modeli com.google.firebase:firebase-ml-natural-language-translate-model 20,0,9
Firebase ML: Akıllı Yanıt Modeli com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8


Sonraki adımlar

Uygulamanıza Firebase hizmetlerini ekleyin:

Firebase hakkında bilgi edinin: