Ön koşullar
Android Studio'yu yükleyin veya en yeni sürümüne güncelleyin.
Projenizin aşağıdaki koşulları karşıladığından emin olun (bazı ürünlerin daha katı koşulları olabileceğini unutmayın):
- API düzeyi 24 (Nougat) veya daha yüksek bir düzeyi hedeflemelidir.
- Android 7.0 veya sonraki bir sürümü kullanıyorsa
- Şu sürüm şartlarını karşılamayı içeren Jetpack (AndroidX) kullanmalıdır:
com.android.tools.build:gradle7.3.0 veya sonraki sürümlercompileSdkVersion28 veya sonraki sürümler
Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya emülatör kullanın.
Google Play services bağımlılığı olan Firebase SDK'ları için cihazda veya emülatörde Google Play services uygulamasının yüklü olması gerekir.
Henüz bir Android projeniz yoksa ve yalnızca bir Firebase ürününü denemek istiyorsanız hızlı başlangıç örneklerimizden birini indirebilirsiniz.
Android uygulamanızı Firebase'e bağlamak için aşağıdaki seçeneklerden birini kullanabilirsiniz:
- 1. seçenek: (önerilir) Firebase konsol kurulum iş akışını kullanın.
- 2. seçenek: Android Studio Firebase Assistant'ı kullanın (ek yapılandırma gerekebilir).
1. seçenek: Firebase konsolunu kullanarak Firebase'i ekleme
Uygulamanıza Firebase'i eklemek için hem Firebase konsolunda hem de açık Android projenizde görevler gerçekleştirmeniz gerekir (ö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 ekleyebilmek için 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.
2. adım: Uygulamanızı Firebase'e kaydetme
Android uygulamanızda Firebase'i kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetme işlemi genellikle uygulamanızı projenize "ekleme" olarak adlandırılır.
Firebase konsoluna gidin.
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.
Android paket adı alanına uygulamanızın paket adını girin.
(İsteğe bağlı) Uygulama takma adı girin. Bu, yalnızca Firebase konsolunda sizin görebileceğiniz dahili ve kolaylık sağlayan bir tanımlayıcıdır.
Uygulamayı kaydet'i tıklayın.
3. adım: Firebase yapılandırma dosyası ekleyin
Uygulamanızın Firebase yapılandırma dosyasını (
) indirip kod tabanınıza ekleyin:google-services.json Uygulamanızın Firebase yapılandırma dosyasını almak için google-services.json dosyasını indir'i tıklayın.
Yapılandırma dosyanızı uygulamanızın modül (uygulama düzeyinde) kök dizinine taşıyın.
yapılandırma dosyanızdaki değerleri Firebase SDK'ları için erişilebilir hale getirmek istiyorsanız Google hizmetleri Gradle eklentisi (google-services.json ) gerekir.google-services Kök düzeyindeki (proje düzeyinde) Gradle dosyanıza (
<project>/build.gradle.ktsveya<project>/build.gradle) Google hizmetleri Gradle 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.6.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.6.0' apply false }
Modülünüzün (uygulama düzeyinde) Gradle dosyasına (genellikle
<project>/<app-module>/build.gradle.ktsveya<project>/<app-module>/build.gradle) Google hizmetleri Gradle 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ünüzün (uygulama düzeyinde) Gradle dosyasında (genellikle
<project>/<app-module>/build.gradle.ktsveya<project>/<app-module>/build.gradle) uygulamanızda kullanmak istediğiniz Firebase ürünlerinin bağımlılıklarını ekleyin. Kitaplık sürümlerini kontrol etmek için Firebase Android BoM kullanmanızı öneririz.Analytics etkinleştirildi
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:35.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 kullanarak uygulamanızın her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanmasını sağlayabilirsiniz.
Analytics etkinleştirilmedi
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:35.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 kullanarak uygulamanızın her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanmasını sağlayabilirsiniz.
Kullanmak istediğiniz ürünlerin bağımlılıklarını ekledikten sonra Android projenizi Gradle dosyalarıyla senkronize edin.
Hepsi bu kadar! Önerilen sonraki adımlara göz atmak için ileri atlayabilirsiniz.
Ancak kurulumda sorun yaşıyorsanız Android sorun giderme ve SSS sayfasını ziyaret edin.
2. seçenek: Firebase'i Firebase Assistant'ı kullanarak ekleme
Firebase Assistant, uygulamanızı bir Firebase projesine kaydeder ve gerekli Firebase dosyalarını, eklentilerini ve bağımlılıklarını Android projenize ekler. Tüm bu işlemleri Android Studio'dan yapabilirsiniz.
Android projenizi Android Studio'da açın, ardından Android Studio ve Firebase Assistant'ın en yeni sürümlerini kullandığınızdan emin olun:
- Windows/Linux: Yardım > Güncellemeleri kontrol et
- macOS: Android Studio > Güncellemeleri kontrol et
Firebase Assistant'ı açın: Tools > Firebase (Araçlar > Firebase).
Assistant (Asistan) bölmesinde, uygulamanıza eklemek istediğiniz Firebase ürününü seçin. İlgili bölümü genişletin ve eğitim bağlantısını tıklayın (ör.
Analytics > Analytics etkinliği kaydet ).Android projenizi Firebase'e bağlamak için Connect to Firebase'i (Firebase'e bağlan) tıklayın.
İstediğiniz Firebase ürününü eklemek için düğmeyi tıklayın (ör.
Uygulamanıza Analytics ekleyin ).
Tüm bağımlılıkların gerekli sürümlere sahip olduğundan emin olmak için uygulamanızı senkronize edin.
Assistant (Asistan) bölmesinde, seçtiğiniz Firebase ürünü için kalan kurulum talimatlarını uygulayın.
Firebase Assistant'ı kullanarak dilediğiniz kadar Firebase ürünü ekleyebilirsiniz.
Hepsi bu kadar! Önerilen sonraki adımlara göz atmayı unutmayın.
Ancak kurulumda 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 bunların Gradle bağımlılıkları listelenmiştir. Aşağıdaki Firebase Android kitaplıkları hakkında daha fazla bilgi edinin:
Firebase Android SDK'sı GitHub deposu
Firebase Android BoM kullanırken Gradle derleme yapılandırma dosyanızda Firebase kitaplığı bağımlılıklarını bildirirken ayrı kitaplık sürümleri belirtmediğinizi unutmayın.
| Hizmet veya Ürün | Gradle bağımlılığı | En yeni sürüm |
Analytics eklensin mi? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Firebase Android BoM (Bill of Materials) |
com.google.firebase:firebase-bom
En yeni Firebase BoM sürümü, her Firebase Android kitaplığının en yeni 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. |
35.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Google Hizmetleri Gradle eklentisi | com.google.gms:google-services | 4.6.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| AdMob | com.google.android.gms:play-services-ads | 25.5.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic 1 | com.google.firebase:firebase-ai | 18.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI Logic On-Device | com.google.firebase:firebase-ai-ondevice | 16.0.0-beta08 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase AI KSP | com.google.firebase:firebase-ai-ksp-processor | 17.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Analytics | com.google.firebase:firebase-analytics | 24.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check özel sağlayıcı | com.google.firebase:firebase-appcheck | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check hata ayıklama sağlayıcısı | com.google.firebase:firebase-appcheck-debug | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check Google Play Integrity sağlayıcısı | com.google.firebase:firebase-appcheck-playintegrity | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Check reCAPTCHA sağlayıcısı | com.google.firebase:firebase-appcheck-recaptcha | 20.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution | com.google.firebase:firebase-appdistribution | 16.0.0-beta21 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution API | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta21 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| App Distribution eklentisi | com.google.firebase:firebase-appdistribution-gradle | 5.3.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Authentication | com.google.firebase:firebase-auth | 25.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Firestore | com.google.firebase:firebase-firestore | 27.2.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Functions for Firebase Client SDK | com.google.firebase:firebase-functions | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Messaging | com.google.firebase:firebase-messaging | 26.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Cloud Storage | com.google.firebase:firebase-storage | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics | com.google.firebase:firebase-crashlytics | 21.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | 21.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Crashlytics eklentisi | com.google.firebase:firebase-crashlytics-gradle | 3.0.8 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dinamik özellik modülü desteği | com.google.firebase:firebase-dynamic-module-support | 16.0.0-beta05 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging | com.google.firebase:firebase-inappmessaging | 23.0.0 | (zorunlu) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| In-App Messaging Görüntülü Reklam Ağı | com.google.firebase:firebase-inappmessaging-display | 23.0.0 | (zorunlu) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase yükleme | com.google.firebase:firebase-installations | 20.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoring | com.google.firebase:firebase-perf | 23.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Performance Monitoring eklentisi | com.google.firebase:perf-plugin | 2.0.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Firebase Phone Number Verification | com.google.firebase:firebase-pnv | 17.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Realtime Database | com.google.firebase:firebase-database | 23.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Remote Config | com.google.firebase:firebase-config | 24.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| SQL Connect 2 | com.google.firebase:firebase-dataconnect | 18.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| DESTEKLENMEYEN VEYA KULLANIMDAN KALDIRILAN KİTAPLIKLAR | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Dynamic Links | com.google.firebase:firebase-dynamic-links | 22.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Firebase KTX modülleri artık desteklenmiyor
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Firebase ML ve Firebase ML Kit kitaplıkları
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1 Firebase AI Logic, daha önce com.google.firebase:firebase-vertexai paketiyle "Vertex AI in Firebase" olarak adlandırılıyordu.
2 Firebase SQL Connect, daha önce "Firebase Data Connect" olarak adlandırılıyordu.
Sonraki adımlar
Uygulamanıza Firebase hizmetlerini ekleme:
Firebase AI Logic ile Gemini modellerini kullanarak üretken yapay zeka özellikleri oluşturun.
Analytics ile kullanıcı davranışları hakkında bilgi edinin.
Authentication ile kullanıcı kimlik doğrulama akışı oluşturun.
Kullanıcı bilgileri gibi verileri Cloud Firestore veya Realtime Database ile depolama
Fotoğraf ve video gibi dosyaları Cloud Storage 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:
Firebase projeleri ve projelerle ilgili en iyi uygulamalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama başlıklı makaleyi inceleyin.
Firebase ve Android geliştirmeye özgü veya bilmediğiniz kavramlar hakkında sorularınız varsa Android ve Firebase hakkında daha fazla bilgi sayfasını ziyaret edin.
Örnek Firebase uygulamalarını inceleyin.
Firebase Android Codelab ile uygulamalı deneyim kazanın.
Firebase in a Weekend kursuyla daha fazla bilgi edinin.
Uygulamanızı kullanıma sunmaya hazırlanma:
- Google Cloud konsolunda projeniz için bütçe uyarıları ayarlayın.
- Projenizin birden fazla Firebase hizmetindeki kullanımına dair genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase lansman yapılacaklar listesini inceleyin.
Firebase ve Android projenizle ilgili sorun mu yaşıyorsunuz? Android sorun giderme ve SSS sayfasını ziyaret edin.