Firebase'i Android projenize 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 16 (Jelly Bean) veya daha üstünü hedefler
  • Gradle 4.1 veya üzerini kullanır
  • Aşağıdaki 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 ü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 , cihazın veya emülatörün Google Play hizmetlerinin yüklü 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ü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 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, ardından bunları Android projenize taşırsınız).

1. Adım : Firebase projesi oluşturun

Firebase'i Android uygulamanıza 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 bölümü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. Projeye genel bakış sayfasının plat_android , kurulum iş akışını başlatmak için Android simgesini ( plat_android ) veya Uygulama plat_android tıklayın.

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

   Paket adı nedir ve onu nerede buluyorsunuz?

   • Paket adı , uygulamanızı cihazda ve Google Play Store'da benzersiz şekilde tanımlar.

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

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

   • Paket adı değerinin büyük / küçük harfe duyarlı olduğunu ve bu Firebase Android uygulaması için Firebase projenize kaydolduktan sonra 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 .

   Uygulama takma adı ve Hata Ayıklama imzalama sertifikası SHA-1 Firebase'de nasıl kullanılır?

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

   • SHA-1 imzalama sertifikasında hata ayıklama : Firebase Authentication ( Google ile Oturum Açma veya telefon numarasıyla oturum açarken) ve Firebase Dynamic Links için bir SHA-1 hash gereklidir.

5. Uygulamayı kaydet'i tıklayın.

3. Adım : 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 indir'i tıklayın.

   2. Yapılandırma dosyanızı uygulamanızın modül (uygulama düzeyi) 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 dosyası adına (2) gibi ek karakterlerin eklenmediğinden emin olun.

2. Uygulamanızda Firebase ürünlerini etkinleştirmek için Google hizmetleri eklentisini Gradle dosyalarınıza ekleyin.

   1. Kök düzeyinde (proje düzeyinde) Gradle dosyanıza ( build.gradle ), Google Hizmetleri Gradle eklentisini dahil etmek için kurallar ekleyin. Google'ın Maven deposuna sahip olduğunuzu da 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.5'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      

   2. Modülünüzde (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. Firebase Android BoM'yi kullanarak, uygulamanızda kullanmak istediğiniz Firebase ürünleri için bağımlılıkları bildirin . Bunları modül (uygulama düzeyi) Gradle dosyanızda (genellikle app/build.gradle ) app/build.gradle .

   Analytics etkinleştirildi

   Java

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:27.0.0')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependency for the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics'
   
     // Declare the dependencies for any other desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth'
     implementation 'com.google.firebase:firebase-firestore'
   }
   

   Kotlin + KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:27.0.0')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependency for the Firebase SDK for Google Analytics
     implementation 'com.google.firebase:firebase-analytics-ktx'
   
     // Declare the dependencies for any other desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth-ktx'
     implementation 'com.google.firebase:firebase-firestore-ktx'
   }
   

   Firebase Android BoM'yi kullandığınızda , uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

   Analytics etkinleştirilmedi

   Java

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:27.0.0')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependencies for the desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth'
     implementation 'com.google.firebase:firebase-firestore'
   }
   

   Kotlin + KTX

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:27.0.0')
   
     // When using the BoM, you don't specify versions in Firebase library dependencies
   
     // Declare the dependencies for the desired Firebase products
     // For example, declare the dependencies for Firebase Authentication and Cloud Firestore
     implementation 'com.google.firebase:firebase-auth-ktx'
     implementation 'com.google.firebase:firebase-firestore-ktx'
   }
   

   Firebase Android BoM'yi kullandığınızda , uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.

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

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

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

Firebase Assistant , uygulamanızı bir Firebase projesine kaydeder ve gerekli Firebase dosyalarını, eklentileri ve bağımlılıkları Android projenize ekler - tümü Android Studio'nun içinden!

1. Android projenizi Android Studio'da açın ve Firebase Assistant'a erişin:

   1. Android Studio'nun ve Firebase Assistant'ın en son sürümlerini kullandığınızdan emin olmak için Dosya> Güncellemeleri kontrol et'e gidin.

   2. Asistan bölmesini açmak için Araçlar> Firebase'e gidin.

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

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

      Bu iş akışı ne işe yarar?

      • Bu iş akışı, uygulamanızın paket adını kullanarak 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.

        Firebase projenizi kurmayla ilgili bazı ipuçlarını burada bulabilirsiniz:

        • Birden çok derleme varyantının nasıl işleneceği de dahil olmak üzere, bir Firebase projesine uygulama eklemeye yönelik en iyi uygulamalar ve dikkate alınması gereken 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 Google Analytics'i kurmanızı şiddetle tavsiye ederiz; bu, birçok Firebase ürününü kullanarak optimum bir deneyim yaşamanızı sağlar.

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

   2. İstediğiniz bir Firebase ürününü eklemek için düğmeyi tıklayın (örneğin, uygulamanıza Analytics Ekleme ).

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

4. Firebase Assistant bölmesinde, seçtiğiniz Firebase ürünü için kalan kurulum talimatlarını uygulayın.

5. Firebase Assistant aracılığıyla istediğiniz kadar çok Firebase ürünü ekleyin!

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

Mevcut kitaplıklar

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 dokümantasyon ( Java | Kotlin + KTX )

• Firebase Android SDK GitHub kod deposu

Firebase Android build.gradle , build.gradle kitaplık bağımlılıklarını build.gradle bağımsız kitaplık sürümleri belirtmediğinizi build.gradle .

Sonraki adımlar

Firebase hizmetlerini uygulamanıza ekleyin:

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

• Kimlik Doğrulama ile bir kullanıcı kimlik doğrulama akışı ayarlayın.

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

• Fotoğraflar ve videolar gibi dosyaları Cloud Storage ile depolayın.

• Cloud Functions ile güvenli bir ortamda çalışan arka uç kodunu tetikleyin.

• Bulut Mesajlaşma ile bildirimler gönderin.

• Uygulamanızın Crashlytics ile ne zaman ve neden kilitlendiğini öğrenin .

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.

• Firebase ve Android geliştirmeye aşina olmayan veya özel kavramlar hakkında sorularınız varsa Android ve Firebase hakkında daha fazla bilgi edinin sayfasını ziyaret edin.

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

• Firebase Android Codelab ile uygulamalı deneyim edinin .

• Hafta Sonu kursunda Firebase ile daha fazla bilgi edinin.

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

  • Google Cloud Console'da projeniz için bütçe uyarıları ayarlayın.
  • Projenizin birden çok Firebase hizmetinde kullanımına ilişkin genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
  • Firebase başlatma kontrol listesini inceleyin .