Firebase'i Android projenize ekleyin

Ön şartlar

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

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

  • API düzey 16'yı (Jelly Bean) veya üstünü hedefler
  • Gradle 4.1 veya üstünü kullanır
  • Şu 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 taklitçi kullanın.
  Emülatörler , Google Play ile bir emülatör resmi kullanmalıdır.

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

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

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

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

Seçenek 1 : Firebase konsolunu kullanarak Firebase ekleme

Uygulamanıza Firebase eklemek, hem Firebase konsolunda hem de açık Android projenizdeki görevleri içerir (örneğin, Firebase yapılandırma dosyalarını konsoldan indirir ve ardından Android projenize taşırsınız).

Adım 1 : Bir Firebase projesi oluşturma

Android uygulamanıza Firebase eklemeden önce, Android uygulamanıza bağlanmak için bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

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

Bir Firebase projenizden sonra, Android uygulamanızı buna ekleyebilirsiniz.

Birden çok derleme varyantının nasıl işleneceği de dahil olmak üzere bir Firebase projesine uygulama eklemeyle ilgili en iyi uygulamalar ve dikkat edilecek noktalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

1. Firebase konsoluna gidin .

2. Projeye genel bakış sayfasının plat_android , kurulum iş akışını başlatmak için Android simgesini ( plat_android ) tıklayın.

   Firebase projenize zaten bir uygulama eklediyseniz, platform seçeneklerini görüntülemek için Uygulama ekle'yi tıklayın.

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

   Paket adı nedir ve nereden buluyorsunuz?

   • Bir paket adı , cihazınızda ve Google Play Store'da uygulamanızı benzersiz bir şekilde tanımlar.

   • Paket adı genellikle uygulama kimliği olarak adlandırılır.

   • Uygulamanızın paket adını modülünüzde (uygulama düzeyinde) Gradle dosyasında (genellikle app/build.gradle (örnek paket adı: com.yourcompany.yourproject )) com.yourcompany.yourproject .

   • Paket adı değerinin büyük / küçük harfe duyarlı olduğunu ve Firebase projenize kaydedildikten sonra bu Firebase Android uygulaması için değiştirilemeyeceğini unutmayın.

4. (İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve Hata ayıklama imzalama sertifikası SHA-1 .

   Firebase içinde Uygulama takma adı ve Hata Ayıklama imzalama sertifikası SHA-1 nasıl kullanılır?

   • Uygulama takma adı : Yalnızca Firebase konsolunda görebileceğiniz dahili, kullanışlı bir tanımlayıcı

   • İmzalama sertifikası SHA-1 hata ayıklama : Firebase Kimlik Doğrulaması ( Google Oturum Açma veya telefon numarası oturum açma kullanılırken ) ve Firebase Dinamik Bağlantıları için bir SHA-1 karması gereklidir.

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ı uygulamanıza ekleyin:

   1. Firebase Android yapılandırma dosyanızı ( google-services.json ) 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üzeyinde) dizinine taşıyın.

   Bu yapılandırma dosyası hakkında bilmeniz gerekenler nelerdir?

   • Firebase yapılandırma dosyası, projeniz için benzersiz ancak gizli olmayan tanımlayıcılar içerir. Bu yapılandırma dosyası hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

   • Firebase yapılandırma dosyanızı istediğiniz zaman tekrar indirebilirsiniz.

   • Yapılandırma dosya adının (2) gibi ek karakterlerle eklenmediğinden emin olun.

2. Uygulamanızda Firebase ürünlerini etkinleştirmek için, Gradle dosyalarınıza google-services eklentisini ekleyin.

   1. Kök düzeyinde (proje düzeyinde) Gradle dosyanızda ( build.gradle ), Google Services Gradle eklentisini eklemek için kurallar ekleyin. Google'ın Maven deposuna da sahip olup olmadığınızı kontrol edin.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.3'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      

   2. Modül (uygulama düzeyinde) Gradle dosyanızda (genellikle app/build.gradle ) Google Services Gradle eklentisini uygulayın:

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

4. Adım : Firebase SDK'larını uygulamanıza ekleyin

1. Modül (uygulama düzeyinde) Gradle dosyanıza (genellikle app/build.gradle ) uygulamanızda kullanmak istediğiniz app/build.gradle ürünlerinin bağımlılıklarını ekleyin.

   Analytics etkin

   dependencies {
     // ...
   
     // Add the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics:17.4.4'
   
     // Add the dependencies for any other Firebase products you want to use in your app
     // For example, to also use Firebase Authentication
     implementation 'com.google.firebase:firebase-auth:19.3.2'
   
     // Getting a "Could not find" error? Make sure that you've added
     // Google's Maven repository to your root-level build.gradle file
   }
   

   Analytics etkin değil

   dependencies {
     // ...
   
     // Add the dependencies for the Firebase products you want to use in your app
     // For example, to use Firebase Authentication
     implementation 'com.google.firebase:firebase-auth:19.3.2'
   
     // Getting a "Could not find" error? Make sure that you've added
     // Google's Maven repository to your root-level build.gradle file
   }
   

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

