Firebase'i Android projenize ekleyin

Ön koşullar

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

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

    • API düzeyi 19 (KitKat) veya üstünü hedefler
    • Android 4.4 veya sonraki bir sürümü kullanmalıdır
    • Aşağıdaki sürüm gereksinimlerini karşılayan Jetpack (AndroidX) kullanır:
      • com.android.tools.build:gradle 7.3.0 veya sonraki sürümler
      • compileSdkVersion 28 yaş veya üzeri

  • Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya emülatör kullanın.
    Google Play hizmetlerine bağımlı olan Firebase SDK'ları için cihazda veya emülatörde Google Play Hizmetleri yüklü olmalıdır.

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

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


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

  • 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 ekleme

Firebase'i uygulamanıza eklemek hem Firebase konsolundaki hem de açık Android projenizdeki görevleri içerir (örneğin, Firebase yapılandırma dosyalarını konsoldan indirip Android projenize taşıyabilirsiniz).

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 için Firebase Projelerini Anlama sayfasını ziyaret edin.

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ında 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 SHA-1 imza sertifikası hatalarını ayıkla.

  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'u 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şilebilmesi 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.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: Firebase SDK'larını uygulamanıza 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ünleri için bağımlılıkları ekleyin. Kitaplık sürümünü 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.1.2"))

  // 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 her zaman Firebase Android kitaplıklarının 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ğlı olabilir (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.1.2"))

  // 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 her zaman Firebase Android kitaplıklarının 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ğlı olabilir (ayrıntılar için Bu girişimle ilgili SSS bölümüne bakı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 ileri atlayabilirsiniz.

Kurulum konusunda 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. Ü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 yeni sürümlerini kullandığınızdan emin olun:

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

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

  3. Asistan bölmesinde, uygulamanıza eklenecek Firebase ürününü seçin. Ürünün bölümünü genişletin ve eğitim bağlantısını tıklayın (örneğin, Analytics > Bir 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ü (ör. Uygulamanıza Analytics'i ekleyin) eklemek için düğmeyi tıklayın.

  4. Tüm bağımlıların gerekli sürümlere sahip olduğ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 atmayı unutmayın.

Kurulum konusunda 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ını bildirirken ayrı ayrı kitaplık sürümleri belirtmeyeceğ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

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

 33.1.2
AdMob com.google.android.gms:play-services-ads 23.2.0
Analizler com.google.firebase:firebase-analytics 22:0.2
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-beta13
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta13
App Distribution eklentisi com.google.firebase:firebase-appdistribution-gradle 5.0.0
Kimlik Doğrulama com.google.firebase:firebase-auth 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore 25.0.0
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 19.0.3
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.0.3
Crashlytics eklentisi com.google.firebase:firebase-crashlytics-gradle 3.0.2
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.1.0
Uygulama içi mesajlaşma com.google.firebase:firebase-inappmessaging 21.0.0
(zorunlu)
Uygulama iç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'si com.google.firebase:firebase-ml-modeldownloader 25.0.0
Performans İzleme com.google.firebase:firebase-perf 21.0.1
Performance Monitoring eklentisi com.google.firebase:perf-eklentisi 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
Firebase için Vertex AI com.google.firebase:firebase-vertexai 16.0.0-beta03
Google Play hizmetleri eklentisi com.google.gms:google-hizmetleri 4.4.2
KULLANIMDAN KALDIRILDI 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 20.0.0

Firebase KTX modülleri

Analizler com.google.firebase:firebase-analytics-ktx 22:0.2
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-beta13
Kimlik Doğrulama com.google.firebase:firebase-auth-ktx 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.0.0
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 19.0.3
Dinamik Bağlantılar com.google.firebase:firebase-dynamic-links-ktx 22.1.0
Uygulama içi mesajlaşma com.google.firebase:firebase-inappmessaging-ktx 21.0.0
(zorunlu)
Uygulama iç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'si com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.0
Performans İzleme com.google.firebase:firebase-perf-ktx 21.0.1
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: 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


Sonraki adımlar

Uygulamanıza Firebase hizmetlerini ekleyin:

Firebase hakkında bilgi edinin: