Firebase'i Android projenize ekleyin

Ön koşullar

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

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

    • API düzeyi 24 (Nougat) veya daha yüksek bir düzeyi hedeflemelidir.
    • Android 7.0 veya sonraki bir sürümü kullanıyorsa
    • Şu sürüm şartlarını karşılamayı içeren Jetpack (AndroidX) kullanmalıdı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 kurun veya emülatör kullanın.
    Google Play services bağımlılığı olan Firebase SDK'ları için cihazda veya emülatörde Google Play services uygulamasının yüklü olması gerekir.

Henüz 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 konsol kurulum iş akışını kullanın.
  • 2. seçenek: Android Studio Firebase Assistant'ı kullanın (ek yapılandırma gerekebilir).



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

Uygulamanıza Firebase'i eklemek için hem Firebase konsolunda hem de açık Android projenizde görevler gerçekleştirmeniz gerekir (ö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 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 kaydetme

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ından Android simgesini () veya Uygulama ekle'yi tıklayın.

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

  4. (İsteğe bağlı) Uygulama takma adı girin. Bu, yalnızca Firebase konsolunda sizin görebileceğiniz dahili ve kolaylık sağlayan bir tanımlayıcıdır.

  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ı 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ğerleri Firebase SDK'ları için erişilebilir hale getirmek istiyorsanız Google hizmetleri Gradle eklentisi (google-services) gerekir.

    1. Kök düzeyindeki (proje düzeyinde) Gradle dosyanıza (<project>/build.gradle.kts veya <project>/build.gradle) Google hizmetleri Gradle 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.6.0" 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.6.0' apply false
      }
    2. Modülünüzün (uygulama düzeyinde) Gradle dosyasına (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) Google hizmetleri Gradle 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: Firebase SDK'larını uygulamanıza ekleyin

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

    Analytics etkinleştirildi

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:35.2.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 kullanarak uygulamanızın her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanmasını sağlayabilirsiniz.

    Analytics etkinleştirilmedi

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:35.2.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 kullanarak uygulamanızın her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanmasını sağlayabilirsiniz.

  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 ileri atlayabilirsiniz.

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



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

Firebase Assistant, 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şlemleri Android Studio'dan yapabilirsiniz.

  1. Android projenizi Android Studio'da açın, ardından Android Studio ve Firebase Assistant'ın en yeni 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: Tools > Firebase (Araçlar > Firebase).

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

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

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

  4. Tüm bağımlılıkların gerekli sürümlere sahip olduğundan emin olmak için uygulamanızı senkronize edin.

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

  6. Firebase Assistant'ı kullanarak dilediğiniz kadar Firebase ürünü ekleyebilirsiniz.

Hepsi bu kadar! Önerilen sonraki adımlara göz atmayı 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 bunların Gradle bağımlılıkları listelenmiştir. 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ığı bağımlılıklarını bildirirken ayrı kitaplık sürümleri belirtmediğinizi unutmayın.

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

En yeni Firebase BoM sürümü, her Firebase Android kitaplığının en yeni 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.

35.2.0
Google Hizmetleri Gradle eklentisi com.google.gms:google-services 4.6.0
AdMob com.google.android.gms:play-services-ads 25.5.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 18.2.0
Firebase AI Logic On-Device com.google.firebase:firebase-ai-ondevice 16.0.0-beta08
Firebase AI KSP com.google.firebase:firebase-ai-ksp-processor 17.0.0
Analytics com.google.firebase:firebase-analytics 24.0.0
App Check özel sağlayıcı com.google.firebase:firebase-appcheck 20.1.0
App Check hata ayıklama sağlayıcısı com.google.firebase:firebase-appcheck-debug 20.1.0
App Check Google Play Integrity sağlayıcısı com.google.firebase:firebase-appcheck-playintegrity 20.1.0
App Check reCAPTCHA sağlayıcısı com.google.firebase:firebase-appcheck-recaptcha 20.1.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta21
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta21
App Distribution eklentisi com.google.firebase:firebase-appdistribution-gradle 5.3.1
Authentication com.google.firebase:firebase-auth 25.0.0
Cloud Firestore com.google.firebase:firebase-firestore 27.2.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 23.0.0
Cloud Messaging com.google.firebase:firebase-messaging 26.0.2
Cloud Storage com.google.firebase:firebase-storage 23.0.0
Crashlytics com.google.firebase:firebase-crashlytics 21.1.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 21.1.0
Crashlytics eklentisi com.google.firebase:firebase-crashlytics-gradle 3.0.8
Dinamik özellik modülü desteği com.google.firebase:firebase-dynamic-module-support 16.0.0-beta05
In-App Messaging com.google.firebase:firebase-inappmessaging 23.0.0
(zorunlu)
In-App Messaging Görüntülü Reklam Ağı com.google.firebase:firebase-inappmessaging-display 23.0.0
(zorunlu)
Firebase yükleme com.google.firebase:firebase-installations 20.0.0
Performance Monitoring com.google.firebase:firebase-perf 23.0.1
Performance Monitoring eklentisi com.google.firebase:perf-plugin 2.0.2
Firebase Phone Number Verification com.google.firebase:firebase-pnv 17.0.0
Realtime Database com.google.firebase:firebase-database 23.0.0
Remote Config com.google.firebase:firebase-config 24.0.1
SQL Connect 2 com.google.firebase:firebase-dataconnect 18.0.1
DESTEKLENMEYEN VEYA KULLANIMDAN KALDIRILAN KİTAPLIKLAR
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0

Firebase KTX modülleri artık desteklenmiyor

Analytics Kullanmayın; KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-analytics-ktx
22.5.0
App Check özel sağlayıcı Kullanmayın; KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-appcheck-ktx
18.0.0
App Distribution API Kullanmayın; KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-appdistribution-api-ktx
16.0.0-beta15
Authentication Kullanmayın; KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-auth-ktx
23.2.1
Cloud Firestore Kullanmayın; KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-firestore-ktx
25.1.4
Cloud Functions for Firebase Client SDK Kullanmayın. KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-functions-ktx
21.2.1
Cloud Messaging Kullanmayın; KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-messaging-ktx
24.1.2
Cloud Storage Kullanmayın; KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-storage-ktx
21.0.2
Crashlytics Kullanmayın. KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-crashlytics-ktx
19.4.4
Dynamic Links Kullanmayın. KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-dynamic-links-ktx
22.1.0
In-App Messaging Kullanmayın. KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-inappmessaging-ktx
21.0.2
(zorunlu)
In-App Messaging Görüntülü Reklam Ağı Kullanmayın. KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-inappmessaging-display-ktx
21.0.2
(zorunlu)
Firebase yükleme Kullanmayın. KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-installations-ktx
18.0.0
Firebase ML Model Downloader API Kullanmayın. KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-ml-modeldownloader-ktx
25.0.1
Performance Monitoring Kullanmayın. KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-perf-ktx
21.0.5
Realtime Database Kullanmayın; KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-database-ktx
21.0.0
Remote Config Kullanmayın; KTX modül kitaplıkları artık desteklenmiyor.
com.google.firebase:firebase-config-ktx
22.1.2

Firebase ML ve Firebase ML Kit kitaplıkları

Firebase ML Özel Model API'leri com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 26.1.1
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 Tespit Etme 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 "Vertex AI in Firebase" olarak adlandırılıyordu.

2 Firebase SQL Connect, daha önce "Firebase Data Connect" olarak adlandırılıyordu.



Sonraki adımlar

Uygulamanıza Firebase hizmetlerini ekleme:

Firebase hakkında bilgi: