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

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

• Android Studio को उसके नवीनतम संस्करण में स्थापित या अपडेट करें।

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

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

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

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

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

आप निम्न विकल्पों में से किसी एक का उपयोग करके अपने Android ऐप को Firebase से कनेक्ट कर सकते हैं:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   Firebase में ऐप्लिकेशन का प्रचलित नाम और डीबग साइनिंग प्रमाणपत्र SHA-1 का इस्तेमाल कैसे किया जाता है?

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

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

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

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

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

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

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

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

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

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

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

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

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

      buildscript {
      
          repositories {
            // Make sure that you have the following two repositories
            google()  // Google's Maven repository
            mavenCentral()  // Maven Central repository
          }
      
          dependencies {
            ...
      
            // Add the dependency for the Google services Gradle plugin
            classpath 'com.google.gms:google-services:4.3.15'
          }
      }
      
      allprojects {
        ...
      
        repositories {
          // Make sure that you have the following two repositories
          google()  // Google's Maven repository
          mavenCentral()  // Maven Central repository
        }
      }
      

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

      plugins {
          id 'com.android.application'
      
          // Add the Google services Gradle plugin
          id 'com.google.gms.google-services'
          ...
      }
      

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

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

   विश्लेषिकी सक्षम

   Kotlin+KTX

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

   Java

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:31.2.3')
   
     // 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+KTX

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

   Java

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation platform('com.google.firebase:firebase-bom:31.2.3')
   
     // 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 प्रोजेक्ट को ग्रेडल फ़ाइलों के साथ सिंक करें।

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

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

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

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

   इस बिल्ड विफलता के बारे में इस अक्सर पूछे जाने वाले प्रश्न में अधिक जानें।

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

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

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

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

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

   • विंडोज / लिनक्स: सहायता> अपडेट के लिए जांचें
   • macOS: Android Studio > अपडेट की जांच करें

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

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

   1. अपने Android प्रोजेक्ट को Firebase से जोड़ने के लिए Connect to Firebase पर क्लिक करें।

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

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

        अपना Firebase प्रोजेक्ट सेट अप करने के बारे में यहां कुछ युक्तियां दी गई हैं:

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

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

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

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

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

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

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

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

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

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

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

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

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

ध्यान दें कि Firebase Android BoM का उपयोग करते समय, जब आप build.gradle में Firebase लाइब्रेरी निर्भरताओं की घोषणा करते हैं, तो आप अलग-अलग लाइब्रेरी संस्करण निर्दिष्ट नहीं करते हैं।

अगले कदम

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

• एनालिटिक्स के साथ उपयोगकर्ता व्यवहार पर अंतर्दृष्टि प्राप्त करें।

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

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

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

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

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

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

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

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

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

• नमूना Firebase ऐप्स एक्सप्लोर करें।

• Firebase Android Codelab के साथ व्यवहारिक अनुभव प्राप्त करें।

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

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

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

• Firebase और अपने Android प्रोजेक्ट के साथ समस्या हो रही है? Android समस्या निवारण और अक्सर पूछे जाने वाले प्रश्न पर जाएं।