了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

Android projenize Firebase ekleyin

Önkoşullar

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

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

    • API seviyesi 19 (KitKat) veya üstünü hedefler
    • Android 4.4 veya üstünü kullanır
    • Bu sürüm gereksinimlerini karşılamayı içeren Jetpack (AndroidX) kullanır:
      • com.android.tools.build:gradle v3.2.1 veya üstü
      • compileSdkVersion 28 veya üstü

  • Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya bir öykünücü kullanın.
    Google Play hizmetlerine bağımlı olan Firebase SDK'larının, cihazda veya emülatörde Google Play hizmetlerinin kurulu olmasını gerektirdiğini unutmayın.

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

Halihazırda bir Android projeniz yoksa ve yalnızca bir Firebase ürü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 konsol 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 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).

Adım 1 : Bir Firebase projesi oluşturun

Firebase'i Android uygulamanıza ekleyebilmeniz için önce Android uygulamanıza bağlanmak üzere 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ı kaydettirmek genellikle uygulamanızı projenize "eklemek" 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. 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 : Bir 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 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ğerlerin Firebase SDK'ları tarafından erişilebilir olması için Google services Gradle eklentisine ( google-services ) ihtiyacınız vardır.

    1. Kök düzeyinde (proje düzeyinde) Gradle dosyanıza ( <project>/build.gradle ), Google hizmetleri eklentisini bir yapı betiği bağımlılığı olarak ekleyin:

      buildscript {

    repositories {
      // Make sure that you have the following two repositories
      google()  // Google's Maven repository
      mavenCentral()  // Maven Central repository
    }

    dependencies {
      ...

      // Add the dependency for the Google services Gradle plugin
      classpath 'com.google.gms:google-services:4.3.15'
    }
}

