Android projenize Firebase ekleyin

Önkoşullar

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

  • Projenizin şu gereksinimleri karşıladığından emin olun:

    • API düzeyi 19 (KitKat) veya üstünü hedefler
    • Android 4.4 veya üstünü kullanır
    • Aşağıdaki sürüm gereksinimlerini karşılamayı içeren Jetpack (AndroidX) kullanır:
      • com.android.tools.build:gradle v7.3.0 veya üstü
      • compileSdkVersion 28 veya üzeri
  • Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya bir emülatör kullanın.
    Google Play hizmetlerine bağımlı olan Firebase SDK'larının, cihazda veya emülatörde Google Play hizmetlerinin yüklü olmasını gerektirdiğini unutmayın.

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

Henüz bir Android projeniz yoksa ve yalnızca 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:

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



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

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 indirir ve ardından bunları Android projenize taşırsınız).

1. Adım : Firebase projesi oluşturun

Firebase'i Android uygulamanıza ekleyebilmeniz için öncelikle Android uygulamanıza bağlanacak bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlayın 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ı kaydetmeye genellikle uygulamanızı projenize "eklemek" denir.

  1. Firebase konsoluna gidin.

  2. Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasındaki Android simgesine ( ) veya Uygulama ekle öğesine tıklayın.

  3. Android paket 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 ) indirin ve ardından uygulamanıza ekleyin:

    1. Firebase Android yapılandırma dosyanızı edinmek için Google-services.json'u İndir'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ğerlerin Firebase SDK'ları tarafından erişilebilir olmasını sağlamak için Google hizmetleri Gradle eklentisine ( google-services ) ihtiyacınız vardır.

    1. Kök düzeyindeki (proje düzeyi) 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.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.4.0' apply false
      }
      
    2. Modülünüzün (uygulama düzeyi) Gradle dosyasına (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üzeyi) Gradle dosyanıza (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle ), Firebase ürünlerine yönelik bağımlılıkları ekleyin Uygulamanızda kullanmak istediğiniz Kitaplık sürümlerini kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.

    Analiz etkin

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:32.6.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'yi kullandığınızda uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

    Kotlin'e özgü bir kütüphane modülü mü arıyorsunuz? Ekim 2023'ten itibaren (Firebase BoM 32.5.0) hem Kotlin hem de Java geliştiricileri ana kütüphane modülüne güvenebilecekler (ayrıntılar için bu girişimle ilgili SSS'ye bakın).

    Analiz etkinleştirilmedi

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:32.6.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'yi kullandığınızda uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

    Kotlin'e özgü bir kütüphane modülü mü arıyorsunuz? Ekim 2023'ten itibaren (Firebase BoM 32.5.0) hem Kotlin hem de Java geliştiricileri ana kütüphane modülüne güvenebilecekler (ayrıntılar için bu girişimle ilgili SSS'ye bakın).

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

Bu kadar! Önerilen sonraki adımlara göz atmak için ileri atlayabilirsiniz.

Ancak kurulum konusunda sorun yaşıyorsanız Android sorun giderme ve SSS bölümünü ziyaret edin.



2. Seçenek : Firebase Assistant'ı kullanarak Firebase'i ekleyin

Firebase Asistanı, uygulamanızı bir Firebase projesine kaydeder ve gerekli Firebase dosyalarını, eklentilerini ve bağımlılıklarını Android projenize ekler; üstelik hepsi Android Studio'nun içinden!

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

  3. Asistan bölmesinde uygulamanıza eklenecek Firebase ürününü seçin. Bölümünü genişletin ve ardından eğitim bağlantısını tıklayın (örneğin, Analytics > Bir Analytics etkinliğini günlüğe kaydet ).

    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'i uygulamanıza 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. Asistan bölmesinde, seçtiğiniz Firebase ürününüz için kalan kurulum talimatlarını izleyin.

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

Bu kadar! Önerilen sonraki adımlara göz atmayı unutmayın.

Ancak kurulum konusunda sorun yaşıyorsanız Android sorun giderme ve SSS bölümünü ziyaret edin.



Mevcut kütüphaneler

Bu bölümde Android için desteklenen Firebase ürünleri ve bunların Gradle bağımlılıkları listelenmektedir. Bu Firebase Android kitaplıkları hakkında daha fazla bilgi edinin:

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

Hizmet veya Ürün Gradle bağımlılığı En sonuncu
versiyon
Analytics eklensin mi?
Firebase Android BoM'si
(Malzeme Listesi)
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 söz konusu BoM sürümüne ilişkin sürüm notlarını inceleyin.

32.6.0
AdMob com.google.android.gms:play-services-ads 22.5.0
Analitik com.google.firebase:firebase-analytics 21.5.0
Uygulama Kontrolü özel sağlayıcısı com.google.firebase:firebase-appcheck 17.1.1
Uygulama Kontrolü hata ayıklama sağlayıcısı com.google.firebase:firebase-appcheck-debug 17.1.1
Uygulama Kontrolü Play Bütünlüğü sağlayıcısı com.google.firebase:firebase-appcheck-playintegrity 17.1.1
Uygulama Dağıtımı com.google.firebase:firebase-appdistribution 16.0.0-beta11
Uygulama Dağıtım API'si com.google.firebase:firebase-appdistribution-api 16.0.0-beta11
Uygulama Dağıtımı eklentisi com.google.firebase:firebase-appdistribution-gradle 4.0.1
Kimlik doğrulama com.google.firebase:firebase-auth 22.3.0
Bulut Firestore com.google.firebase:firebase-firestore 24.9.1
Firebase İstemci SDK'sı için Bulut İşlevleri com.google.firebase:firebase-işlevleri 20.4.0
Bulut Mesajlaşma com.google.firebase:firebase-mesajlaşma 23.3.1
Bulut depolama com.google.firebase:firebase-depolama 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics 18.6.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.6.0
Crashlytics eklentisi com.google.firebase:firebase-crashlytics-gradle 2.9.9
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-dinamik-bağlantılar 21.2.0
Uygulama İçi Mesajlaşma com.google.firebase:firebase-inappmessaging 20.4.0
(gerekli)
Uygulama İçi Mesajlaşma Ekranı com.google.firebase:firebase-inappmessaging-display 20.4.0
(gerekli)
Firebase kurulumları com.google.firebase:firebase-installations 17.2.0
Firebase ML Model İndirici API'si com.google.firebase:firebase-ml-modeldownloader 24.2.1
Performans İzleme com.google.firebase:firebase-perf 20.5.1
Performans İzleme eklentisi com.google.firebase:perf-eklentisi 1.4.2
Gerçek Zamanlı Veritabanı com.google.firebase:firebase-veritabanı 20.3.0
Uzaktan Yapılandırma com.google.firebase:firebase-config 21.6.0
Google Play hizmetleri eklentisi com.google.gms:google-hizmetleri 4.4.0
KULLANIMDAN KALDIRILMIŞ KÜTÜPHANELER
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

Analitik com.google.firebase:firebase-analytics-ktx 21.5.0
Uygulama Kontrolü özel sağlayıcısı com.google.firebase:firebase-appcheck-ktx 17.1.1
Uygulama Dağıtım API'si com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta11
Kimlik doğrulama com.google.firebase:firebase-auth-ktx 22.3.0
Bulut Firestore com.google.firebase:firebase-firestore-ktx 24.9.1
Firebase İstemci SDK'sı için Bulut İşlevleri com.google.firebase:firebase-functions-ktx 20.4.0
Bulut Mesajlaşma com.google.firebase:firebase-messaging-ktx 23.3.1
Bulut depolama com.google.firebase:firebase-storage-ktx 20.3.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.6.0
Dinamik Bağlantılar com.google.firebase:firebase-dynamic-links-ktx 21.2.0
Uygulama İçi Mesajlaşma com.google.firebase:firebase-inappmessaging-ktx 20.4.0
(gerekli)
Uygulama İçi Mesajlaşma Ekranı com.google.firebase:firebase-inappmessaging-display-ktx 20.4.0
(gerekli)
Firebase kurulumları com.google.firebase:firebase-installations-ktx 17.2.0
Firebase ML Model İndirici API'si com.google.firebase:firebase-ml-modeldownloader-ktx 24.2.1
Performans İzleme com.google.firebase:firebase-perf-ktx 20.5.1
Gerçek Zamanlı Veritabanı com.google.firebase:firebase-database-ktx 20.3.0
Uzaktan Yapılandırma com.google.firebase:firebase-config-ktx 21.6.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-barkod-modeli 16.1.2
Firebase ML: AutoML Vision Edge API'si com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: Doğal Dil 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

Firebase hizmetlerini uygulamanıza ekleyin:

Firebase hakkında bilgi edinin: