Ö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:gradlev7.3.0 veya üstü
-
compileSdkVersion28 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.
Firebase projesi oluşturma
Firebase konsolunda Proje ekle'yi tıklayın.
Firebase kaynaklarını mevcut bir Google Cloud projesine 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. İsteğe bağlı olarak proje adının altında görüntülenen proje kimliğini de düzenleyebilirsiniz.
İstenirse Firebase şartlarını inceleyip kabul edin.
Devam'ı tıklayın.
(İsteğe bağlı) Projeniz için, aşağıdaki Firebase ürünlerinden herhangi birini kullanırken en iyi deneyimi yaşamanıza olanak tanıyan Google Analytics'i kurun:
Mevcut bir Google Analytics hesabını seçin veya yeni bir hesap oluşturun.
Yeni bir hesap oluşturursanız Analytics raporlama konumunuzu seçin ve ardından projeniz için veri paylaşım ayarlarını ve Google Analytics şartlarını kabul edin.
Proje oluştur'u (veya mevcut bir Google Cloud projesini kullanıyorsanız Firebase Ekle'yi ) tıklayın.
Firebase, Firebase projeniz için kaynakları otomatik olarak hazırlar. İşlem tamamlandığında Firebase konsolundaki Firebase projenizin genel bakış sayfasına yönlendirileceksiniz.
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.
Firebase konsoluna gidin.
Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasındaki Android simgesine () veya Uygulama ekle öğesine tıklayın.
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.
(İ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.
Uygulamayı kaydet'i tıklayın.
3. Adım : Firebase yapılandırma dosyası ekleyin
Firebase Android yapılandırma dosyasını (
) indirin ve ardından uygulamanıza ekleyin:
google-services.json
Firebase Android yapılandırma dosyanızı edinmek için Google-services.json'u İndir'i tıklayın.
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.
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.json
google-services) ihtiyacınız vardır.
Kök düzeyindeki (proje düzeyi) Gradle dosyanıza (
<project>/build.gradle.ktsveya
<project>/build.gradle), Google hizmetleri eklentisini bağımlılık olarak ekleyin:
Kotlin
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.0" apply false }
Groovy
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.0' apply false }
Modülünüzün (uygulama düzeyi) Gradle dosyasına (genellikle
<project>/<app-module>/build.gradle.ktsveya
<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
Modül (uygulama düzeyi) Gradle dosyanıza (genellikle
<project>/<app-module>/build.gradle.ktsveya
<project>/<app-module>/build.gradle), Firebase ürünlerine yönelik bağımlılıkları ekleyin Uygulamanızda kullanmak istediğiniz Kitaplık sürümlerini kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.
Analiz etkin
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:32.6.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.
Kotlin'e özgü bir kütüphane modülü mü arıyorsunuz? Ekim 2023'ten itibaren (Firebase BoM 32.5.0) hem Kotlin hem de Java geliştiricileri ana kütüphane modülüne güvenebilecekler (ayrıntılar için bu girişimle ilgili SSS'ye bakın).
Analiz etkinleştirilmedi
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:32.6.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.
Kotlin'e özgü bir kütüphane modülü mü arıyorsunuz? Ekim 2023'ten itibaren (Firebase BoM 32.5.0) hem Kotlin hem de Java geliştiricileri ana kütüphane modülüne güvenebilecekler (ayrıntılar için bu girişimle ilgili SSS'ye bakın).
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
compileOptionsuygulama düzeyindeki
build.gradle.ktsveya
build.gradledosyanıza ekleyin.
- Android projeniz için
minSdk26 veya üstüne yükseltin.
Bu SSS bölümünde bu derleme hatası hakkında daha fazla bilgi edinin.
- Hata mesajında listelenen
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!
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
Firebase Asistanını açın: Araçlar > Firebase .
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).
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ı (
) uygulamanızın modül (uygulama düzeyi) dizinine de ekler.
google-services.json
İstediğiniz Firebase ürününü eklemek için düğmeyi tıklayın (örneğin,
Analytics'i uygulamanıza ekleyin).
Tüm bağımlılıkların gerekli sürümlere sahip olduğundan emin olmak için uygulamanızı senkronize edin.
Asistan bölmesinde, seçtiğiniz Firebase ürününüz için kalan kurulum talimatlarını izleyin.
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:
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.
|Hizmet veya Ürün||Gradle bağımlılığı|| En sonuncu|
versiyon
|Analytics eklensin mi?|
| Firebase Android BoM'si|
(Malzeme Listesi)
| 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. Hangi kitaplık sürümlerinin belirli bir BoM sürümüyle eşlendiğini öğrenmek için söz konusu BoM sürümüne ilişkin sürüm notlarını inceleyin.
|32.6.0|
|AdMob||com.google.android.gms:play-services-ads||22.5.0|
|Analitik||com.google.firebase:firebase-analytics||21.5.0|
|Uygulama Kontrolü özel sağlayıcısı||com.google.firebase:firebase-appcheck||17.1.1|
|Uygulama Kontrolü hata ayıklama sağlayıcısı||com.google.firebase:firebase-appcheck-debug||17.1.1|
|Uygulama Kontrolü Play Bütünlüğü sağlayıcısı||com.google.firebase:firebase-appcheck-playintegrity||17.1.1|
|Uygulama Dağıtımı||com.google.firebase:firebase-appdistribution||16.0.0-beta11|
|Uygulama Dağıtım API'si||com.google.firebase:firebase-appdistribution-api||16.0.0-beta11|
|Uygulama Dağıtımı eklentisi||com.google.firebase:firebase-appdistribution-gradle||4.0.1|
|Kimlik doğrulama||com.google.firebase:firebase-auth||22.3.0|
|Bulut Firestore||com.google.firebase:firebase-firestore||24.9.1|
|Firebase İstemci SDK'sı için Bulut İşlevleri||com.google.firebase:firebase-işlevleri||20.4.0|
|Bulut Mesajlaşma||com.google.firebase:firebase-mesajlaşma||23.3.1|
|Bulut depolama||com.google.firebase:firebase-depolama||20.3.0|
|Crashlytics||com.google.firebase:firebase-crashlytics||18.6.0|
|Crashlytics NDK||com.google.firebase:firebase-crashlytics-ndk||18.6.0|
|Crashlytics eklentisi||com.google.firebase:firebase-crashlytics-gradle||2.9.9|
|Dinamik özellik modülü desteği||com.google.firebase:firebase-dynamic-module-support||16.0.0-beta03|
|Dinamik Bağlantılar||com.google.firebase:firebase-dinamik-bağlantılar||21.2.0|
|Uygulama İçi Mesajlaşma||com.google.firebase:firebase-inappmessaging||20.4.0|
(gerekli)
|Uygulama İçi Mesajlaşma Ekranı||com.google.firebase:firebase-inappmessaging-display||20.4.0|
(gerekli)
|Firebase kurulumları||com.google.firebase:firebase-installations||17.2.0|
|Firebase ML Model İndirici API'si||com.google.firebase:firebase-ml-modeldownloader||24.2.1|
|Performans İzleme||com.google.firebase:firebase-perf||20.5.1|
|Performans İzleme eklentisi||com.google.firebase:perf-eklentisi||1.4.2|
|Gerçek Zamanlı Veritabanı||com.google.firebase:firebase-veritabanı||20.3.0|
|Uzaktan Yapılandırma||com.google.firebase:firebase-config||21.6.0|
|Google Play hizmetleri eklentisi||com.google.gms:google-hizmetleri||4.4.0|
|KULLANIMDAN KALDIRILMIŞ KÜTÜPHANELER|
|Uygulama Kontrolü SafetyNet sağlayıcısı||com.google.firebase:firebase-appcheck-safetynet||16.1.2|
|Uygulama Dizine Ekleme||com.google.firebase:firebase-appindexing||20.0.0|
Firebase KTX modülleri
Firebase ML Kit kitaplıkları
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.
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:
Firebase ve Android projenizle ilgili sorun mu yaşıyorsunuz? Android sorun giderme ve SSS sayfasını ziyaret edin.