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

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

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

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

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

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

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

यदि आपके पास पहले से कोई 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 का इस्तेमाल कैसे किया जाता है?

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

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

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

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

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

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

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

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

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

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

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

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

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

      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.14'
          }
      }
      
      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 : अपने ऐप्लिकेशन में Firebase SDK टूल जोड़ें

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

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

   Java

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

   Kotlin+KTX

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

   Kotlin+KTX

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

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

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

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

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

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

   • अपने ऐप-लेवल build.gradle फ़ाइल में एरर मैसेज से लिस्टेड compileOptions जोड़ें।
   • अपने Android प्रोजेक्ट के लिए minSdkVersion को बढ़ाकर 26 या उससे ऊपर करें।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

6. Firebase Assistant के ज़रिए जितने चाहें उतने अन्य Firebase उत्पाद जोड़ें!

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

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

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

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

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

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

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

अगले कदम

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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