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 üzerini hedefler
  • Android 4.4 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 öykünücü kullanın.
  Google Play hizmetlerine bağımlı olan Firebase SDK'larının , cihazın veya öykünücünü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:

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

Seçenek 1 : 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 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 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. Projeye genel bakış sayfasının ortasında, kurulum iş akışını başlatmak için Android simgesine ( plat_android ) veya Uygulama ekle'ye tıklayın.

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

   Paket adı nedir ve onu nerede buluyorsunuz?

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

   • Bir paket adına genellikle uygulama kimliği denir.

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

   • Paket adı değerinin büyük/küçük harf duyarlı olduğunu ve Firebase projenize kaydolduktan 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'de 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ı

   • Hata ayıklama imzalama sertifikası SHA-1 : Firebase Authentication ( Google ile Oturum Açma veya telefon numarasıyla oturum açma kullanılırken ) ve Firebase Dynamic Links için bir SHA-1 karması gerekir.

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

   1. Firebase Android yapılandırma dosyanızı almak 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.

   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 Anlayın sayfasını ziyaret edin.

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

   • Yapılandırma dosyası adının sonuna (2) gibi ek karakterler eklenmediğinden emin olun.

2. google-services.json yapılandırma dosyanızdaki değerleri Firebase SDK'ları tarafından erişilebilir hale getirmek için Google services Gradle eklentisine ( google-services ) ihtiyacınız vardır.

   1. Kök düzeyinde (proje düzeyinde) Gradle dosyanızda ( <project>/build.gradle ), Google hizmetleri eklentisini bir buildscript 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.14'
          }
      }
      
      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üzeyi) 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üzeyi) Gradle dosyanızda (genellikle <project>/<app-module>/build.gradle ), uygulamanızda kullanmak istediğiniz Firebase ürünlerinin bağımlılıklarını ekleyin. Kitaplık sürümü oluşturmayı kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.

   Analytics etkinleştirildi

   Java

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

   Kotlin+KTX

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

   Firebase Android BoM'yi kullanarak 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:30.4.1')
   
     // 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'
   }
   

   Kotlin+KTX

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

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

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

   Çağırma-özel desteği ve şeker azaltmayı etkinleştirme konusunda bir derleme hatası mı yaşıyorsunuz? İşte nasıl düzeltileceği.

   Android Gradle eklentisi (AGP) v4.2 veya önceki sürümleri kullanan Gradle derlemelerinin Java 8 desteğini etkinleştirmesi gerekir. Aksi takdirde, bu Android projeleri bir Firebase SDK eklerken bir derleme hatası alır.

   Bu derleme hatasını düzeltmek için iki seçenekten birini uygulayabilirsiniz:

   • Hata mesajından listelenen compileOptions uygulama düzeyindeki build.gradle dosyanıza ekleyin.
   • Android projeniz için minSdkVersion 26 veya üstüne yükseltin.

   Bu SSS'de bu derleme hatası hakkında daha fazla bilgi edinin.

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

Yine de kurulum yapmakta sorun yaşıyorsanız, Android sorun giderme ve SSS sayfasını ziyaret edin.

2. Seçenek : Firebase Assistant'ı kullanarak Firebase'i 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, 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 edin
   • 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, Analitik > Bir Analiz etkinliğini günlüğe kaydet ).

   1. Android projenizi Firebase'e bağlamak için Firebase'e Bağlan'a 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ı:

        • Birden çok varyantın nasıl ele alınacağı da dahil olmak üzere, bir Firebase projesine uygulama eklemek için en iyi uygulamalarımıza göz atın.

        • 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'i kurmanızı önemle tavsiye ederiz.

      • 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 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 Assistant aracılığıyla istediğiniz kadar başka Firebase ürünü ekleyin!

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

Yine de kurulum yapmakta sorun yaşıyorsanız, Android sorun giderme ve SSS sayfası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:

• Başvuru belgeleri ( Java | Kotlin+KTX )

• Firebase Android SDK GitHub deposu

Firebase Android BoM'yi kullanırken, build.gradle içinde build.gradle kitaplık bağımlılıklarını bildirirken bağımsız kitaplık sürümleri belirtmediğinizi unutmayın.

Sonraki adımlar

Uygulamanıza Firebase hizmetleri 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.

• Crashlytics ile uygulamanızın 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 Anlayın sayfasını ziyaret edin.

• Bilmediğiniz veya Firebase ve Android geliştirmeye özgü 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 kazanın.

• Bir 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 fazla Firebase hizmetinde kullanımının genel bir resmini elde etmek için Firebase konsolundaki Kullanım ve faturalandırma panosunu izleyin.
  • Firebase başlatma kontrol listesini inceleyin.

• Firebase ve Android projenizle ilgili sorun mu yaşıyorsunuz? Android sorun giderme ve SSS sayfasını ziyaret edin.