allprojects {
  ...

  repositories {
    // Make sure that you have the following two repositories
    google()  // Google's Maven repository
    mavenCentral()  // Maven Central repository
  }
}

    2. Modül (uygulama düzeyinde) Gradle dosyanıza (genellikle <project>/<app-module>/build.gradle ), Google hizmetleri eklentisini ekleyin:

      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ı ekleyin

  1. Modül (uygulama düzeyinde) Gradle dosyanıza (genellikle <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 oluşturmayı kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.

    Analitik etkinleştirildi

    Kotlin+KTX

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation platform('com.google.firebase:firebase-bom:32.1.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-ktx'

  // 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-ktx'
  implementation 'com.google.firebase:firebase-firestore-ktx'
}

    Java

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation platform('com.google.firebase:firebase-bom:32.1.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.

    Analitik etkin değil

    Kotlin+KTX

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation platform('com.google.firebase:firebase-bom:32.1.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-ktx'
  implementation 'com.google.firebase:firebase-firestore-ktx'
}

    Java

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation platform('com.google.firebase:firebase-bom:32.1.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.

  2. Kullanmak istediğiniz ürünler için bağımlılıkları ekledikten sonra Android projenizi Gradle dosyaları ile senkronize edin.

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

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


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

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ü Android Studio içinden!

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

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

    1. Android projenizi Firebase'e bağlamak için Firebase'e Bağlan'a 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ı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ü için kalan kurulum talimatlarını uygulayın.

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

Bu kadar! Önerilen sonraki adımları kontrol ettiğinizden emin olun.

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


Kullanılabilir kitaplıklar

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

Firebase Android BoM'yi kullanırken, build.gradle Firebase kitaplık bağımlılıklarını bildirirken ayrı kitaplık sürümlerini belirtmediğinizi unutmayın.

Kotlin+KTX

Hizmet veya Ürün Gradle bağımlılığı En sonuncu
versiyon		 Analitik eklensin mi?
Firebase Android BoM'si
(Malzeme Listesi)		 com.google.firebase:firebase-bom

En son Firebase BoM sürümü, her bir 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 o BoM sürümüne ilişkin sürüm notlarını inceleyin.

 32.1.0
adMob com.google.android.gms:play-services-ads 22.1.0
Analitik com.google.firebase:firebase-analytics-ktx 21.3.0
Uygulama Kontrolü özel sağlayıcı com.google.firebase:firebase-appcheck-ktx 17.0.1
Uygulama Kontrolü hata ayıklama sağlayıcısı com.google.firebase:firebase-appcheck-debug 17.0.1
Uygulama Kontrolü Play Bütünlük sağlayıcısı com.google.firebase:firebase-appcheck-playintegrity 17.0.1
Uygulama Dağıtımı com.google.firebase:firebase-uygulama dağıtımı 16.0.0-beta08
Uygulama Dağıtım API'sı com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta08
Uygulama Dağıtım eklentisi com.google.firebase:firebase-appdistribution-gradle 4.0.0
kimlik doğrulama com.google.firebase:firebase-auth-ktx 22.0.0
Bulut Firestore com.google.firebase:firebase-firestore-ktx 24.6.1
Firebase İstemci SDK'sı için Bulut İşlevleri com.google.firebase:firebase-fonksiyonları-ktx 20.3.1
Bulut Mesajlaşma com.google.firebase:firebase-messaging-ktx 23.1.2
Bulut depolama com.google.firebase:firebase-storage-ktx 20.2.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 18.3.7
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.7
Crashlytics eklentisi com.google.firebase:firebase-crashlytics-gradle 2.9.5
Dinamik özellik modülü desteği com.google.firebase:firebase-dinamik-modülü-destek 16.0.0-beta03
Dinamik Bağlantılar com.google.firebase:firebase-dinamik-bağlantılar-ktx 21.1.0
Uygulama İçi Mesajlaşma com.google.firebase:firebase-inappmessaging-ktx 20.3.2
(gerekli)
Uygulama İçi Mesajlaşma Ekranı com.google.firebase:firebase-inappmessaging-display-ktx 20.3.2
(gerekli)
Firebase kurulumları com.google.firebase:firebase-installations-ktx 17.1.3
Firebase ML Modeli İndirici API'sı com.google.firebase:firebase-ml-modeldownloader-ktx 24.1.2
Performans İzleme com.google.firebase:firebase-perf-ktx 20.3.2
Performans İzleme eklentisi com.google.firebase:perf eklentisi 1.4.2
Gerçek Zamanlı Veritabanı com.google.firebase:firebase-database-ktx 20.2.2
Uzak Yapılandırma com.google.firebase:firebase-config-ktx 21.4.0
Google Play hizmetleri eklentisi com.google.gms:google hizmetleri 4.3.15
Kullanımdan kaldırılan kitaplıklar
Uygulama Kontrolü SafetyNet sağlayıcısı com.google.firebase:firebase-appcheck-safetynet 16.1.2
Uygulama İndeksleme com.google.firebase:firebase-appindexing 20.0.0

Firebase ML Kit kitaplıkları

Firebase ML Özel Model API'leri com.google.firebase:firebase-ml-model-yorumlayıcı 22.0.4
Firebase ML Vision API'leri com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Görüntü 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-modeli 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-doğal-dil 22.0.1
Firebase ML: Dil Tanımlama Modeli com.google.firebase:firebase-ml-doğal-dil-dil-id-modeli 20.0.8
Firebase ML: Modeli Çevirin com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: Akıllı Yanıt Modeli com.google.firebase:firebase-ml-doğal-dil-akıllı-yanıt-modeli 20.0.8

Java

Hizmet veya Ürün Gradle bağımlılığı En sonuncu
versiyon		 Analitik eklensin mi?
Firebase Android BoM'si
(Malzeme Listesi)		 com.google.firebase:firebase-bom

En son Firebase BoM sürümü, her bir 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 o BoM sürümüne ilişkin sürüm notlarını inceleyin.

 32.1.0
adMob com.google.android.gms:play-services-ads 22.1.0
Analitik com.google.firebase:firebase-analytics 21.3.0
Uygulama Kontrolü özel sağlayıcı com.google.firebase:firebase-appcheck 17.0.1
Uygulama Kontrolü hata ayıklama sağlayıcısı com.google.firebase:firebase-appcheck-debug 17.0.1
Uygulama Kontrolü Play Bütünlük sağlayıcısı com.google.firebase:firebase-appcheck-playintegrity 17.0.1
Uygulama Dağıtımı com.google.firebase:firebase-uygulama dağıtımı 16.0.0-beta08
Uygulama Dağıtım API'sı com.google.firebase:firebase-appdistribution-api 16.0.0-beta08
Uygulama Dağıtım eklentisi com.google.firebase:firebase-appdistribution-gradle 4.0.0
kimlik doğrulama com.google.firebase:firebase-auth 22.0.0
Bulut Firestore com.google.firebase:firebase-firestore 24.6.1
Firebase İstemci SDK'sı için Bulut İşlevleri com.google.firebase:firebase-işlevleri 20.3.1
Bulut Mesajlaşma com.google.firebase:firebase-mesajlaşma 23.1.2
Bulut depolama com.google.firebase:firebase-storage 20.2.0
Crashlytics com.google.firebase:firebase-crashlytics 18.3.7
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 18.3.7
Crashlytics eklentisi com.google.firebase:firebase-crashlytics-gradle 2.9.5
Dinamik özellik modülü desteği com.google.firebase:firebase-dinamik-modülü-destek 16.0.0-beta03
Dinamik Bağlantılar com.google.firebase:firebase-dinamik-bağlantılar 21.1.0
Uygulama İçi Mesajlaşma com.google.firebase:firebase-inappmessaging 20.3.2
(gerekli)
Uygulama İçi Mesajlaşma Ekranı com.google.firebase:firebase-inappmessaging-display 20.3.2
(gerekli)
Firebase kurulumları com.google.firebase:firebase kurulumları 17.1.3
Firebase ML Modeli İndirici API'sı com.google.firebase:firebase-ml-modeli indirici 24.1.2
Performans İzleme com.google.firebase:firebase-perf 20.3.2
Performans İzleme eklentisi com.google.firebase:perf eklentisi 1.4.2
Gerçek Zamanlı Veritabanı com.google.firebase:firebase-veritabanı 20.2.2
Uzak Yapılandırma com.google.firebase:firebase-config 21.4.0
Google Play hizmetleri eklentisi com.google.gms:google hizmetleri 4.3.15
Kullanımdan kaldırılan kitaplıklar
Uygulama Kontrolü SafetyNet sağlayıcısı com.google.firebase:firebase-appcheck-safetynet 16.1.2
Uygulama İndeksleme com.google.firebase:firebase-appindexing 20.0.0

Firebase ML Kit kitaplıkları

Firebase ML Özel Model API'leri com.google.firebase:firebase-ml-model-yorumlayıcı 22.0.4
Firebase ML Vision API'leri com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Görüntü 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-modeli 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-doğal-dil 22.0.1
Firebase ML: Dil Tanımlama Modeli com.google.firebase:firebase-ml-doğal-dil-dil-id-modeli 20.0.8
Firebase ML: Modeli Çevirin com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: Akıllı Yanıt Modeli com.google.firebase:firebase-ml-doğal-dil-akıllı-yanıt-modeli 20.0.8


Sonraki adımlar

Uygulamanıza Firebase hizmetleri ekleyin:

Firebase hakkında bilgi edinin: