Firebase'i Android projenize ekleyin

Ön koşullar

  • Android Studio'yu yükleme veya güncelleme sürümüne geri yükleyebilirsiniz.

  • Projenizin bu gereksinimleri karşıladığından emin olun (bazı ürünlerin daha katı şartlara sahip olabilir):

    • API düzeyi 19'u hedefler (KitKat) veya üzeri
    • Android 4.4 veya sonraki bir sürümü kullanmalıdır
    • Kullanım Jetpack (AndroidX), Aşağıdaki sürümle ilgili koşullar karşılanmalıdır:
      • com.android.tools.build:gradle 7.3.0 veya sonraki sürümler
      • compileSdkVersion 28 yaş veya üzeri
  • Fiziksel bir cihaz ayarlayın veya emülatörü kullanarak uygulamanızı çalıştırın.
    Google Play'e bağımlılığı olan Firebase SDK'larının hizmetleri için cihaz veya emülatöründe Google Play Hizmetleri yüklü olmalıdır.

  • Google Hesabınızla Firebase'de oturum açın hesap.

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


Aşağıdakilerden birini kullanarak Android uygulamanızı Firebase'e bağlayabilirsiniz: seçenekleri vardır:

  • 1. Seçenek: (önerilen) Firebase konsol kurulumu iş akışı.
  • 2. Seçenek: Android Studio Firebase'i kullanma Asistan (ek yapılandırma gerektirebilir).



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

Firebase'i uygulamanıza eklemek hem Firebase konsolundaki hem de buradaki görevleri içerir açık Android projenizde (ör. Firebase yapılandırma dosyalarını ve sonra bunları Android projenize taşıyın).

1. Adım: Firebase projesi oluşturun

Firebase'i Android uygulamanıza eklemeden önce Firebase oluşturmanız gerekir projesini anlatacağım. Ziyaret edin: Şu konular hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama: Firebase projeleri.

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

Firebase'i Android uygulamanızda kullanmak için, uygulamanızı Firebase projesi. Uygulamanızı kaydetme işlemi genellikle "ekleme" olarak adlandırılır uygulamanızı belirler.

  1. Firebase konsoluna gidin.

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

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

    ziyaret edin.
  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ı indirip ekleyin. (google-services.json) uygulamanıza:

    1. Firebase Android sürümünüzü edinmek için google-services.json'u indir'i tıklayın. yapılandırma dosyası.

    2. Yapılandırma dosyanızı şu uygulamanın modül (uygulama düzeyi) kök dizinine taşıyın: en iyi şekilde yararlanabilirsiniz.

  2. google-services.json yapılandırma dosyanızdaki değerleri erişilebilir hale getirmek için Firebase SDK'larını kullanıyorsanız Google hizmetleri Gradle eklentisi (google-services).

    1. Kök düzeyindeki (proje düzeyinde) Gradle dosyanızda (<project>/build.gradle.kts veya <project>/build.gradle), Bağımlılık olarak Google hizmetleri eklentisi:

      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ünüz (uygulama düzeyinde) Gradle dosyanızda (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ızda (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle), bağımlılıklarını Firebase ürünleri bir şablondur. Şunu kullanmanızı öneririz: Kontrol etmek için Firebase Android BoM kitaplıkta sürüm oluşturma.

    Analytics etkin

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.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")
    }
    

    Şunu kullanarak: Firebase Android BoM Uygulamanız her zaman Firebase Android'in uyumlu sürümlerini kullanır kitaplıklar.

    Kotlin'e özel bir kitaplık modülü mü arıyorsunuz? Başlamak için kalan süre: Ekim 2023 (Firebase BoM 32.5.0), hem Kotlin hem de Java geliştiricileri (ayrıntılar için bkz. Bu girişimle ilgili SSS).

    Analytics etkinleştirilmedi

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.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")
    }
    

    Şunu kullanarak: Firebase Android BoM Uygulamanız her zaman Firebase Android'in uyumlu sürümlerini kullanır kitaplıklar.

    Kotlin'e özel bir kitaplık modülü mü arıyorsunuz? Başlamak için kalan süre: Ekim 2023 (Firebase BoM 32.5.0), hem Kotlin hem de Java geliştiricileri (ayrıntılar için bkz. Bu girişimle ilgili SSS).

  2. Kullanmak istediğiniz ürünler için bağımlılıkları ekledikten sonra Gradle dosyaları içeren Android projesi.

