Firebase को अपने Android प्रोजेक्ट में जोड़ना

ज़रूरी शर्तें

  • Android Studio को इंस्टॉल करें या नए वर्शन में अपडेट करें.

  • पक्का करें कि आपका प्रोजेक्ट इन ज़रूरी शर्तों को पूरा करता हो. ध्यान दें कि कुछ प्रॉडक्ट के लिए ज़्यादा सख्त शर्तें हो सकती हैं:

    • एपीआई लेवल 21 (Lollipop) या उसके बाद के वर्शन को टारगेट करता हो
    • Android 5.0 या इसके बाद का वर्शन इस्तेमाल करता हो
    • Jetpack (AndroidX) का इस्तेमाल करता हो. इसमें, वर्शन से जुड़ी इन ज़रूरी शर्तों को पूरा करना भी शामिल है:
      • com.android.tools.build:gradle v7.3.0 या उसके बाद के वर्शन
      • compileSdkVersion 28 या उसके बाद का वर्शन

  • अपने ऐप्लिकेशन को चलाने के लिए, कोई फ़िज़िकल डिवाइस सेट अप करें या एम्युलेटर का इस्तेमाल करें.
    ध्यान दें कि Google Play services पर निर्भर Firebase SDK टूल के लिए, डिवाइस या एम्युलेटर में Google Play services इंस्टॉल होना ज़रूरी है.

  • अपने Google खाते का इस्तेमाल करके, Firebase में साइन इन करें.

अगर आपके पास पहले से कोई Android प्रोजेक्ट नहीं है और आपको सिर्फ़ Firebase का कोई प्रॉडक्ट आज़माना है, तो हमारे शुरुआती सैंपल में से कोई एक डाउनलोड करें.


अपने Android ऐप्लिकेशन को Firebase से कनेक्ट करने के लिए, इनमें से किसी एक विकल्प का इस्तेमाल किया जा सकता है:

  • पहला विकल्प: (सुझाया गया) Firebase कंसोल सेटअप करने के वर्कफ़्लो का इस्तेमाल करें.
  • दूसरा विकल्प: Android Studio Firebase Assistant का इस्तेमाल करें. इसके लिए, आपको अतिरिक्त कॉन्फ़िगरेशन की ज़रूरत पड़ सकती है.


पहला विकल्प: Firebase कंसोल का इस्तेमाल करके Firebase जोड़ना

अपने ऐप्लिकेशन में Firebase जोड़ने के लिए, Firebase कंसोल और अपने Android प्रोजेक्ट, दोनों में टास्क पूरे करने होते हैं. उदाहरण के लिए, कंसोल से Firebase कॉन्फ़िगरेशन फ़ाइलें डाउनलोड करके, उन्हें अपने Android प्रोजेक्ट में ले जाना.

पहला चरण: Firebase प्रोजेक्ट बनाना

अपने Android ऐप्लिकेशन में Firebase जोड़ने से पहले, आपको अपने Android ऐप्लिकेशन से कनेक्ट करने के लिए Firebase प्रोजेक्ट बनाना होगा. Firebase प्रोजेक्ट के बारे में ज़्यादा जानने के लिए, Firebase प्रोजेक्ट के बारे में जानकारी लेख पढ़ें.

दूसरा चरण: Firebase के साथ अपना ऐप्लिकेशन रजिस्टर करना

अपने Android ऐप्लिकेशन में Firebase का इस्तेमाल करने के लिए, आपको अपने ऐप्लिकेशन को अपने Firebase प्रोजेक्ट के साथ रजिस्टर करना होगा. अपने ऐप्लिकेशन को रजिस्टर करने को, अक्सर अपने प्रोजेक्ट में ऐप्लिकेशन को "जोड़ना" कहा जाता है.

  1. Firebase console पर जाएं.

  2. सेटअप वर्कफ़्लो लॉन्च करने के लिए, प्रोजेक्ट की खास जानकारी वाले पेज के बीच में मौजूद Android आइकॉन () या ऐप्लिकेशन जोड़ें पर क्लिक करें.

  3. Android पैकेज का नाम फ़ील्ड में, अपने ऐप्लिकेशन का पैकेज नाम डालें.

  4. (ज़रूरी नहीं) ऐप्लिकेशन की अन्य जानकारी डालें: ऐप्लिकेशन का कोई दूसरा नाम और डीबग साइनिंग सर्टिफ़िकेट SHA-1.

  5. ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.

तीसरा चरण: Firebase कॉन्फ़िगरेशन फ़ाइल जोड़ना

  1. Firebase की Android कॉन्फ़िगरेशन फ़ाइल (google-services.json) डाउनलोड करें और फिर उसे अपने ऐप्लिकेशन में जोड़ें:

    1. Firebase की Android कॉन्फ़िगरेशन फ़ाइल पाने के लिए, google-services.json डाउनलोड करें पर क्लिक करें.

    2. अपनी कॉन्फ़िगरेशन फ़ाइल को अपने ऐप्लिकेशन के मॉड्यूल (ऐप्लिकेशन-लेवल) की रूट डायरेक्ट्री में ले जाएं.

  2. अपनी google-services.json कॉन्फ़िगरेशन फ़ाइल में मौजूद वैल्यू को Firebase SDK टूल के लिए ऐक्सेस करने के लिए, आपके पास Google services Gradle प्लग इन (google-services) होना चाहिए.

    1. अपनी रूट-लेवल (प्रोजेक्ट-लेवल) Gradle फ़ाइल (<project>/build.gradle.kts या <project>/build.gradle) में, Google की सेवाओं के प्लग इन को डिपेंडेंसी के तौर पर जोड़ें:

      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.2" 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.2' apply false
}

    2. अपने मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) में, Google की सेवाओं का प्लग इन जोड़ें:

      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'
  // ...
}

चौथा चरण: अपने ऐप्लिकेशन में Firebase SDK टूल जोड़ना

  1. अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) Gradle फ़ाइल (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) में, उन Firebase प्रॉडक्ट के लिए डिपेंडेंसी जोड़ें जिनका इस्तेमाल आपको अपने ऐप्लिकेशन में करना है. हमारा सुझाव है कि लाइब्रेरी के वर्शन को कंट्रोल करने के लिए, Firebase Android BoM का इस्तेमाल करें.

    Analytics चालू है 

    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 का इस्तेमाल करने पर, आपका ऐप्लिकेशन हमेशा Firebase Android लाइब्रेरी के काम करने वाले वर्शन का इस्तेमाल करेगा.

    क्या आपको Kotlin के लिए कोई लाइब्रेरी मॉड्यूल चाहिए? अक्टूबर 2023 (Firebase BoM 32.5.0) से, Kotlin और Java, दोनों डेवलपर मुख्य लाइब्रेरी मॉड्यूल का इस्तेमाल कर सकते हैं. ज़्यादा जानकारी के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले सवाल देखें.

    Analytics चालू नहीं है 

    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 का इस्तेमाल करने पर, आपका ऐप्लिकेशन हमेशा Firebase Android लाइब्रेरी के काम करने वाले वर्शन का इस्तेमाल करेगा.

    क्या आपको Kotlin के लिए कोई लाइब्रेरी मॉड्यूल चाहिए? अक्टूबर 2023 (Firebase BoM 32.5.0) से, Kotlin और Java, दोनों डेवलपर मुख्य लाइब्रेरी मॉड्यूल का इस्तेमाल कर सकते हैं. ज़्यादा जानकारी के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले सवाल देखें.

  2. आपको जिन प्रॉडक्ट का इस्तेमाल करना है उनकी डिपेंडेंसी जोड़ने के बाद, अपने Android प्रोजेक्ट को Gradle फ़ाइलों के साथ सिंक करें.

बस हो गया! सुझाए गए अगले चरण देखने के लिए, सीधे आगे बढ़ें.

अगर आपको सेट अप करने में समस्या आ रही है, तो Android से जुड़ी समस्याओं को हल करने और अक्सर पूछे जाने वाले सवाल पर जाएं.


दूसरा विकल्प: Firebase Assistant का इस्तेमाल करके Firebase जोड़ना

Firebase Assistant, आपके ऐप्लिकेशन को Firebase प्रोजेक्ट के साथ रजिस्टर करता है. साथ ही, Android Studio में ही आपके Android प्रोजेक्ट में ज़रूरी Firebase फ़ाइलें, प्लग इन, और डिपेंडेंसी जोड़ता है!

  1. Android Studio में अपना Android प्रोजेक्ट खोलें. इसके बाद, पक्का करें कि आपने Android Studio और Firebase Assistant के नए वर्शन का इस्तेमाल किया हो:

    • Windows / Linux: सहायता > अपडेट देखें
    • macOS: Android Studio > अपडेट देखें

  2. Firebase Assistant खोलें: टूल > Firebase.

  3. Assistant पैनल में, अपने ऐप्लिकेशन में जोड़ने के लिए कोई Firebase प्रॉडक्ट चुनें. इसके बाद, उसके सेक्शन को बड़ा करें और ट्यूटोरियल के लिंक पर क्लिक करें. उदाहरण के लिए, Analytics > Analytics इवेंट लॉग करें.

    1. अपने Android प्रोजेक्ट को Firebase से कनेक्ट करने के लिए, Firebase से कनेक्ट करें पर क्लिक करें.

    2. अपनी पसंद का Firebase प्रॉडक्ट जोड़ने के लिए बटन पर क्लिक करें. उदाहरण के लिए, अपने ऐप्लिकेशन में Analytics जोड़ें.

  4. अपने ऐप्लिकेशन को सिंक करें, ताकि यह पक्का किया जा सके कि सभी डिपेंडेंसी के ज़रूरी वर्शन मौजूद हों.

  5. असिस्टेंट पैनल में, चुने गए Firebase प्रॉडक्ट के लिए, सेटअप से जुड़े बाकी निर्देशों का पालन करें.

  6. Firebase Assistant की मदद से, जितने चाहें उतने Firebase प्रॉडक्ट जोड़ें!

बस हो गया! अगले चरण के लिए सुझाए गए तरीके ज़रूर देखें.

अगर आपको सेट अप करने में समस्या आ रही है, तो Android से जुड़ी समस्याओं को हल करने और अक्सर पूछे जाने वाले सवाल पर जाएं.


उपलब्ध लाइब्रेरी

इस सेक्शन में, Android के साथ काम करने वाले Firebase प्रॉडक्ट और उनकी Gradle डिपेंडेंसी की सूची दी गई है. Firebase की इन Android लाइब्रेरी के बारे में ज़्यादा जानें:

  • रेफ़रंस दस्तावेज़ (Kotlin | Java)

  • Firebase Android SDK के लिए GitHub repo

ध्यान दें कि Firebase Android BoM का इस्तेमाल करते समय, अपनी Gradle बिल्ड कॉन्फ़िगरेशन फ़ाइल में Firebase लाइब्रेरी की डिपेंडेंसी का एलान करते समय, आपको अलग-अलग लाइब्रेरी वर्शन की जानकारी नहीं देनी होती.

सेवा या प्रॉडक्ट Gradle डिपेंडेंसी
का नया वर्शन		 Analytics जोड़ना है?
Firebase Android BoM
(Bill of Materials)		 com.google.firebase:firebase-bom

Firebase BoM के नए वर्शन में, Firebase की हर Android लाइब्रेरी के नए वर्शन शामिल होते हैं. यह जानने के लिए कि लाइब्रेरी के कौनसे वर्शन, किसी खास BoM वर्शन से मैप किए गए हैं, उस BoM वर्शन के लिए रिलीज़ नोट देखें.

 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 कस्टम प्रोवाइडर com.google.firebase:firebase-appcheck 18.0.0
App Check डीबग करने की सुविधा देने वाली कंपनी com.google.firebase:firebase-appcheck-debug 18.0.0
App Check Play Integrity की सेवा देने वाली कंपनी com.google.firebase:firebase-appcheck-playintegrity 18.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta14
App Distribution एपीआई com.google.firebase:firebase-appdistribution-api 16.0.0-beta14
App Distribution प्लग इन 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 प्लग इन com.google.firebase:firebase-crashlytics-gradle 3.0.2
डाइनैमिक सुविधा वाले मॉड्यूल के लिए सहायता 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
(ज़रूरी है)
In-App Messaging डिसप्ले com.google.firebase:firebase-inappmessaging-display 21.0.1
(ज़रूरी है)
Firebase इंस्टॉलेशन 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 प्लग इन 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 services प्लग इन com.google.gms:google-services 4.4.2
ऐसी लाइब्रेरी जिनका इस्तेमाल बंद कर दिया गया है
App Check SafetyNet की सेवा देने वाली कंपनी com.google.firebase:firebase-appcheck-safetynet 16.1.2
App Indexing com.google.firebase:firebase-appindexing 20.0.0

Firebase KTX मॉड्यूल

Analytics com.google.firebase:firebase-analytics-ktx 22.1.2
App Check कस्टम प्रोवाइडर com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution एपीआई 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
(ज़रूरी है)
In-App Messaging डिसप्ले com.google.firebase:firebase-inappmessaging-display-ktx 21.0.1
(ज़रूरी है)
Firebase इंस्टॉलेशन 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 Kit की लाइब्रेरी

Firebase ML कस्टम मॉडल एपीआई com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase ML: इमेज लेबल करने वाला मॉडल com.google.firebase:firebase-ml-vision-image-label-model 20.0.2
Firebase ML: ऑब्जेक्ट का पता लगाने और उसे ट्रैक करने वाला मॉडल com.google.firebase:firebase-ml-vision-object-detection-model 19.0.6
Firebase ML: चेहरे की पहचान करने वाला मॉडल com.google.firebase:firebase-ml-vision-face-model 20.0.2
Firebase ML: बारकोड स्कैन करने वाला मॉडल 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: नेचुरल लैंग्वेज एपीआई com.google.firebase:firebase-ml-natural-language 22.0.1
Firebase ML: भाषा की पहचान करने वाला मॉडल com.google.firebase:firebase-ml-natural-language-language-id-model 20.0.8
Firebase ML: Translate मॉडल com.google.firebase:firebase-ml-natural-language-translate-model 20.0.9
Firebase ML: स्मार्ट जवाब का मॉडल com.google.firebase:firebase-ml-natural-language-smart-reply-model 20.0.8


अगले चरण

अपने ऐप्लिकेशन में Firebase की सेवाएं जोड़ें:

  • Analytics की मदद से, उपयोगकर्ता के व्यवहार के बारे में अहम जानकारी पाएं.

  • Authentication की मदद से, उपयोगकर्ता की पुष्टि करने का फ़्लो सेट अप करें.

  • उपयोगकर्ता की जानकारी जैसे डेटा को Cloud Firestore या Realtime Database के साथ सेव करें.

  • Cloud Storage की मदद से, फ़ोटो और वीडियो जैसी फ़ाइलें सेव करें.

  • Cloud Functions की मदद से, सुरक्षित प्लैटफ़ॉर्म पर चलने वाला बैकएंड कोड ट्रिगर करें.

  • Cloud Messaging की मदद से सूचनाएं भेजें.

  • Crashlytics की मदद से, यह पता लगाएं कि आपका ऐप्लिकेशन कब और क्यों क्रैश हो रहा है.

Firebase के बारे में जानें: