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

आवश्यक शर्तें

• एंड्रॉइड स्टूडियो को उसके नवीनतम संस्करण में इंस्टॉल या अपडेट करें।

• सुनिश्चित करें कि आपका प्रोजेक्ट इन आवश्यकताओं को पूरा करता है:

  • लक्ष्य एपीआई स्तर 19 (किटकैट) या उच्चतर
  • एंड्रॉइड 4.4 या उच्चतर का उपयोग करता है
  • Jetpack (AndroidX) का उपयोग करता है, जिसमें इन संस्करण आवश्यकताओं को पूरा करना शामिल है:
    • com.android.tools.build:gradle v7.3.0 या बाद का संस्करण
    • compileSdkVersion 28 या बाद का संस्करण

• अपना ऐप चलाने के लिए एक भौतिक उपकरण सेट करें या एक एमुलेटर का उपयोग करें।
  ध्यान दें कि Google Play सेवाओं पर निर्भरता वाले Firebase SDK के लिए डिवाइस या एमुलेटर में Google Play सेवाएं स्थापित होना आवश्यक है।

• अपने Google खाते का उपयोग करके फायरबेस में साइन इन करें ।

यदि आपके पास पहले से कोई एंड्रॉइड प्रोजेक्ट नहीं है और आप केवल फायरबेस उत्पाद आज़माना चाहते हैं, तो आप हमारे क्विकस्टार्ट नमूनों में से एक डाउनलोड कर सकते हैं।

आप निम्न विकल्पों में से किसी एक का उपयोग करके अपने एंड्रॉइड ऐप को फायरबेस से कनेक्ट कर सकते हैं:

• विकल्प 1 : (अनुशंसित) फायरबेस कंसोल सेटअप वर्कफ़्लो का उपयोग करें।
• विकल्प 2 : एंड्रॉइड स्टूडियो फायरबेस असिस्टेंट का उपयोग करें (अतिरिक्त कॉन्फ़िगरेशन की आवश्यकता हो सकती है)।

विकल्प 1 : फायरबेस कंसोल का उपयोग करके फायरबेस जोड़ें

आपके ऐप में फ़ायरबेस जोड़ने से फ़ायरबेस कंसोल और आपके खुले एंड्रॉइड प्रोजेक्ट दोनों में कार्य शामिल होते हैं (उदाहरण के लिए, आप कंसोल से फ़ायरबेस कॉन्फ़िगरेशन फ़ाइलें डाउनलोड करते हैं, फिर उन्हें अपने एंड्रॉइड प्रोजेक्ट में ले जाते हैं)।

चरण 1 : एक फायरबेस प्रोजेक्ट बनाएं

इससे पहले कि आप अपने एंड्रॉइड ऐप में फायरबेस जोड़ सकें, आपको अपने एंड्रॉइड ऐप से कनेक्ट करने के लिए एक फायरबेस प्रोजेक्ट बनाना होगा। फायरबेस प्रोजेक्ट्स के बारे में अधिक जानने के लिए फायरबेस प्रोजेक्ट्स को समझें पर जाएँ।

चरण 2 : अपने ऐप को फायरबेस के साथ पंजीकृत करें

अपने एंड्रॉइड ऐप में फायरबेस का उपयोग करने के लिए, आपको अपने ऐप को अपने फायरबेस प्रोजेक्ट के साथ पंजीकृत करना होगा। अपने ऐप को पंजीकृत करने को अक्सर अपने ऐप को अपने प्रोजेक्ट में "जोड़ना" कहा जाता है।

1. फायरबेस कंसोल पर जाएं।

2. प्रोजेक्ट अवलोकन पृष्ठ के केंद्र में, सेटअप वर्कफ़्लो लॉन्च करने के लिए एंड्रॉइड आइकन ( plat_android ) या ऐप जोड़ें पर क्लिक करें।

3. एंड्रॉइड पैकेज नाम फ़ील्ड में अपने ऐप का पैकेज नाम दर्ज करें।

   पैकेज का नाम क्या है और आप इसे कहां पाते हैं?

   • पैकेज का नाम डिवाइस और Google Play Store पर आपके ऐप की विशिष्ट पहचान करता है।

   • पैकेज नाम को अक्सर एप्लिकेशन आईडी के रूप में जाना जाता है।

   • अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल में अपने ऐप के पैकेज का नाम ढूंढें, आमतौर पर app/build.gradle (उदाहरण पैकेज का नाम: com.yourcompany.yourproject )।

   • ध्यान रखें कि पैकेज नाम मान केस-संवेदी है, और इसे आपके फायरबेस प्रोजेक्ट के साथ पंजीकृत होने के बाद इस फायरबेस एंड्रॉइड ऐप के लिए नहीं बदला जा सकता है।

4. (वैकल्पिक) अन्य ऐप जानकारी दर्ज करें: ऐप उपनाम और डीबग हस्ताक्षर प्रमाणपत्र SHA-1 ।

   फ़ायरबेस के भीतर ऐप उपनाम और डीबग हस्ताक्षर प्रमाणपत्र SHA-1 का उपयोग कैसे किया जाता है?

   • ऐप उपनाम : एक आंतरिक, सुविधाजनक पहचानकर्ता जो केवल आपको फायरबेस कंसोल में दिखाई देता है

   • डिबग हस्ताक्षर प्रमाणपत्र SHA-1 : फायरबेस प्रमाणीकरण ( Google साइन इन या फ़ोन नंबर साइन इन का उपयोग करते समय) और फायरबेस डायनेमिक लिंक के लिए SHA-1 हैश की आवश्यकता होती है।

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

चरण 3 : एक फायरबेस कॉन्फ़िगरेशन फ़ाइल जोड़ें

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

   1. अपनी फायरबेस एंड्रॉइड कॉन्फ़िगरेशन फ़ाइल प्राप्त करने के लिए google-services.json डाउनलोड करें पर क्लिक करें।

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

   आपको इस कॉन्फ़िगरेशन फ़ाइल के बारे में क्या जानने की आवश्यकता है?

   • फायरबेस कॉन्फ़िगरेशन फ़ाइल में आपके प्रोजेक्ट के लिए अद्वितीय, लेकिन गैर-गुप्त पहचानकर्ता शामिल हैं। इस कॉन्फ़िगरेशन फ़ाइल के बारे में अधिक जानने के लिए, फ़ायरबेस प्रोजेक्ट्स को समझें पर जाएँ।

   • आप किसी भी समय अपनी फायरबेस कॉन्फ़िगरेशन फ़ाइल को दोबारा डाउनलोड कर सकते हैं।

   • सुनिश्चित करें कि कॉन्फ़िगरेशन फ़ाइल नाम अतिरिक्त वर्णों, जैसे (2) के साथ नहीं जोड़ा गया है।

2. अपनी google-services.json कॉन्फ़िग फ़ाइल के मानों को Firebase SDKs तक पहुंच योग्य बनाने के लिए, आपको Google Services Gradle प्लगइन ( google-services ) की आवश्यकता होगी।

   1. अपने रूट-लेवल (प्रोजेक्ट-लेवल) ग्रैडल फ़ाइल ( <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.0" 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.0' apply false
      }
      

   2. अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल में (आमतौर पर <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'
        // ...
      }
      

चरण 4 : अपने ऐप में फायरबेस एसडीके जोड़ें

1. अपने मॉड्यूल (ऐप-स्तर) ग्रैडल फ़ाइल में (आमतौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle ), फायरबेस उत्पादों के लिए निर्भरताएँ जोड़ें जिसे आप अपने ऐप में उपयोग करना चाहते हैं। हम लाइब्रेरी वर्जनिंग को नियंत्रित करने के लिए फायरबेस एंड्रॉइड BoM का उपयोग करने की सलाह देते हैं।

   एनालिटिक्स सक्षम

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.6.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")
   }
   

   फायरबेस एंड्रॉइड बीओएम का उपयोग करके, आपका ऐप हमेशा फायरबेस एंड्रॉइड लाइब्रेरी के संगत संस्करणों का उपयोग करेगा।

   कोटलिन-विशिष्ट लाइब्रेरी मॉड्यूल खोज रहे हैं? अक्टूबर 2023 (फायरबेस बीओएम 32.5.0) से शुरू होकर, कोटलिन और जावा डेवलपर्स दोनों मुख्य लाइब्रेरी मॉड्यूल पर निर्भर हो सकते हैं (विवरण के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले प्रश्न देखें)।

   एनालिटिक्स सक्षम नहीं है

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:32.6.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")
   }
   

   फायरबेस एंड्रॉइड बीओएम का उपयोग करके, आपका ऐप हमेशा फायरबेस एंड्रॉइड लाइब्रेरी के संगत संस्करणों का उपयोग करेगा।

   कोटलिन-विशिष्ट लाइब्रेरी मॉड्यूल खोज रहे हैं? अक्टूबर 2023 (फायरबेस बीओएम 32.5.0) से शुरू होकर, कोटलिन और जावा डेवलपर्स दोनों मुख्य लाइब्रेरी मॉड्यूल पर निर्भर हो सकते हैं (विवरण के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले प्रश्न देखें)।

2. जिन उत्पादों का आप उपयोग करना चाहते हैं उनके लिए निर्भरताएँ जोड़ने के बाद, अपने एंड्रॉइड प्रोजेक्ट को ग्रैडल फ़ाइलों के साथ सिंक करें।

   क्या आपको इनवोक-कस्टम समर्थन और डीशुगरिंग सक्षम करने के बारे में बिल्ड विफलता मिल रही है? यहां बताया गया है कि इसे कैसे ठीक किया जाए।

   ग्रैडल बिल्ड जो एंड्रॉइड ग्रैडल प्लगइन (एजीपी) v4.2 या इससे पहले के संस्करण का उपयोग करता है उसे जावा 8 समर्थन सक्षम करने की आवश्यकता होती है। अन्यथा, फायरबेस एसडीके जोड़ते समय इन एंड्रॉइड प्रोजेक्ट्स को बिल्ड विफलता मिलती है।

   इस बिल्ड विफलता को ठीक करने के लिए, आप दो विकल्पों में से एक का पालन कर सकते हैं:

   • त्रुटि संदेश से सूचीबद्ध compileOptions अपने ऐप-स्तरीय build.gradle.kts या build.gradle फ़ाइल में जोड़ें।
   • अपने Android प्रोजेक्ट के लिए minSdk 26 या उससे अधिक तक बढ़ाएँ।

   इस FAQ में इस निर्माण विफलता के बारे में और जानें।

इतना ही! आप अनुशंसित अगले चरणों को देखने के लिए आगे बढ़ सकते हैं।

हालाँकि, यदि आपको सेट अप करने में समस्या हो रही है, तो Android समस्या निवारण और FAQ पर जाएँ।

विकल्प 2 : फायरबेस असिस्टेंट का उपयोग करके फायरबेस जोड़ें

फायरबेस असिस्टेंट आपके ऐप को फायरबेस प्रोजेक्ट के साथ पंजीकृत करता है और आपके एंड्रॉइड प्रोजेक्ट में आवश्यक फायरबेस फाइलें, प्लगइन्स और निर्भरताएं जोड़ता है - सभी एंड्रॉइड स्टूडियो के भीतर से!

1. एंड्रॉइड स्टूडियो में अपना एंड्रॉइड प्रोजेक्ट खोलें, फिर सुनिश्चित करें कि आप एंड्रॉइड स्टूडियो और फायरबेस असिस्टेंट के नवीनतम संस्करण का उपयोग कर रहे हैं:

   • विंडोज़/लिनक्स: सहायता > अद्यतनों की जाँच करें
   • macOS: एंड्रॉइड स्टूडियो > अपडेट की जांच करें

2. फायरबेस असिस्टेंट खोलें: टूल्स > फायरबेस ।

3. सहायक फलक में, अपने ऐप में जोड़ने के लिए एक फायरबेस उत्पाद चुनें। इसके अनुभाग का विस्तार करें, फिर ट्यूटोरियल लिंक पर क्लिक करें (उदाहरण के लिए, एनालिटिक्स > एनालिटिक्स इवेंट लॉग करें )।

   1. अपने एंड्रॉइड प्रोजेक्ट को फायरबेस से कनेक्ट करने के लिए कनेक्ट टू फायरबेस पर क्लिक करें।

      यह वर्कफ़्लो क्या करता है?

      • यह वर्कफ़्लो स्वचालित रूप से आपके ऐप के पैकेज नाम का उपयोग करके एक नया फायरबेस एंड्रॉइड ऐप बनाता है। आप इस नए फायरबेस एंड्रॉइड ऐप को मौजूदा फायरबेस प्रोजेक्ट या नए प्रोजेक्ट में बना सकते हैं।

        आपके फायरबेस प्रोजेक्ट को स्थापित करने के बारे में यहां कुछ सुझाव दिए गए हैं:

        • फ़ायरबेस प्रोजेक्ट में ऐप्स जोड़ने के लिए हमारी सर्वोत्तम प्रथाओं की जाँच करें, जिसमें एकाधिक वेरिएंट को संभालने का तरीका भी शामिल है।

        • यदि आप एक नया प्रोजेक्ट बनाते हैं, तो हम दृढ़ता से अनुशंसा करते हैं कि आप अपने प्रोजेक्ट के लिए Google Analytics सेट अप करें, जो आपको कई फायरबेस उत्पादों का उपयोग करके एक इष्टतम अनुभव प्राप्त करने में सक्षम बनाता है।

      • यह वर्कफ़्लो आपके फ़ायरबेस प्रोजेक्ट की एंड्रॉइड कॉन्फ़िगरेशन फ़ाइल ( google-services.json ) को आपके ऐप के मॉड्यूल (ऐप-स्तर) निर्देशिका में भी जोड़ता है।

   2. वांछित फायरबेस उत्पाद जोड़ने के लिए बटन पर क्लिक करें (उदाहरण के लिए, अपने ऐप में एनालिटिक्स जोड़ें )।

4. यह सुनिश्चित करने के लिए अपने ऐप को सिंक करें कि सभी निर्भरताओं के पास आवश्यक संस्करण हैं।

5. सहायक फलक में, अपने चयनित फायरबेस उत्पाद के लिए शेष सेटअप निर्देशों का पालन करें।

6. फायरबेस असिस्टेंट के माध्यम से आप जितने चाहें उतने अन्य फायरबेस उत्पाद जोड़ें!

इतना ही! अनुशंसित अगले चरणों की जाँच करना सुनिश्चित करें।

हालाँकि, यदि आपको सेट अप करने में समस्या हो रही है, तो Android समस्या निवारण और FAQ पर जाएँ।

उपलब्ध पुस्तकालय

यह अनुभाग एंड्रॉइड और उनकी ग्रैडल निर्भरता के लिए समर्थित फायरबेस उत्पादों को सूचीबद्ध करता है। इन फायरबेस एंड्रॉइड लाइब्रेरीज़ के बारे में और जानें:

• संदर्भ दस्तावेज़ ( कोटलिन+केटीएक्स | जावा )

• फायरबेस एंड्रॉइड एसडीके गिटहब रेपो

ध्यान दें कि फ़ायरबेस एंड्रॉइड BoM का उपयोग करते समय, जब आप अपनी ग्रैडल बिल्ड कॉन्फ़िगरेशन फ़ाइल में फ़ायरबेस लाइब्रेरी निर्भरता की घोषणा करते हैं तो आप अलग-अलग लाइब्रेरी संस्करण निर्दिष्ट नहीं करते हैं।

अगले कदम

अपने ऐप में फ़ायरबेस सेवाएँ जोड़ें:

• Analytics के साथ उपयोगकर्ता के व्यवहार के बारे में जानकारी प्राप्त करें।

• प्रमाणीकरण के साथ उपयोगकर्ता प्रमाणीकरण प्रवाह सेट करें।

• उपयोगकर्ता जानकारी जैसे डेटा को क्लाउड फायरस्टोर या रीयलटाइम डेटाबेस के साथ संग्रहीत करें।

• क्लाउड स्टोरेज के साथ फ़ोटो और वीडियो जैसी फ़ाइलें संग्रहीत करें।

• ट्रिगर बैकएंड कोड जो क्लाउड फ़ंक्शंस के साथ सुरक्षित वातावरण में चलता है।

• क्लाउड मैसेजिंग के साथ सूचनाएं भेजें।

• Crashlytics से पता लगाएं कि आपका ऐप कब और क्यों क्रैश हो रहा है।

फायरबेस के बारे में जानें:

• फायरबेस परियोजनाओं और परियोजनाओं के लिए सर्वोत्तम प्रथाओं के बारे में अधिक जानने के लिए फायरबेस परियोजनाओं को समझें पर जाएँ।

• यदि आपके पास उन अवधारणाओं के बारे में प्रश्न हैं जो फायरबेस और एंड्रॉइड विकास के लिए अपरिचित या विशिष्ट हैं, तो एंड्रॉइड और फायरबेस के बारे में और जानें पर जाएं।

• नमूना फायरबेस ऐप्स का अन्वेषण करें।

• फायरबेस एंड्रॉइड कोडेलैब के साथ व्यावहारिक अनुभव प्राप्त करें।

• सप्ताहांत पाठ्यक्रम में फायरबेस के साथ और जानें।

• अपना ऐप लॉन्च करने की तैयारी करें:

  • Google क्लाउड कंसोल में अपने प्रोजेक्ट के लिए बजट अलर्ट सेट करें।
  • कई फायरबेस सेवाओं में अपने प्रोजेक्ट के उपयोग की समग्र तस्वीर प्राप्त करने के लिए फायरबेस कंसोल में उपयोग और बिलिंग डैशबोर्ड की निगरानी करें।
  • फायरबेस लॉन्च चेकलिस्ट की समीक्षा करें।

• क्या फायरबेस और आपके एंड्रॉइड प्रोजेक्ट में परेशानी हो रही है? Android समस्या निवारण और FAQ पर जाएँ।