अपने 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 खाते का इस्तेमाल करके 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 Services Gradle प्लगिन (google-services) की ज़रूरत होगी.

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

      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
      }
      
    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.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 लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.

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

    आंकड़े की सुविधा चालू नहीं है

    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 का इस्तेमाल करने पर, आपका ऐप्लिकेशन हमेशा 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 और उनकी Gradle डिपेंडेंसी के लिए काम करने वाले Firebase प्रॉडक्ट की सूची दी गई है. Firebase की Android लाइब्रेरी के बारे में ज़्यादा जानें:

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

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

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

33.0.0
AdMob com.google.android.gms:play-services-ads 23.0.0
Analytics com.google.firebase:firebase-analytics 22.0.0
ऐप्लिकेशन की जांच के लिए, पसंद के मुताबिक सेवा देने वाली कंपनी com.google.firebase:firebase-appcheck 18.0.0
ऐप्लिकेशन की जांच को डीबग करने की सेवा देने वाली कंपनी com.google.firebase:firebase-appcheck-debug 18.0.0
ऐप्लिकेशन की जांच के लिए, Play की पूरी सुरक्षा देने वाली कंपनी com.google.firebase:firebase-appcheck-playintegrity 18.0.0
ऐप्लिकेशन डिस्ट्रिब्यूशन com.google.firebase:firebase-appdistribution 16.0.0-बीटा12
App Distribution API com.google.firebase:firebase-appdistribution-api) 16.0.0-बीटा12
App Distribution प्लगिन com.google.firebase:firebase-appdistribution-gradle 5.0.0
पुष्टि करना com.google.firebase:firebase-auth 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore 25.0.0
'Firebase के लिए Cloud Functions' का क्लाइंट SDK टूल com.google.firebase:firebase-Functions 21.0.0
क्लाउड से मैसेज com.google.firebase:firebase-information 24.0.0
क्लाउड स्टोरेज com.google.firebase:firebase-storage 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics 19.0.0
Crashlytics एनडीके com.google.firebase:firebase-crashlytics-ndk 19.0.0
Crashlytics प्लगिन com.google.firebase:firebase-crashlytics-gradle 3.0.0
डाइनैमिक सुविधा वाले मॉड्यूल के लिए सहायता com.google.firebase:firebase-Dynamic-module-support 16.0.0-बीटा03
डाइनैमिक लिंक com.google.firebase:firebase-डाइनैमिक-लिंक 22.0.0
इन-ऐप्लिकेशन मैसेज com.google.firebase:firebase-inapp Messaging 21.0.0
(ज़रूरी है)
इन-ऐप्लिकेशन मैसेज दिखाने वाला डिसप्ले com.google.firebase:firebase-inapp Messaging-display 21.0.0
(ज़रूरी है)
Firebase इंस्टॉलेशन com.google.firebase:firebase-installations 18.0.0
Firebase ML मॉडल डाउनलोडर एपीआई com.google.firebase:firebase-ml-modeldownloader 25.0.0
परफ़ॉर्मेंस मॉनिटर करना com.google.firebase:firebase-perf 21.0.0
परफ़ॉर्मेंस मॉनिटर करने वाला प्लगिन com.google.firebase:perf-Plugins 1.4.2
रीयलटाइम डेटाबेस com.google.firebase:firebase-database 21.0.0
रिमोट कॉन्फ़िगरेशन com.google.firebase:firebase-config 22.0.0
Google Play services का प्लगिन com.google.gms:google-सेवाएं 4.4.1
बंद की गई लाइब्रेरी
ऐप्लिकेशन की जांच के लिए SafetyNet की सेवा देने वाली कंपनी com.google.firebase:firebase-appcheck-safetynet 16.1.2
ऐप्लिकेशन को इंडेक्स करना com.google.firebase:firebase-appindexing 20.0.0

Firebase KTX मॉड्यूल

Analytics com.google.firebase:firebase-analytics-ktx 22.0.0
ऐप्लिकेशन की जांच के लिए, पसंद के मुताबिक सेवा देने वाली कंपनी com.google.firebase:firebase-appcheck-ktx 18.0.0
App Distribution API com.google.firebase:firebase-appdistribution-api-ktx) 16.0.0-बीटा12
पुष्टि करना com.google.firebase:firebase-auth-ktx 23.0.0
Cloud Firestore com.google.firebase:firebase-firestore-ktx 25.0.0
'Firebase के लिए Cloud Functions' का क्लाइंट SDK टूल com.google.firebase:firebase-Functions-ktx 21.0.0
क्लाउड से मैसेज com.google.firebase:firebase- Messaging-ktx 24.0.0
क्लाउड स्टोरेज com.google.firebase:firebase-storage-ktx 21.0.0
Crashlytics com.google.firebase:firebase-crashlytics-ktx 19.0.0
डाइनैमिक लिंक com.google.firebase:firebase-Dynamic-links-ktx 22.0.0
इन-ऐप्लिकेशन मैसेज com.google.firebase:firebase-inapp Messaging-ktx 21.0.0
(ज़रूरी है)
इन-ऐप्लिकेशन मैसेज दिखाने वाला डिसप्ले com.google.firebase:firebase-inapp Messaging-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.0
रीयलटाइम डेटाबेस com.google.firebase:firebase-database-ktx 21.0.0
रिमोट कॉन्फ़िगरेशन com.google.firebase:firebase-config-ktx 22.0.0

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

Firebase ML कस्टम मॉडल एपीआई com.google.firebase:firebase-ml-model-interpreter 22.0.4
Firebase ML Vision एपीआई 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: मॉडल का अनुवाद करना 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 के बारे में जानें: