Firebase'i Android projenize ekleyin

Ön koşullar

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

  • Projenizin bu koşulları karşıladığından emin olun (bazı ürünlerde daha katı koşullar olabileceğini unutmayın):

    • API düzeyi 21'i (Lollipop) veya üstünü hedefliyor
    • Android 5.0 veya sonraki sürümleri kullanıyor
    • Şu sürüm şartlarını karşılamak da dahil olmak üzere Jetpack (AndroidX) kullanır:
      • com.android.tools.build:gradle v7.3.0 veya sonraki sürümler
      • compileSdkVersion 28 veya sonraki sürümler

  • Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya emülatör kullanın.
    Google Play Hizmetleri'ne bağımlı Firebase SDK'larının cihazda 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.

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


Android uygulamanızı aşağıdaki seçeneklerden birini kullanarak Firebase'e bağlayabilirsiniz:

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


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

Firebase'i uygulamanıza eklemek hem Firebase konsolunda hem de açık Android projenizde görevler içerir (ö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 eklemeden ö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 başlıklı makaleyi inceleyin.

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

Firebase'i Android uygulamanızda kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetme işlemine genellikle uygulamanızı projenize "ekleme" denir.

  1. Firebase konsoluna gidin.

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

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

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

  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üzeyinde) kök dizinine taşıyın.

  2. google-services.json yapılandırma dosyanızdaki değerlerin Firebase SDK'larına erişilebilir olmasını sağlamak için Google hizmetleri Gradle eklentisini (google-services) kullanmanız gerekir.

    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.2" 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.2' 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ını ekleyin

  1. Modül (uygulama düzeyi) 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ünü kontrol etmek için Firebase Android BoM kullanmanızı öneririz.

    Analytics etkin 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.11.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 daima uyumlu sürümlerini kullanır.

    Kotlin'e özgü 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ünden yararlanabilir (ayrıntılar için bu girişimle ilgili SSS bölümüne bakın).

    Analytics etkin değil 

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:33.11.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 daima uyumlu sürümlerini kullanır.

    Kotlin'e özgü 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ünden yararlanabilir (ayrıntılar için bu girişimle ilgili SSS bölümüne bakın).

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

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

Kurulum sırasında sorun yaşıyorsanız Android sorun giderme ve SSS sayfasını ziyaret edin.


2. seçenek: Firebase Assistant'ı kullanarak Firebase'i ekleme

Firebase Asistanı, uygulamanızı bir Firebase projesine kaydeder ve gerekli Firebase dosyalarını, eklentilerini ve bağımlılıklarını Android Studio'dan Android projenize ekler.

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

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

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

  3. Asistan bölmesinde, uygulamanıza ekleyeceğiniz bir Firebase ürünü seçin. Bölümünü genişletip eğitim bağlantısını tıklayın (ör. Analytics > Analytics etkinliği kaydetme).

    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 (örneğin, Analytics'yi uygulamanıza ekleyin).

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

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

  6. Firebase Asistanı aracılığıyla istediğiniz kadar Firebase ürünü ekleyin.

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

Kurulum sırasında 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 Gradle bağımlılıkları listelenmektedir. Aşağıdaki Firebase Android kitaplıkları hakkında daha fazla bilgi edinin:

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

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

En son Firebase BoM sürümü, her Firebase Android kitaplığının en son sürümlerini içerir. Belirli bir BoM sürümüyle eşlenen kitaplık sürümlerini öğrenmek için ilgili BoM sürümünün sürüm notlarını inceleyin.

 33.11.0
AdMob com.google.android.gms:play-services-ads 24.1.0
Analytics com.google.firebase:firebase-analytics 22.4.0
App Check özel sağlayıcı com.google.firebase:firebase-appcheck 18.0.0
App Check hata ayıklama sağlayıcısı com.google.firebase:firebase-appcheck-debug 18.0.0
App Check Play Integrity sağlayıcısı com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta15
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta15
App Distribution eklentisi com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 23.2.0
Cloud Firestore com.google.firebase:firebase-firestore 25.1.3
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.2.0
Cloud Messaging com.google.firebase:firebase-messaging 24.1.1
Cloud Storage com.google.firebase:firebase-storage 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics 19.4.2
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.4.2
Crashlytics eklentisi com.google.firebase:firebase-crashlytics-gradle 3.0.3
Dinamik özellik modülü desteği com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 21.0.2
(zorunlu)
In-App Messaging Görüntülü Reklam Ağı com.google.firebase:firebase-inappmessaging-display 21.0.2
(zorunlu)
Firebase yükleme com.google.firebase:firebase-installations 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 25.0.1
Performance Monitoring com.google.firebase:firebase-perf 21.0.5
Performance Monitoring eklentisi com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.1.0
Vertex AI in Firebase com.google.firebase:firebase-vertexai 16.2.0
Google Play Hizmetleri eklentisi com.google.gms:google-services 4.4.2
KULLANIMDAN KALDIRILMIŞ KİTAPLIKLAR
App Check SafetyNet sağlayıcısı com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Firebase KTX modülleri

Analytics com.google.firebase:firebase-analytics-ktx 22.4.0
App Check özel sağlayıcı com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta15
Authentication com.google.firebase:firebase-auth-ktx 23.2.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.3
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.1
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.2
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.2
(zorunlu)
In-App Messaging Görüntülü Reklam Ağı com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2
(zorunlu)
Firebase yükleme com.google.firebase:firebase-installations-ktx 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.5
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.1.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'ler com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Resim 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'ler 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: Modeli Çevir 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

Firebase hizmetlerini uygulamanıza ekleyin:

Firebase hakkında bilgi edinin: