Firebase'i Android projenize ekleyin

Ön koşullar

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

  • Projenizin bu koşulları karşıladığından emin olun (bazı ürünlerde daha katı koşullar olabileceğini unutmayın):

    • API düzeyi 21'i (Lollipop) veya üstünü hedefliyor
    • Android 5.0 veya sonraki sürümleri kullanıyor
    • Şu sürüm şartlarını karşılamak da dahil olmak üzere Jetpack (AndroidX) kullanır:
      • com.android.tools.build:gradle v7.3.0 veya sonraki sürümler
      • compileSdkVersion 28 veya sonraki sürümler
  • Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya emülatör kullanın.
    Google Play Hizmetleri'ne bağımlı Firebase SDK'larının cihazda veya emülatörde Google Play Hizmetleri'nin yüklü olmasını gerektirdiğini unutmayın.

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

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


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

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



1. seçenek: Firebase konsolunu kullanarak Firebase'i ekleme

Firebase'i uygulamanıza eklemek hem Firebase konsolunda hem de açık Android projenizde görevler içerir (örneğin, Firebase yapılandırma dosyalarını konsoldan indirip Android projenize taşırsınız).

1. adım: Firebase projesi oluşturun

Firebase'i Android uygulamanıza eklemeden önce, Android uygulamanıza bağlanacak bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama başlıklı makaleyi inceleyin.

  1. Firebase konsolunda Proje ekle'yi tıklayın.

    • Mevcut bir Google Cloud projesine Firebase kaynağı eklemek için proje adını girin veya açılır menüden seçin.

    • Yeni bir proje oluşturmak için istediğiniz proje adını girin. İsterseniz proje adının altında görüntülenen proje kimliğini de düzenleyebilirsiniz.

  2. İstenirse Firebase şartlarını inceleyip kabul edin.

  3. Devam'ı tıklayın.

  4. (İsteğe bağlı) Projeniz için Google Analytics'yi ayarlayın. Bu, aşağıdaki Firebase ürünlerinden herhangi birini kullanırken optimum bir deneyim yaşamanızı sağlar:

    Mevcut bir Google Analytics hesabını seçin veya yeni hesap oluşturun.

    Yeni bir hesap oluşturursanız Analytics raporlama konumunuzu seçin, ardından projeniz için veri paylaşım ayarlarını ve Google Analytics şartlarını kabul edin.

  5. Proje oluştur'u (veya mevcut bir Google Cloud projesi kullanıyorsanız Firebase ekle'yi) tıklayın.

Firebase, Firebase projeniz için kaynakları otomatik olarak sağlar. İşlem tamamlandığında Firebase konsolunda Firebase projenizin genel bakış sayfasına yönlendirilirsiniz.

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

Firebase'i Android uygulamanızda kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetme işlemine genellikle uygulamanızı projenize "ekleme" denir.

  1. Firebase konsoluna gidin.

  2. Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasından Android simgesini () veya Uygulama ekle'yi tıklayın.

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

    • Paket adı, uygulamanızı cihazda ve Google Play Store'da 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üzün (uygulama düzeyinde) Gradle dosyasında bulun. Bu dosya genellikle app/build.gradle (örnek paket adı: com.yourcompany.yourproject) dosyasıdır.

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

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

    1. Firebase Android yapılandırma dosyanızı almak için google-services.json dosyasını indir'i tıklayın.

    2. Yapılandırma dosyanızı uygulamanızın modül (uygulama düzeyinde) kök dizinine taşıyın.

    • Firebase yapılandırma dosyasında projenize özgü, gizli olmayan tanımlayıcılar bulunur. Bu yapılandırma dosyası hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama başlıklı makaleyi inceleyin.

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

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

  2. google-services.json yapılandırma dosyanızdaki değerlerin Firebase SDK'larına erişilebilir olmasını sağlamak için Google hizmetleri Gradle eklentisini (google-services) kullanmanız gerekir.

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

      KotlinGroovy
      plugins {
        id("com.android.application") version "7.3.0" apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id("com.google.gms.google-services") version "4.4.2" apply false
      }
      plugins {
        id 'com.android.application' version '7.3.0' apply false
        // ...
      
        // Add the dependency for the Google services Gradle plugin
        id 'com.google.gms.google-services' version '4.4.2' apply false
      }
    2. Modül (uygulama düzeyi) Gradle dosyanıza (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) Google hizmetleri eklentisini ekleyin:

      KotlinGroovy
      plugins {
        id("com.android.application")
      
        // Add the Google services Gradle plugin
        id("com.google.gms.google-services")
        // ...
      }
      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ını ekleyin

  1. Modül (uygulama düzeyi) Gradle dosyanıza (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle) uygulamanızda kullanmak istediğiniz Firebase ürünlerinin bağımlılıklarını ekleyin. Kitaplık sürümünü kontrol etmek için Firebase Android BoM kullanmanızı öneririz.

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.7.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 kullanıldığında uygulamanız Firebase Android kitaplıklarının daima uyumlu sürümlerini kullanır.

    Kotlin'e özgü bir kitaplık modülü mü arıyorsunuz? Ekim 2023'ten (Firebase BoM 32.5.0) itibaren hem Kotlin hem de Java geliştiricileri ana kitaplık modülünden yararlanabilir (ayrıntılar için bu girişimle ilgili SSS bölümüne bakın).

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:33.7.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 kullanıldığında uygulamanız Firebase Android kitaplıklarının daima uyumlu sürümlerini kullanır.

    Kotlin'e özgü bir kitaplık modülü mü arıyorsunuz? Ekim 2023'ten (Firebase BoM 32.5.0) itibaren hem Kotlin hem de Java geliştiricileri ana kitaplık modülünden yararlanabilir (ayrıntılar için bu girişimle ilgili SSS bölümüne bakın).

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

    Android Gradle eklentisi (AGP) 4.2 veya önceki sürümleri kullanan Gradle derlemelerinde Java 8 desteğinin etkinleştirilmesi gerekir. Aksi takdirde, bu Android projelerine Firebase SDK'sı eklenirken derleme hatası oluşur.

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

    • Hata mesajında listelenen compileOptions öğesini uygulama düzeyindeki build.gradle.kts veya build.gradle dosyanıza ekleyin.
    • Android projenizin minSdk değerini 26 veya daha yüksek bir değere yükseltin.

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

Hepsi bu kadar! Önerilen sonraki adımlara göz atmak için ileriye atlayabilirsiniz.

Kurulum sırasında sorun yaşıyorsanız Android sorun giderme ve SSS sayfasını ziyaret edin.



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

Firebase Asistanı, uygulamanızı bir Firebase projesine kaydeder ve gerekli Firebase dosyalarını, eklentilerini ve bağımlılıklarını Android Studio'dan Android projenize ekler.

  1. Android Studio'da Android projenizi açın, ardından Android Studio ve Firebase Asistanı'nı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 ekleyeceğiniz bir Firebase ürünü seçin. Bölümünü genişletip eğitim bağlantısını tıklayın (ör. Analytics > Analytics etkinliği kaydetme).

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

      • 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şturmayla ilgili bazı ipuçları aşağıda verilmiştir:

        • Birden fazla varyantın nasıl ele alınacağı da dahil olmak üzere Firebase projesine uygulama eklemeyle ilgili en iyi uygulamalarımıza göz atın.

        • Yeni bir proje oluşturursanız projeniz için Google Analytics ayarlamanızı önemle tavsiye ederiz. Bu ayar, birçok Firebase ürününü kullanırken 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 Firebase ürününü eklemek için düğmeyi tıklayın (örneğin, Analytics'yi uygulamanıza ekleyin).

  4. Tüm bağımlılarda gerekli sürümlerin bulunduğ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 Asistanı aracılığıyla istediğiniz kadar Firebase ürünü ekleyin.

Hepsi bu kadar! Önerilen sonraki adımlara göz atın.

Kurulum sırasında sorun yaşıyorsanız Android sorun giderme ve SSS sayfasını ziyaret edin.



Kullanılabilen kitaplıklar

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

Firebase Android BoM kullanırken Gradle derleme yapılandırma dosyanızda Firebase kitaplık bağımlılıkları için kitaplık sürümlerini tek tek belirtmediğinizi unutmayın.

Hizmet veya Ürün Gradle bağımlılığı En son
sürüm
Analytics eklensin mi?
Firebase Android BoM
(Bill of Materials)
com.google.firebase:firebase-bom

En son Firebase BoM sürümü, her Firebase Android kitaplığının en son sürümlerini içerir. Belirli bir BoM sürümüyle eşlenen kitaplık sürümlerini öğrenmek için ilgili BoM sürümünün sürüm notlarını inceleyin.

33.7.0
AdMob com.google.android.gms:play-services-ads 23.6.0
Analytics com.google.firebase:firebase-analytics 22.1.2
App Check özel sağlayıcı com.google.firebase:firebase-appcheck 18.0.0
App Check hata ayıklama sağlayıcısı com.google.firebase:firebase-appcheck-debug 18.0.0
App Check Play Integrity sağlayıcısı com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta14
App Distribution API com.google.firebase:firebase-appdistribution-api 16.0.0-beta14
App Distribution eklentisi com.google.firebase:firebase-appdistribution-gradle 5.0.0
Authentication com.google.firebase:firebase-auth 23.1.0
Cloud Firestore com.google.firebase:firebase-firestore 25.1.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 21.1.0
Cloud Messaging com.google.firebase:firebase-messaging 24.1.0
Cloud Storage com.google.firebase:firebase-storage 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics 19.3.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 19.3.0
Crashlytics eklentisi com.google.firebase:firebase-crashlytics-gradle 3.0.2
Dinamik özellik modülü desteği com.google.firebase:firebase-dynamic-module-support 16.0.0-beta03
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 21.0.1
(zorunlu)
In-App Messaging Görüntülü Reklam Ağı com.google.firebase:firebase-inappmessaging-display 21.0.1
(zorunlu)
Firebase yükleme com.google.firebase:firebase-installations 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 25.0.1
Performance Monitoring com.google.firebase:firebase-perf 21.0.3
Performance Monitoring eklentisi com.google.firebase:perf-plugin 1.4.2
Realtime Database com.google.firebase:firebase-database 21.0.0
Remote Config com.google.firebase:firebase-config 22.0.1
Vertex AI in Firebase com.google.firebase:firebase-vertexai 16.0.2
Google Play Hizmetleri eklentisi com.google.gms:google-services 4.4.2
KULLANIMDAN KALDIRILMIŞ KİTAPLIKLAR
App Check SafetyNet sağlayıcısı com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0
Analytics com.google.firebase:firebase-analytics-ktx 22.1.2
App Check özel sağlayıcı com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta14
Authentication com.google.firebase:firebase-auth-ktx 23.1.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.1
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.1.0
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.0
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.1
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.3.0
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.1
(zorunlu)
In-App Messaging Görüntülü Reklam Ağı com.google.firebase:firebase-inappmessaging-display-ktx 21.0.1
(zorunlu)
Firebase yükleme com.google.firebase:firebase-installations-ktx 18.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.1
Performance Monitoring com.google.firebase:firebase-perf-ktx 21.0.3
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.0.1
Firebase ML Özel Model API'leri com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API'ler com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: Resim Etiketleme Modeli com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: Nesne Algılama ve İzleme Modeli com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: Yüz Algılama Modeli com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: Barkod Tarama Modeli com.google.firebase:firebase-ml-vision-barcode-model 16.1.2
Firebase ML: AutoML Vision Edge API com.google.firebase:firebase-ml-vision-automl 18.0.6
Firebase ML: Natural Language API'ler com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: Dil Tanımlama Modeli com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Modeli Çevir com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: Akıllı Yanıt Modeli com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8



Sonraki adımlar

Firebase hizmetlerini uygulamanıza ekleyin:

Firebase hakkında bilgi edinin: