Android projenize Firebase ekleyin

Önkoşullar

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

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

  • API düzeyi 19 (KitKat) veya üstünü hedefler
  • Android 4.4 veya üstünü 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 üzeri
    • 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, cihazda veya emülatörde Google Play hizmetlerinin yüklü olmasını gerektirdiğini unutmayın.

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

Henüz 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 konsolu 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'i 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).

1. Adım : Firebase projesi oluşturun

Firebase'i Android uygulamanıza ekleyebilmeniz için öncelikle Android uygulamanıza bağlanacak 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. Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasındaki Android simgesine ( plat_android ) veya Uygulama ekle öğesine tıklayın.

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

   Paket adı nedir ve onu nerede bulacaksınız?

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

   • Paket adına genellikle uygulama kimliği denir.

   • 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 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'de 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ı

   • İmzalama sertifikasında hata ayıklama SHA-1 : Firebase Authentication ( Google Oturum Açma veya telefon numarasıyla oturum açma kullanılırken) ve Firebase Dynamic Links için bir SHA-1 karma değeri 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ı ( 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 İ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 tekrar indirebilirsiniz.

   • Yapılandırma dosyası adına (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ını sağlamak için Google hizmetleri Gradle eklentisine ( google-services ) ihtiyacınız vardır.

   1. Kök düzeyindeki (proje düzeyi) Gradle dosyanıza ( <project>/build.gradle.kts veya <project>/build.gradle ), Google hizmetleri eklentisini bağımlılık olarak ekleyin:

      Kotlin

      plugins {
        id("com.android.application") version "7.2.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.3.15" apply false
      }
      

      Groovy

      plugins {
        id 'com.android.application' version '7.2.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.3.15' apply false
      }
      

   2. Modülünüzün (uygulama düzeyi) Gradle dosyasına (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle ), Google hizmetleri eklentisini ekleyin:

      Kotlin

      plugins {
        id("com.android.application")
      
        // Add the Google services Gradle plugin
        id("com.google.gms.google-services")
        // ...
      }
      

      Groovy

      plugins {
        id 'com.android.application'
      
        // Add the Google services Gradle plugin
        id 'com.google.gms.google-services'
        // ...
      }
      

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

1. Modül (uygulama düzeyi) Gradle dosyanıza (genellikle <project>/build.gradle.kts veya <project>/build.gradle ), uygulamanızda kullanmak istediğiniz Firebase ürünlerine yönelik bağımlılıkları ekleyin. Kitaplık sürümlerini kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.

   Analiz etkin

   Kotlin+KTX

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

   Java

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

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

   Analiz etkinleştirilmedi

   Kotlin+KTX

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

   Java

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

   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ünlerin bağımlılıklarını ekledikten sonra Android projenizi Gradle dosyalarıyla senkronize edin.

   Özel destek çağırma ve şeker gidermeyi etkinleştirme konusunda derleme hatası mı alıyorsunuz? İşte bunu nasıl düzelteceğiniz.

   Android Gradle eklentisi (AGP) v4.2 veya önceki sürümünü kullanan Gradle derlemelerinin Java 8 desteğini etkinleştirmesi gerekir. Aksi takdirde, bu Android projeleri Firebase SDK'sı eklenirken derleme hatasıyla karşılaşılır.

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

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

   Bu SSS bölümünde bu derleme hatası hakkında daha fazla bilgi edinin.

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

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

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

Firebase Asistanı, uygulamanızı bir Firebase projesine kaydeder ve gerekli Firebase dosyalarını, eklentilerini ve bağımlılıklarını Android projenize ekler; üstelik hepsi Android Studio'nun içinden!

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

3. Asistan bölmesinde uygulamanıza eklenecek Firebase ürününü seçin. Bölümünü genişletin ve ardından eğitim bağlantısını tıklayın (örneğin, Analytics > Bir Analytics etkinliğini 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 oluşturmaya ilişkin bazı ipuçları:

        • Birden çok değişkenin nasıl ele alınacağı da dahil olmak üzere, bir Firebase projesine uygulama eklemeye yönelik en iyi uygulamalarımıza göz atın.

        • Yeni bir proje oluşturursanız, projeniz için birçok Firebase ürününü kullanırken en iyi deneyimi yaşamanıza olanak tanıyan Google Analytics'i kurmanızı önemle tavsiye ederiz.

      • Bu iş akışı aynı zamanda 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 Firebase ürününü eklemek için düğmeyi tıklayın (örneğin, Analytics'i uygulamanıza 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 Asistanı aracılığıyla istediğiniz kadar başka Firebase ürünü ekleyin!

Bu kadar! Önerilen sonraki adımlara göz atmayı unutmayın.

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

Mevcut kütüphaneler

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

• Referans belgeleri ( Kotlin+KTX | Java )

• Firebase Android SDK GitHub deposu

Firebase Android BoM'yi kullanırken, Gradle derleme yapılandırma dosyanızda Firebase kitaplığı bağımlılıklarını bildirirken ayrı kitaplık sürümlerini belirtmediğinizi unutmayın.

Sonraki adımlar

Firebase hizmetlerini uygulamanıza ekleyin:

• Analytics ile kullanıcı davranışına ilişkin öngörüler elde edin.

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

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

• Fotoğraf ve video gibi dosyaları Bulut Depolama ile depolayın.

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

• Cloud Messaging ile bildirim gönderin.

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

Firebase hakkında bilgi edinin:

• Firebase projeleri ve projelere yönelik en iyi uygulamalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlayın sayfasını ziyaret edin.

• Bilinmeyen veya Firebase ve Android geliştirmeye ö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 fazla Firebase hizmetindeki 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 bölümünü ziyaret edin.