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 जोड़ने से पहले, आपको एक Firebase प्रोजेक्ट बनाना होगा, ताकि उसे अपने Android ऐप्लिकेशन से कनेक्ट किया जा सके. Firebase प्रोजेक्ट के बारे में ज़्यादा जानने के लिए, Firebase प्रोजेक्ट के बारे में जानकारी पर जाएं.

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

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

  1. Firebase कंसोल पर जाएं.

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

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

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

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

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

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

    1. अपने ऐप्लिकेशन की Firebase कॉन्फ़िगरेशन फ़ाइल पाने के लिए, 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 services plugin को डिपेंडेंसी के तौर पर जोड़ें:

      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.3" 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.3' apply false
      }
    2. अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) Gradle फ़ाइल में (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle), Google services plugin जोड़ें:

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

    Analytics चालू नहीं है

    dependencies {
      // ...
    
      // Import the Firebase BoM
      implementation(platform("com.google.firebase:firebase-bom:34.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 का इस्तेमाल करने पर, आपका ऐप्लिकेशन हमेशा Firebase Android लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.

  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 > Check for updates
  2. Firebase Assistant खोलें: Tools > Firebase.

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

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

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

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

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

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

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

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



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

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

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

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

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

34.0.0
AdMob com.google.android.gms:play-services-ads 24.4.0
Firebase AI Logic 1 com.google.firebase:firebase-ai 17.0.0
Analytics com.google.firebase:firebase-analytics 23.0.0
App Check कस्टम प्रोवाइडर com.google.firebase:firebase-appcheck 19.0.0
App Check debug provider com.google.firebase:firebase-appcheck-debug 19.0.0
App Check Play Integrity provider com.google.firebase:firebase-appcheck-playintegrity 19.0.0
App Distribution com.google.firebase:firebase-appdistribution 16.0.0-beta16
App Distribution एपीआई com.google.firebase:firebase-appdistribution-api 16.0.0-beta16
App Distribution plugin com.google.firebase:firebase-appdistribution-gradle 5.1.1
Authentication com.google.firebase:firebase-auth 24.0.0
Cloud Firestore com.google.firebase:firebase-firestore 26.0.0
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions 22.0.0
Cloud Messaging com.google.firebase:firebase-messaging 25.0.0
Cloud Storage com.google.firebase:firebase-storage 22.0.0
Crashlytics com.google.firebase:firebase-crashlytics 20.0.0
Crashlytics NDK com.google.firebase:firebase-crashlytics-ndk 20.0.0
Crashlytics plugin com.google.firebase:firebase-crashlytics-gradle 3.0.5
Data Connect com.google.firebase:firebase-dataconnect 17.0.0
डाइनैमिक सुविधा वाले मॉड्यूल के लिए सहायता com.google.firebase:firebase-dynamic-module-support 16.0.0-beta04
Dynamic Links com.google.firebase:firebase-dynamic-links 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging 22.0.0
(ज़रूरी है)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display 22.0.0
(ज़रूरी है)
Firebase इंस्टॉल com.google.firebase:firebase-installations 19.0.0
Firebase ML Model Downloader API com.google.firebase:firebase-ml-modeldownloader 26.0.0
Performance Monitoring com.google.firebase:firebase-perf 22.0.0
Performance Monitoring plugin com.google.firebase:perf-plugin 2.0.0
Realtime Database com.google.firebase:firebase-database 22.0.0
Remote Config com.google.firebase:firebase-config 23.0.0
Google Play services प्लगिन com.google.gms:google-services 4.4.3
बंद की गई लाइब्रेरी
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.5.0
App Check कस्टम प्रोवाइडर com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution एपीआई com.google.firebase:firebase-appdistribution-api-ktx 16.0.0-beta15
Authentication com.google.firebase:firebase-auth-ktx 23.2.1
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.1.4
Cloud Functions for Firebase Client SDK com.google.firebase:firebase-functions-ktx 21.2.1
Cloud Messaging com.google.firebase:firebase-messaging-ktx 24.1.2
Cloud Storage com.google.firebase:firebase-storage-ktx 21.0.2
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.4.4
Dynamic Links com.google.firebase:firebase-dynamic-links-ktx 22.1.0
In-App Messaging com.google.firebase:firebase-inappmessaging-ktx 21.0.2
(ज़रूरी है)
In-App Messaging Display com.google.firebase:firebase-inappmessaging-display-ktx 21.0.2
(ज़रूरी है)
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.5
Realtime Database com.google.firebase:firebase-database-ktx 21.0.0
Remote Config com.google.firebase:firebase-config-ktx 22.1.2

Firebase ML Kit की लाइब्रेरी

Firebase ML Custom Model APIs 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: Natural Language API 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 Model 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

1 Firebase AI Logic को पहले "Vertex AI in Firebase" कहा जाता था. यह com.google.firebase:firebase-vertexai पैकेज के साथ आता था.



अगले चरण

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

  • Firebase AI Logic का इस्तेमाल करके, Gemini और Imagen मॉडल की मदद से जनरेटिव एआई की सुविधाएँ बनाएँ.

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

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

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

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

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

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

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

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