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

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

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

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

    • टारगेट एपीआई लेवल 19 (KitKat) या उससे ज़्यादा लेवल को टारगेट करता है
    • जो Android 4.4 या इसके बाद वाले वर्शन का इस्तेमाल करते हों
    • 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 कंसोल पर जाएं.

  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 की सेवाओं के 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.1.2"))
    
      // 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.1.2"))
    
      // 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 प्रोजेक्ट में ज़रूरी Firebase फ़ाइलें, प्लगिन, और डिपेंडेंसी जोड़ती है — ये सब कुछ Android Studio से किया जा सकता है!

  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. Assistant पैनल में, अपने चुने हुए Firebase प्रॉडक्ट के लिए, बचे हुए सेटअप निर्देशों का पालन करें.

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

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

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



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

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

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

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

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

33.1.2
AdMob com.google.android.gms:play-services-ads 23.2.0
Analytics com.google.firebase:firebase-analytics 22.0.2
ऐप्लिकेशन की जांच करने की सुविधा देने वाली कंपनी com.google.firebase:firebase-appcheck 18.0.0
ऐप्लिकेशन की जांच को डीबग करने की सेवा देने वाली कंपनी com.google.firebase:firebase-appcheck-debug 18.0.0
Play Integrity से जुड़ी ऐप्लिकेशन की जांच करने की सुविधा देने वाली कंपनी com.google.firebase:firebase-appcheck-playintegrity 18.0.0
ऐप्लिकेशन डिस्ट्रिब्यूशन com.google.firebase:firebase-appडिस्ट्रिब्यूशन 16.0.0-बीटा13
App Distribution API com.google.firebase:firebase-app वितरण-api 16.0.0-बीटा13
App Distribution प्लगिन com.google.firebase:firebase-app Distribution-gradle 5.0.0
पुष्टि करना com.google.firebase:firebase-auth 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore 25.0.0
Cloud Functions for Firebase क्लाइंट SDK टूल com.google.firebase:firebase-Functions 21.0.0
क्लाउड से मैसेज com.google.firebase:firebase- मैसेजिंग 24.0.0
क्लाउड स्टोरेज com.google.firebase:firebase-storage 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics 19.0.3
Crashlytics एनडीके com.google.firebase:firebase-crashlytics-ndk 19.0.3
Crashlytics प्लगिन com.google.firebase:firebase-crashlytics-gradle 3.0.2
डाइनैमिक सुविधा के मॉड्यूल के लिए सहायता com.google.firebase:firebase-डाइनैमिक-मॉड्यूल-support 16.0.0-बीटा03
डाइनैमिक लिंक com.google.firebase:firebase-डाइनैमिक-लिंक 22.1.0
इन-ऐप्लिकेशन मैसेज com.google.firebase:firebase-inappमैसेजिंग 21.0.0
(ज़रूरी है)
इन-ऐप्लिकेशन मैसेज वाला डिसप्ले com.google.firebase:firebase-inapp Messaging-display 21.0.0
(ज़रूरी है)
Firebase इंस्टॉल करना com.google.firebase:firebase-इंस्टॉलेशन 18.0.0
Firebase ML मॉडल डाउनलोडर एपीआई com.google.firebase:firebase-ml-modeldownloader 25.0.0
परफ़ॉर्मेंस मॉनिटर करना com.google.firebase:firebase-perf 21.0.1
परफ़ॉर्मेंस मॉनिटर करने वाला प्लगिन com.google.firebase:perf-प्लगइन 1.4.2
रीयलटाइम डेटाबेस com.google.firebase:firebase-database 21.0.0
रिमोट कॉन्फ़िगरेशन com.google.firebase:firebase-config 22.0.0
Firebase के लिए Vertex AI com.google.firebase:firebase- कंसोल 16.0.0-बीटा03
Google Play services का प्लगिन com.google.gms:google-services 4.4.2
बंद की गई लाइब्रेरी
App Check SafetyNet की सेवा देने वाली कंपनी com.google.firebase:firebase-appcheck-safetynet 16.1.2
ऐप्लिकेशन सूची com.google.firebase:firebase-appindexing 20.0.0

Firebase केटीएक्स मॉड्यूल

Analytics com.google.firebase:firebase-analytics-ktx 22.0.2
ऐप्लिकेशन की जांच करने की सुविधा देने वाली कंपनी com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-app वितरण-api-ktx 16.0.0-बीटा13
पुष्टि करना com.google.firebase:firebase-auth-ktx 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.0.0
Cloud Functions for Firebase क्लाइंट SDK टूल com.google.firebase:firebase-Functions-ktx 21.0.0
क्लाउड से मैसेज com.google.firebase:firebase- ऑप्टिमाइज़िंग-ktx 24.0.0
क्लाउड स्टोरेज com.google.firebase:firebase-storage-ktx 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.0.3
डाइनैमिक लिंक com.google.firebase:firebase- Dynamic-links-ktx 22.1.0
इन-ऐप्लिकेशन मैसेज com.google.firebase:firebase-inapp कारकों-ktx 21.0.0
(ज़रूरी है)
इन-ऐप्लिकेशन मैसेज वाला डिसप्ले com.google.firebase:firebase-inapp इलाज-display-ktx 21.0.0
(ज़रूरी है)
Firebase इंस्टॉल करना com.google.firebase:firebase-installations-ktx 18.0.0
Firebase ML मॉडल डाउनलोडर एपीआई com.google.firebase:firebase-ml-modeldownloader-ktx 25.0.0
परफ़ॉर्मेंस मॉनिटर करना com.google.firebase:firebase-perf-ktx 21.0.1
रीयलटाइम डेटाबेस com.google.firebase:firebase-database-ktx 21.0.0
रिमोट कॉन्फ़िगरेशन com.google.firebase:firebase-config-ktx 22.0.0

Firebase ML किट लाइब्रेरी

Firebase एमएल कस्टम मॉडल एपीआई com.google.firebase:firebase-ml-model-इंटरप्रेटर 22.0.4
Firebase ML Vision API com.google.firebase:firebase-ml-vision 24.1.0
Firebase एमएल: इमेज लेबलिंग मॉडल 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 की मदद से, उपयोगकर्ताओं के व्यवहार के बारे में इनसाइट पाएं.

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

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

  • Cloud Storage के साथ फ़ोटो और वीडियो जैसी फ़ाइलें सेव करने की सुविधा.

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

  • क्लाउड से मैसेज के ज़रिए सूचनाएं भेजें.

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

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