Önkoşullar
Android Studio'yu en son sürümüne yükleyin veya güncelleyin.
Projenizin şu gereksinimleri karşıladığından emin olun:
- API seviyesi 16 (Jelly Bean) veya daha üstünü hedefler
- Gradle 4.1 veya üzerini 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 üstü -
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 , cihazın veya emülatörün Google Play hizmetlerinin 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.
Aşağıdaki seçeneklerden birini kullanarak Android uygulamanızı Firebase'e bağlayabilirsiniz:
- 1. Seçenek : (önerilir) Firebase konsolu kurulum iş akışını kullanın.
- 2. Seçenek : Android Studio Firebase Assistant'ı kullanın (ek yapılandırma gerektirebilir).
1. Seçenek : Firebase konsolunu kullanarak Firebase 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, ardından bunları Android projenize taşırsınız).
1. Adım : Firebase projesi oluşturun
Firebase'i Android uygulamanıza eklemeden önce, Android uygulamanıza bağlanmak için bir Firebase projesi oluşturmanız gerekir. Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama bölümü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.
Projeye genel bakış sayfasının
, kurulum iş akışını başlatmak için Android simgesini ( ) veya Uygulama tıklayın.Android paket adı alanına uygulamanızın paket adını girin.
Paket adı , uygulamanızı cihazda ve Google Play Store'da benzersiz şekilde tanımlar.
Paket adı genellikle uygulama kimliği olarak anılır.
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 bu Firebase Android uygulaması için Firebase projenize kaydolduktan sonra 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 .
Uygulama takma adı : Yalnızca Firebase konsolunda görebileceğiniz dahili, kullanışlı bir tanımlayıcı
SHA-1 imzalama sertifikasında hata ayıklama : Firebase Authentication ( Google ile Oturum Açma veya telefon numarasıyla oturum açarken) ve Firebase Dynamic Links için bir SHA-1 hash gereklidir.
Uygulamayı kaydet'i tıklayın.
3. Adım : Firebase yapılandırma dosyası ekleyin
Firebase Android yapılandırma dosyasını uygulamanıza ekleyin:
Firebase Android yapılandırma dosyanızı (
) edinmek için google-services.json indir'i tıklayın.google-services.json Yapılandırma dosyanızı uygulamanızın modül (uygulama düzeyi) dizinine taşıyın.
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 Anlama sayfasını ziyaret edin.
Firebase yapılandırma dosyanızı istediğiniz zaman tekrar indirebilirsiniz.
Yapılandırma dosyası adına
(2)
gibi ek karakterlerin eklenmediğinden emin olun.
Uygulamanızda Firebase ürünlerini etkinleştirmek için Google hizmetleri eklentisini Gradle dosyalarınıza ekleyin.
Kök düzeyinde (proje düzeyinde) Gradle dosyanıza (
build.gradle
), Google Hizmetleri Gradle eklentisini dahil etmek için kurallar ekleyin. Google'ın Maven deposuna sahip olduğunuzu da kontrol edin.buildscript { repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository } dependencies { // ... // Add the following line: classpath 'com.google.gms:google-services:4.3.5' // Google Services plugin } } allprojects { // ... repositories { // Check that you have the following line (if not, add it): google() // Google's Maven repository // ... } }
Modülünüzde (uygulama düzeyinde) Gradle dosyanızda (genellikle
app/build.gradle
), Google Services Gradle eklentisini uygulayın:apply plugin: 'com.android.application' // Add the following line: apply plugin: 'com.google.gms.google-services' // Google Services plugin android { // ... }
4. Adım : Firebase SDK'larını uygulamanıza ekleyin
Firebase Android BoM'yi kullanarak, uygulamanızda kullanmak istediğiniz Firebase ürünleri için bağımlılıkları bildirin . Bunları modül (uygulama düzeyi) Gradle dosyanızda (genellikle
app/build.gradle
)app/build.gradle
.Analytics etkinleştirildi
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:27.0.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics' // Declare the dependencies for any other desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kotlin + KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:27.0.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependency for the Firebase SDK for Google Analytics implementation 'com.google.firebase:firebase-analytics-ktx' // Declare the dependencies for any other desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Firebase Android BoM'yi kullandığınızda , uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.
Analytics etkinleştirilmedi
Java
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:27.0.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependencies for the desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth' implementation 'com.google.firebase:firebase-firestore' }
Kotlin + KTX
dependencies { // ... // Import the Firebase BoM implementation platform('com.google.firebase:firebase-bom:27.0.0') // When using the BoM, you don't specify versions in Firebase library dependencies // Declare the dependencies for the desired Firebase products // For example, declare the dependencies for Firebase Authentication and Cloud Firestore implementation 'com.google.firebase:firebase-auth-ktx' implementation 'com.google.firebase:firebase-firestore-ktx' }
Firebase Android BoM'yi kullandığınızda , uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.
Tüm bağımlılıkların gerekli sürümlere sahip olduğundan emin olmak için uygulamanızı senkronize edin.
Bu kadar! Önerilen sonraki adımlara göz atmak için ilerleyebilirsiniz .
2. Seçenek : Firebase Assistant'ı kullanarak Firebase ekleyin
Firebase Assistant , uygulamanızı bir Firebase projesine kaydeder ve gerekli Firebase dosyalarını, eklentileri ve bağımlılıkları Android projenize ekler - tümü Android Studio'nun içinden!
Android projenizi Android Studio'da açın ve Firebase Assistant'a erişin:
Android Studio'nun ve Firebase Assistant'ın en son sürümlerini kullandığınızdan emin olmak için Dosya> Güncellemeleri kontrol et'e gidin.
Asistan bölmesini açmak için Araçlar> Firebase'e gidin.
Uygulamanıza eklemek için bir Firebase ürünü seçin. Bölümünü genişletin, ardından eğitici bağlantısını tıklayın (örneğin,
Analytics> Bir Analytics etkinliği günlüğe kaydet ).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 kurmayla ilgili bazı ipuçlarını burada bulabilirsiniz:
Birden çok derleme varyantının nasıl işleneceği de dahil olmak üzere, bir Firebase projesine uygulama eklemeye yönelik en iyi uygulamalar ve dikkate alınması gereken noktalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.
Yeni bir proje oluşturursanız, projeniz için Google Analytics'i kurmanızı şiddetle tavsiye ederiz; bu, birçok Firebase ürününü kullanarak optimum bir deneyim yaşamanızı sağlar.
Bu iş akışı, Firebase projenizin Android yapılandırma dosyasını (
) uygulamanızın modül (uygulama düzeyi) dizinine de ekler.google-services.json
İstediğiniz bir Firebase ürününü eklemek için düğmeyi tıklayın (örneğin,
uygulamanıza Analytics Ekleme ).
Tüm bağımlılıkların gerekli sürümlere sahip olduğundan emin olmak için uygulamanızı senkronize edin.
Firebase Assistant bölmesinde, seçtiğiniz Firebase ürünü için kalan kurulum talimatlarını uygulayın.
Firebase Assistant aracılığıyla istediğiniz kadar çok Firebase ürünü ekleyin!
Bu kadar! Önerilen sonraki adımları kontrol ettiğinizden emin olun.
Mevcut kitaplıklar
Bu bölümde, Android için desteklenen Firebase ürünleri ve Gradle bağımlılıkları listelenmektedir. Bu Firebase Android kitaplıkları hakkında daha fazla bilgi edinin:
Referans dokümantasyon ( Java | Kotlin + KTX )
Firebase Android SDK GitHub kod deposu
Firebase Android build.gradle
, build.gradle
kitaplık bağımlılıklarını build.gradle
bağımsız kitaplık sürümleri belirtmediğinizi build.gradle
.
Java
Hizmet veya Ürün | Gradle bağımlılığı | En son versiyon | Analytics eklensin mi? |
---|---|---|---|
Firebase Android BoM (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ünün sürüm notlarını inceleyin. | 27.0.0 | |
AdMob | com.google.android.gms: oyun hizmetleri-reklamları | 20.0.0 | |
Analitik | com.google.firebase: firebase-analytics | 18.0.3 | |
Uygulama Dizine Ekleme | com.google.firebase: firebase-appindexing | 19.2.0 | |
Doğrulama | com.google.firebase: firebase-auth | 20.0.4 | |
Cloud Firestore | com.google.firebase: firebase-firestore | 22.1.2 | |
Firebase Client SDK için Cloud Functions | com.google.firebase: firebase-functions | 19.2.0 | |
Bulut Mesajlaşma | com.google.firebase: firebase-mesajlaşma | 21.1.0 | |
Bulut depolama | com.google.firebase: firebase-storage | 19.2.2 | |
Crashlytics | com.google.firebase: firebase-crashlytics | 17.4.1 | |
Dinamik Bağlantılar | com.google.firebase: firebase-dinamik-bağlantılar | 19.1.1 | |
Firebase ML Model Downloader API'si | com.google.firebase: firebase-ml-modeldownloader | 23.0.0 | |
Uygulama İçi Mesajlaşma | com.google.firebase: firebase-inappmessaging | 19.1.5 | (gereklidir) |
Uygulama İçi Mesajlaşma Ekranı | com.google.firebase: firebase-inappmessaging-display | 19.1.5 | (gereklidir) |
Performans İzleme | com.google.firebase: firebase-perf | 19.1.1 | |
Gerçek Zamanlı Veritabanı | com.google.firebase: firebase-veritabanı | 19.7.0 | |
Uzaktan Yapılandırma | com.google.firebase: firebase-config | 20.0.4 | |
Google Play hizmetleri eklentisi | com.google.gms: google-hizmetleri | 4.3.5 | |
Kullanımdan kaldırılan kitaplıklar | |||
Firebase ML Özel Model API'leri | com.google.firebase: firebase-ml-model-yorumlayıcı | 22.0.4 | |
Firebase ML Vision API'leri | 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-nesne-algılama-modeli | 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-barkod-modeli | 16.1.2 | |
Firebase ML: AutoML Vision Edge API | com.google.firebase: firebase-ml-vision-automl | 18.0.6 | |
Firebase ML: Natural Language API'leri | com.google.firebase: firebase-ml-doğal-dil | 22.0.1 | |
Firebase ML: Dil Tanımlama Modeli | com.google. | 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-doğal-dil-akıllı-yanıt-modeli | 20.0.8 |
Kotlin + KTX
Hizmet veya Ürün | Gradle bağımlılığı | En son versiyon | Analytics eklensin mi? |
---|---|---|---|
Firebase Android BoM (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ünün sürüm notlarını inceleyin. | 27.0.0 | |
AdMob | com.google.android.gms: oyun hizmetleri-reklamları | 20.0.0 | |
Analitik | com.google.firebase: firebase-analytics-ktx | 18.0.3 | |
Uygulama Dizine Ekleme | com.google.firebase: firebase-appindexing | 19.2.0 | |
Doğrulama | com.google.firebase: firebase-auth-ktx | 20.0.4 | |
Cloud Firestore | com.google.firebase: firebase-firestore-ktx | 22.1.2 | |
Firebase Client SDK için Cloud Functions | com.google.firebase: firebase-functions-ktx | 19.2.0 | |
Bulut Mesajlaşma | com.google.firebase: firebase-messaging-ktx | 21.0.1 | |
Bulut depolama | com.google.firebase: firebase-storage-ktx | 19.2.2 | |
Crashlytics | com.google.firebase: firebase-crashlytics-ktx | 17.4.1 | |
Dinamik Bağlantılar | com.google.firebase: firebase-dynamic-links-ktx | 19.1.1 | |
Uygulama İçi Mesajlaşma | com.google.firebase: firebase-inappmessaging-ktx | 19.1.5 | (gereklidir) |
Uygulama İçi Mesajlaşma Ekranı | com.google.firebase: firebase-inappmessaging-display-ktx | 19.1.5 | (gereklidir) |
Performans İzleme | com.google.firebase: firebase-perf-ktx | 19.1.1 | |
Gerçek Zamanlı Veritabanı | com.google.firebase: firebase-veritabanı-ktx | 19.7.0 | |
Uzaktan Yapılandırma | com.google.firebase: firebase-config-ktx | 20.0.4 | |
Google Play hizmetleri eklentisi | com.google.gms: google-hizmetleri | 4.3.5 | |
Kullanımdan kaldırılan kitaplıklar | |||
Firebase ML Özel Model API'leri | com.google.firebase: firebase-ml-model-yorumlayıcı | 22.0.4 | |
Firebase ML Vision API'leri | 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-nesne-algılama-modeli | 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-barkod-modeli | 16.1.2 | |
Firebase ML: AutoML Vision Edge API | com.google.firebase: firebase-ml-vision-automl | 18.0.6 | |
Firebase ML: Natural Language API'leri | com.google.firebase: firebase-ml-doğal-dil | 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-doğal-dil-akıllı-yanıt-modeli | 20.0.8 |
Sonraki adımlar
Firebase hizmetlerini uygulamanıza ekleyin:
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.
Fotoğraflar ve videolar gibi dosyaları Cloud Storage ile depolayın.
Cloud Functions ile güvenli bir ortamda çalışan arka uç kodunu tetikleyin.
Bulut Mesajlaşma ile bildirimler gönderin.
Uygulamanızın Crashlytics ile ne zaman ve neden kilitlendiğini öğrenin .
Firebase hakkında bilgi edinin:
Firebase projeleri ve projeler için en iyi uygulamalar hakkında daha fazla bilgi edinmek için Firebase Projelerini Anlama sayfasını ziyaret edin.
Firebase ve Android geliştirmeye aşina olmayan veya ö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 çok Firebase hizmetinde kullanımına ilişkin genel bir fikir edinmek için Firebase konsolundaki Kullanım ve faturalandırma kontrol panelini izleyin.
- Firebase başlatma kontrol listesini inceleyin .