Ön koşullar
Android Studio'yu yükleyin veya en son sürümüne güncelleyin.
Projenizin şu gereklilikleri karşıladığından emin olun (bazı ürünlerin daha katı gereksinimler olabileceğini unutmayın):
- API düzeyi 19 (KitKat) veya üstünü hedefler
- Android 4.4 veya sonraki bir sürümü çalıştıran
- Aşağıdaki sürüm gereksinimlerinin karşılanmasını da içeren Jetpack (AndroidX)
uygulamasını kullanmalıdır:
com.android.tools.build:gradle
7.3.0 veya sonraki sürümlercompileSdkVersion
28 veya üzeri
Uygulamanızı çalıştırmak için fiziksel bir cihaz kurun veya emülatör kullanın.
Google Play hizmetlerine bağımlılığı olan Firebase SDK'larının, cihaz 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.
Halihazırda 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 konsolu kurulum iş akışını kullanın.
- 2. Seçenek: Android Studio Firebase Asistan'ı kullanın (ek yapılandırma gerekebilir).
1. seçenek: Firebase konsolunu kullanarak Firebase'i ekleyin
Firebase'i uygulamanıza eklemek için hem Firebase konsolunda hem de açık Android projenizde çeşitli işlemler bulunur (ö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 ö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 sayfasını ziyaret edin.
2. Adım: Uygulamanızı Firebase'e kaydedin
Android uygulamanızda Firebase'i kullanmak için uygulamanızı Firebase projenize kaydetmeniz gerekir. Uygulamanızı kaydetmek, genellikle uygulamanızı projenize "ekleme" olarak adlandırılır.
Firebase konsoluna gidin.
Projeye genel bakış sayfasının ortasındaki Android simgesini (
) veya kurulum iş akışını başlatmak için Uygulama ekle'yi tıklayın.Android paket adı alanına uygulamanızın paket adını girin.
(İsteğe bağlı) Diğer uygulama bilgilerini girin: Uygulama takma adı ve SHA-1 imza sertifikası hata ayıklaması.
Uygulamayı kaydet'i tıklayın.
3. Adım: Firebase yapılandırma dosyası ekleyin
Firebase Android yapılandırma dosyasını (
) indirip uygulamanıza ekleyin:google-services.json Firebase Android yapılandırma dosyanızı 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üzeyi) kök dizinine taşıyın.
yapılandırma dosyanızdaki değerlere Firebase SDK'ları tarafından erişilebilmesini sağlamak için Google hizmetleri Gradle eklentisine (google-services.json google-services
) ihtiyacınız vardır.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: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.1" 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.1' apply false }
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: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: Uygulamanıza Firebase SDK'ları ekleyin
Modül (uygulama düzeyinde) 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ü oluşturmayı kontrol etmek için Firebase Android BoM'u kullanmanızı öneririz.Analytics etkin
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.0.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 her zaman uyumlu sürümlerini kullanır.
Kotlin'e özel 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üne başvurabilir. (Ayrıntılar için Bu girişimle ilgili sık sorulan sorular bölümüne göz atın).
Analiz etkin değil
dependencies { // ... // Import the Firebase BoM implementation(platform("com.google.firebase:firebase-bom:33.0.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 her zaman uyumlu sürümlerini kullanır.
Kotlin'e özel 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üne başvurabilir. (Ayrıntılar için Bu girişimle ilgili sık sorulan sorular bölümüne göz atın).
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 bu adımı atlayabilirsiniz.
Kurulumda sorun yaşıyorsanız Android sorun giderme ve SSS sayfasını ziyaret edin.
2. Seçenek: Firebase Asistan'ı kullanarak Firebase'i ekleme
Firebase Asistan, uygulamanızı bir Firebase projesine kaydeder ve gerekli Firebase dosyalarını, eklentileri ve bağımlılıkları Android projenize ekler. Üstelik bunların hepsini Android Studio'dan yapabilirsiniz.
Android projenizi Android Studio'da açın, ardından Android Studio ve Firebase Asistan'ın en son sürümlerini kullandığınızdan emin olun:
- Windows / Linux: Yardım > Güncellemeleri denetle
- macOS: Android Studio > Güncellemeleri denetle
Firebase Asistan'ı açın: Araçlar > Firebase.
Asistan bölmesinde, uygulamanıza eklemek üzere bir Firebase ürünü seçin. İlgili bölümü genişletin ve eğitim bağlantısını tıklayın (örneğin,
Analytics > Analytics etkinliği kaydedin ).Android projenizi Firebase'e bağlamak için Firebase'e bağlan'ı tıklayın.
İstediğiniz Firebase ürününü eklemek için düğmeyi tıklayın (ör.
Analytics'i uygulamanıza ekleyin ).
Tüm bağımlılıklarda gerekli sürümlerin bulunduğundan emin olmak için uygulamanızı senkronize edin.
Asistan bölmesinde, seçili Firebase ürününüz için kalan kurulum talimatlarını uygulayın.
Firebase Asistan ile diğer Firebase ürünlerini istediğiniz kadar ekleyebilirsiniz.
Hepsi bu kadar! Önerilen sonraki adımlara mutlaka göz atın.
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ı 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 kullanırken Gradle derleme yapılandırma dosyanızda Firebase kitaplığı bağımlılıklarını tanımlarken kitaplık sürümlerini ayrı ayrı belirtmediğinizi unutmayın.
Hizmet veya Ürün | Gradle bağımlılığı | En yeni sürüm |
Analytics eklensin mi? | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Firebase Android BoM (Malzeme Listesi) |
com.google.firebase:firebase-bom
En yeni 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ünün sürüm notlarını inceleyin. |
33.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AdMob | com.google.android.gms:play-services-ads | 23.1.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Analizler | com.google.firebase:firebase-analytics | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Uygulama Kontrolü özel sağlayıcısı | com.google.firebase:firebase-appcheck | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Uygulama Kontrolü hata ayıklama sağlayıcısı | com.google.firebase:firebase-appcheck-debug | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Uygulama Kontrolü Play Integrity sağlayıcısı | com.google.firebase:firebase-appcheck-playintegrity | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Uygulama Dağıtımı | com.google.firebase:firebase-appdistribution | 16.0.0-beta12 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Distribution API | com.google.firebase:firebase-appdistribution-api | 16.0.0-beta12 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Distribution eklentisi | com.google.firebase:firebase-appdistribution-gradle | % | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Kimlik Doğrulama | com.google.firebase:firebase-auth | % | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Firestore | com.google.firebase:firebase-firestore | % | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Functions for Firebase İstemci SDK'sı | com.google.firebase:firebase-functions | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bulut Mesajlaşma | com.google.firebase:firebase-messaging | 24.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Cloud Storage | com.google.firebase:firebase-storage | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics | com.google.firebase:firebase-crashlytics | % | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics NDK | com.google.firebase:firebase-crashlytics-ndk | % | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Crashlytics eklentisi | com.google.firebase:firebase-crashlytics-gradle | 3.0.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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-dynamic-links | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Uygulama içi mesajlaşma | com.google.firebase:firebase-inappmessaging | 21.0.0 | (zorunlu) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Uygulama İçi Mesajlaşma Ekranı | com.google.firebase:firebase-inappmessaging-display | 21.0.0 | (zorunlu) |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Firebase yüklemeleri | com.google.firebase:firebase-installations | 18.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Firebase ML Model Downloader API | com.google.firebase:firebase-ml-modeldownloader | % | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Performansı İzleme | com.google.firebase:firebase-perf | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Performance Monitoring eklentisi | com.google.firebase:perf-plugin | 1.4.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Gerçek Zamanlı Veritabanı | com.google.firebase:firebase-database | 21.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Remote Config | com.google.firebase:firebase-config | 22.0.0 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Firebase için Vertex AI | com.google.firebase:firebase-vertexai | 16.0.0-beta01 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Google Play Hizmetleri eklentisi | com.google.gms:google-services | 4.4.1 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
KULLANIMDAN KALDIRILMIŞ KİTAPLIKLAR | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Uygulama Kontrolü SafetyNet sağlayıcısı | com.google.firebase:firebase-appcheck-safetynet | 16.1.2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Uygulama Dizine Ekleme | com.google.firebase:firebase-appindexing | % | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Firebase KTX modülleri
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Firebase ML Kit kitaplıkları
|
Sonraki adımlar
Uygulamanıza Firebase hizmetlerini ekleyin:
Analytics ile kullanıcı davranışları hakkında fikir edinin.
Authentication (Kimlik Doğrulama) ile bir kullanıcı kimlik doğrulama akışı ayarlayın.
Kullanıcı bilgileri gibi verileri Cloud Firestore veya Realtime Database ile depolayın.
Cloud Storage ile fotoğraf ve video gibi dosyaları 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 için Firebase Projelerini Anlama sayfasını ziyaret edin.
Firebase ve Android geliştirmeye özel veya aşina olmadığınız kavramlar hakkında sorularınız varsa Android ve Firebase hakkında daha fazla bilgi sayfasını ziyaret edin.
Örnek Firebase uygulamalarını keşfedin.
Firebase Android Codelab ile uygulamalı deneyim elde edin.
Hafta sonunda Firebase kursu ile daha fazla bilgi edinin.
Uygulamanızı kullanıma sunmaya hazırlanın:
- Google Cloud Console'da projeniz için bütçe uyarıları oluşturun.
- Projenizin birden çok Firebase hizmetindeki kullanımına ilişkin genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase lansmanları için yapılacaklar listesini inceleyin.
Firebase'le ve Android projenizle ilgili sorun mu yaşıyorsunuz? Android sorun giderme ve SSS sayfasını ziyaret edin.