3. Analytics'i eklediyseniz, Firebase'i başarıyla entegre ettiğiniz Firebase'e doğrulama göndermek için uygulamanızı çalıştırın. Aksi takdirde, doğrulama adımını atlayabilirsiniz.

   Cihaz günlüklerinizde, başlatma işleminin tamamlandığını gösteren Firebase doğrulaması görüntülenir. Uygulamanızı ağ erişimi olan bir taklitçide çalıştırdıysanız, Firebase konsolu uygulama bağlantınızın tamamlandığını size bildirir.

Bu kadar! Sonraki adımlara geçebilirsiniz.

2. Seçenek : Firebase Yardımcısı'nı kullanarak Firebase ekleyin

Firebase Yardımcısı , uygulamanızı bir Firebase projesine kaydeder ve Android projenize gerekli Firebase dosyalarını ve kodunu ekler - hepsi Android Studio içinden.

Uygulamanızı Firebase'e bağlamak için önerilen seçeneğin, Firebase konsolu kurulum iş akışını kullanmak olduğunu unutmayın .

1. Android projenizi Android Studio'da açın.

2. Yardımcı bölmesini açmak için Araçlar> Firebase'i seçin.

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

4. Android projenizi Firebase'e bağlamak için Firebase'e Bağlan'ı tıklayın.

   Bu iş akışı ne yapıyor?

   • Bu iş akışı, uygulamanızın paket adıyla otomatik olarak yeni bir Firebase Android uygulaması oluşturur.

     Bu yeni Firebase Android uygulamasını mevcut bir Firebase projesinde veya yeni bir projede oluşturabilirsiniz.

     • Birden çok derleme varyantının nasıl işleneceği de dahil olmak üzere bir Firebase projesine uygulama eklemeyle ilgili en iyi uygulamalar ve dikkat edilecek noktalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

     • Yeni bir proje oluşturursanız, projeniz için birçok Firebase ürününü kullanarak en iyi deneyimi yaşamanızı sağlayan Google Analytics kurmanızı önemle öneririz.

   • Bu iş akışı ayrıca Firebase projenizin Android yapılandırma dosyasını ( google-services.json ) uygulamanızın modül (uygulama düzeyinde) dizinine ekler.

5. Firebase Yardımcısı bölmesinde, seçtiğiniz Firebase ürününüz için kitaplık bağımlılığını eklemek üzere düğmeyi tıklayın (örneğin, uygulamanıza Analytics ekleyin ).

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

7. Analytics'i eklediyseniz, Firebase'i başarıyla entegre ettiğiniz Firebase'e doğrulama göndermek için uygulamanızı çalıştırın. Aksi takdirde, bu doğrulama adımını atlayabilirsiniz.

   Cihaz günlüklerinizde, başlatma işleminin tamamlandığını gösteren Firebase doğrulaması görüntülenir. Uygulamanızı ağ erişimi olan bir taklitçide çalıştırdıysanız, Firebase konsolu uygulama bağlantınızın tamamlandığını size bildirir.

8. Firebase Yardımcısı bölmesinde, seçtiğiniz Firebase ürünü için kalan kurulum talimatlarını izleyin.

9. Firebase Yardımcısı ile istediğiniz kadar çok Firebase ürünü ekleyin!

Bu kadar! Önerilen sonraki adımlara göz attığınızdan emin olun.

Bir Firebase Malzeme Listesi (BoM) ile kitaplık sürümünü kontrol etme

Daha kolay kütüphane sürüm yönetimi için, bir Firebase Malzeme Listesi (BoM) almayı düşünün.

Kullanılabilir kütüphaneler

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

• Referans belgeleri ( Java | Kotlin + KTX )

• Firebase Android SDK GitHub repo

Sonraki adımlar

Firebase hakkında bilgi edinin:

• Firebase projeleri ve projeler için en iyi uygulamalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.

• Örnek Firebase uygulamalarını keşfedin.

• Firebase Android Codelab ile uygulamalı deneyim edinin .

• Bir Hafta Sonu kursunda Firebase ile daha fazla bilgi edinin.

• Uygulamanızı başlatmaya hazırlanın:

  • GSO konsolunda projeniz için bütçe uyarıları ayarlayın.
  • Firebase konsolunda Kullanım ve faturalandırma kontrol panelinizi izleyin.
  • Firebase başlatma kontrol listesini gözden geçirin.

Firebase hizmetlerini uygulamanıza ekleyin:

• Analytics ile kullanıcı davranışları hakkında bilgi edinin .

• Kimlik Doğrulama ile bir kullanıcı kimlik doğrulama akışı oluşturun.

• Kullanıcı bilgileri gibi verileri Cloud Firestore veya Realtime Database ile depolayın.

• Cloud Storage ile fotoğraf ve video gibi dosyaları depolayın.

• Bulut İşlevleri ile güvenli bir ortamda çalışan arka uç kodunu tetikleyin.

• Cloud Messaging ile bildirim gönderin.

• Uygulamanızın Crashlytics ile ne zaman ve neden çöktüğünü öğrenin .