Hepsi bu kadar! Önerilenlere göz atmak için ileri atlayabilirsiniz sonraki adımlara göz atın.

Ancak kurulum konusunda sorun yaşıyorsanız şu sayfayı ziyaret edin: Android sorun giderme ve SSS.



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

Firebase Asistan, Firebase projesi ekleyebilirsiniz ve gerekli Firebase dosyalarını, eklentilerini ve bağımlılıkları Android Studio'dan yapabilirsiniz.

  1. Android projenizi Android Studio'da açın ve (Android Studio ve Firebase Asistan'ın en son sürümlerini kullanarak):

    • Windows / Linux: Yardım > Güncellemeleri denetleyin
    • macOS: Android Studio > Güncellemeleri denetleyin
  2. Firebase Assistant'ı açın: Araçlar > Firebase.

  3. Asistan bölmesinde uygulamanıza eklemek için bir Firebase ürünü seçin. Bölümü genişletin ve ardından 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ü (ör. Analytics uygulamasını uygulamanıza ekleyin).

  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, uygulamanız için kalan kurulum talimatlarını uygulayın: belirli Firebase ürünü.

  6. Firebase üzerinden istediğiniz kadar Firebase ürünü ekleyin Asistan

Hepsi bu kadar! Bu bölümde önerilen içeriklere göz atmayı unutmayın. sonraki adımlara göz atın.

Ancak kurulum konusunda sorun yaşıyorsanız şu sayfayı ziyaret edin: Android sorun giderme ve SSS.



Kullanılabilen kitaplıklar

Bu bölümde, Android ve Gradle'da desteklenen Firebase ürünleri listelenmektedir. ve bildirmeyi konuştuk. Aşağıdaki Firebase Android kitaplıkları hakkında daha fazla bilgi edinin:

Firebase Android BoM kullanılırken, Firebase kitaplığını bildirirken tekil kitaplık sürümleri belirtmemeniz gerekir bağımlılıklarını görebilirsiniz.

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 son Firebase BoM sürümü, en son sürümleri içeriyor her Firebase Android kitaplığını oluşturur. Kitaplık sürümlerinin belirli bir BoM sürümüyle eşlenmişse sürüm notlarını inceleyin bu BoM sürümü için geçerli.

33.2.0
AdMob com.google.android.gms:play-services-ads 23.3.0
Analytics com.google.firebase:firebase-analytics 22.1.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-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
Authentication com.google.firebase:firebase-auth 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore 25.1.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.0.0
Cloud Messaging com.google.firebase:firebase-messaging 24.0.1
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
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 21.0.0
(zorunlu)
In-App Messaging Görüntülü Reklam Ağı com.google.firebase:firebase-inappmessaging-display 21.0.0
(zorunlu)
Firebase yükleme com.google.firebase:firebase-installations 18.0.0
Firebase ML Model İndirme Aracı API'si com.google.firebase:firebase-ml-modeldownloader 25.0.0
Performance Monitoring com.google.firebase:firebase-perf 21.0.1
Performance Monitoring eklentisi com.google.firebase:perf-eklentisi 1.4.2
Realtime Database com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.0.0
Vertex AI in Firebase com.google.firebase:firebase-vertexai 16.0.0-beta04
Google Play hizmetleri eklentisi com.google.gms:google-hizmetleri 4.4.2
KULLANIMDAN KALDIRILDI 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.1.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-beta13
Authentication com.google.firebase:firebase-auth-ktx 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.0.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.0.1
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.0.3
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.0
(zorunlu)
In-App Messaging Görüntülü Reklam Ağı com.google.firebase:firebase-inappmessaging-display-ktx 21.0.0
(zorunlu)
Firebase yükleme com.google.firebase:firebase-installations-ktx 18.0.0
Firebase ML Model İndirme Aracı API'si com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.0
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.1
Realtime Database 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'si 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: 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

Uygulamanıza Firebase hizmetlerini ekleyin:

Firebase hakkında bilgi edinin: