Firebase'i Android projenize ekleyin

Ön koşullar

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

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

    • API düzeyi 21 (Lollipop) veya üstünü hedeflemelidir.
    • Android 5.0 veya sonraki bir sürümü kullanıyor olmalıdır.
    • Şu sürüm koşullarını karşılamayı içeren Jetpack (AndroidX) kullanır:
      • com.android.tools.build:gradle 7.3.0 veya sonraki sürümler
      • compileSdkVersion 28 veya sonraki sürümler

  • Uygulamanızı çalıştırmak için fiziksel bir cihaz ayarlayın veya emülatör kullanın.
    Google Play Hizmetleri'ne bağımlı Firebase SDK'larının kullanılması için cihazda veya emülatörde Google Play Hizmetleri'nin yüklü olması gerekir.

  • 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 konsol kurulumu iş akışını kullanın.
  • 2. seçenek: Android Studio Firebase Yardımcısı'nı kullanın (ek yapılandırma gerekebilir).


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

Firebase'i uygulamanıza eklemek hem Firebase konsolunda hem de açık Android projenizde (ör. Firebase yapılandırma dosyalarını konsoldan indirip Android projenize taşıma) yapılacak görevleri içerir.

1. adım: Firebase projesi oluşturun

Firebase'i Android uygulamanıza ekleyebilmeniz için 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 kaydettirin

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

  1. Firebase konsoluna gidin.

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

  3. Uygulamanızın paket adını Android paket adı alanına 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. Uygulamanızın Firebase yapılandırma dosyasını (google-services.json) indirip kod tabanınıza ekleyin:

    1. Uygulamanızın Firebase yapılandırma dosyasını edinmek için Download google-services.json'u (google-services.json dosyasını indir) 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ı tarafından erişilebilir olması için Google hizmetleri Gradle eklentisine (google-services) ihtiyacınız vardır.

    1. Kök düzeyindeki (proje düzeyinde) Gradle dosyanızda (<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.3" 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.3' apply false
}

    2. Modülünüzün (uygulama düzeyinde) Gradle dosyasında (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ızda (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle), uygulamanızda kullanmak istediğiniz Firebase ürünlerinin bağımlılarını ekleyin. Kitaplık sürüm oluşturmayı kontrol etmek için Firebase Android BoM kullanmanızı öneririz.

    Analytics etkin 

    dependencies {
  // ...

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

    Analytics etkinleştirilmedi 

    dependencies {
  // ...

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

  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ımları incelemek için sonraki bölüme geçebilirsiniz.

Ancak kurulumda 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 projenize ekler. Tüm bu işlemler Android Studio'da yapılır.

  1. Android projenizi Android Studio'da 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 > Check for updates (Android Studio > Güncellemeleri kontrol et)

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

  3. Yardımcı bölmesinde, uygulamanıza eklemek istediğiniz Firebase ürününü seçin. Bölümünü 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 bir Firebase ürününü eklemek için düğmeyi tıklayın (örneğin, Uygulamanıza Analytics 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üyle ilgili kalan kurulum talimatlarını uygulayın.

  6. Firebase Asistanı'nı kullanarak istediğiniz kadar Firebase ürünü ekleyebilirsiniz.

Hepsi bu kadar! Önerilen sonraki adımları incelemeyi unutmayın.

Ancak 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 Gradle bağımlılıkları listelenmektedir. Bu Firebase Android kitaplıkları hakkında daha fazla bilgi edinin:

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

Hizmet veya Ürün Gradle bağımlılığı En yeni
sürüm		 Ekle Analytics?
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. Hangi kitaplık 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ını inceleyin.

 34.0.0
AdMob com.google.android.gms:play-services-ads 24.4.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 17.0.0
Analytics com.google.firebase:firebase-analytics 23.0.0
App Check özel sağlayıcı com.google.firebase:firebase-appcheck 19.0.0
App Check debug provider com.google.firebase:firebase-appcheck-debug 19.0.0
App Check Play Integrity sağlayıcısı com.google.firebase:firebase-appcheck-playintegrity 19.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta16
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta16
App Distribution plugin com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 24.0.0
Cloud Firestore com.google.firebase:firebase-firestore 26.0.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 22.0.0
Cloud Messaging com.google.firebase:firebase-messaging 25.0.0
Cloud Storage com.google.firebase:firebase-storage 22.0.0
Crashlytics com.google.firebase:firebase-crashlytics 20.0.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 20.0.0
Crashlytics plugin com.google.firebase:firebase-crashlytics-gradle 3.0.5
Data Connect com.google.firebase:firebase-dataconnect 17.0.0
Dinamik özellik modülü desteği com.google.firebase:firebase-dynamic-module-support 16.0.0-beta04
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 22.0.0
(zorunlu)
In-App Messaging Görüntülü Reklam Ağı com.google.firebase:firebase-inappmessaging-display 22.0.0
(zorunlu)
Firebase yükleme com.google.firebase:firebase-installations 19.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 26.0.0
Performance Monitoring com.google.firebase:firebase-perf 22.0.0
Performance Monitoring plugin com.google.firebase:perf-plugin 2.0.0
Realtime Database com.google.firebase:firebase-database 22.0.0
Remote Config com.google.firebase:firebase-config 23.0.0
Google Play Hizmetleri eklentisi com.google.gms:google-services 4.4.3
DEPRECATED LIBRARIES
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.5.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.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.2
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.4
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.2

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: 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'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

1 Firebase AI Logic, daha önce com.google.firebase:firebase-vertexai paketiyle birlikte "Vertex AI in Firebase" olarak adlandırılıyordu.


Sonraki adımlar

Uygulamanıza Firebase hizmetleri ekleyin:

Firebase hakkında bilgi edinin: