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 ( plat_android ) veya Uygulama ekle'yi tıklayın.

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

   Paket adı nedir ve onu nerede bulursunuz?

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

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

   • Uygulamanızın paket adını modül (uygulama düzeyinde) Gradle dosyanızda 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 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ı : Firebase konsolunda yalnızca sizin görebileceğiniz dahili, kullanışlı bir tanımlayıcı

   • SHA-1 imzalama sertifikasında hata ayıklama : Firebase Kimlik Doğrulaması ( Google ile Oturum Açma veya telefon numarasıyla oturum açma kullanılırken ) ve Firebase Dynamic Links tarafından 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 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.

   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ının sonuna (2) gibi ek karakterler eklenmediğinden emin olun.

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:31.2.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:31.2.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:31.2.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:31.2.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.

   Özel çağırma desteği ve şeker gidermeyi etkinleştirme hakkında bir derleme hatası mı alıyorsunuz? Bunu nasıl düzelteceğiniz aşağıda açıklanmıştır.

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

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

   • Hata mesajındaki 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.

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.

      Bu iş akışı ne yapar?

      • 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 değişkenin 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, birçok Firebase ürününü kullanarak en iyi deneyimi yaşamanızı sağlayan Google Analytics'i projeniz için kurmanızı önemle tavsiye ederiz.

      • Bu iş akışı ayrıca Firebase projenizin Android yapılandırma dosyasını ( google-services.json ) uygulamanızın modül (uygulama düzeyi) dizinine 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ü 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:

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

• Firebase Android SDK GitHub deposu

Firebase Android BoM'yi kullanırken, build.gradle kitaplık bağımlılıklarını bildirirken ayrı ayrı kitaplık sürümlerini 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ışı kurun.

• 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 bildirim 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.
  • Birden fazla Firebase hizmetinde projenizin kullanımının genel bir resmini elde etmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini 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.