उपयोगकर्ताओं को संदेश भेजने के लिए FCM और FIAM का उपयोग करें

1. शुरू करने से पहले

इस कोडलैब में, आप सीखते हैं कि उपयोगकर्ताओं के साथ जुड़ने की क्षमता को कैसे जोड़ा जाए, चाहे वे आपके ऐप का उपयोग अग्रभूमि में कर रहे हों या आपका ऐप पृष्ठभूमि में हो।

206c7ecece550bde.png

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

कोई नहीं

आप क्या सीखेंगे

  • अपने Android ऐप में Firebase जोड़ें
  • FCM और FIAM निर्भरता जोड़ें
  • अपने ऐप पर परीक्षण FCM संदेश भेजें
  • अपने ऐप पर परीक्षण FIAM संदेश भेजें

आपको किस चीज़ की ज़रूरत पड़ेगी

  • एंड्रॉइड स्टूडियो 4.1
  • एंड्रॉइड डिवाइस या एमुलेटर

2. आरंभ करें

नमूना कोड प्राप्त करें

कमांड लाइन से GitHub रिपॉजिटरी को क्लोन करें:

स्टार्टर ऐप आयात करें

Android Studio से, codelab-fcm-and-fiam निर्देशिका चुनें ( android_studio_folder.png ) यह पिछले चरण में क्लोन किया गया होगा ( फ़ाइल > ओपन > .../कोडलैब-एफसीएम-एंड-फ़ियम)।

अब आपके पास Android Studio में FcmAndFiam प्रोजेक्ट खुला होना चाहिए। अगर आपको किसी google-services.json फ़ाइल के गुम होने की चेतावनी दिखाई देती है, तो चिंता न करें। इसे अगले चरण में जोड़ा जाएगा।

3. फायरबेस कंसोल प्रोजेक्ट बनाएं

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

  1. फायरबेस कंसोल पर जाएं।
  2. प्रोजेक्ट जोड़ें चुनें.
  3. प्रोजेक्ट का नाम चुनें या दर्ज करें।
  4. फायरबेस कंसोल में शेष सेटअप चरणों का पालन करें, फिर प्रोजेक्ट बनाएं (या फायरबेस जोड़ें, यदि आप किसी मौजूदा Google प्रोजेक्ट का उपयोग कर रहे हैं) पर क्लिक करें।
  5. अपने नए प्रोजेक्ट की ओवरव्यू स्क्रीन से, सेटअप वर्कफ़्लो लॉन्च करने के लिए Android आइकन पर क्लिक करें।
  6. कोडलैब का पैकेज नाम दर्ज करें: com.google.firebase.codelab.fcmandfiam

अपने ऐप में google-services.json फ़ाइल जोड़ें

पैकेज का नाम जोड़ने के बाद रजिस्टर ऐप पर क्लिक करें, फिर अपनी फ़ायरबेस एंड्रॉइड कॉन्फ़िगरेशन फ़ाइल प्राप्त करने के लिए google-services.json डाउनलोड करें , फिर google-services.json फ़ाइल को अपने प्रोजेक्ट में app निर्देशिका में कॉपी करें। फ़ाइल डाउनलोड होने के बाद आप कंसोल में दिखाए गए अगले चरणों के लिए छोड़ें पर क्लिक कर सकते हैं (वे बिल्ड-एंड्रॉइड-स्टार्ट प्रोजेक्ट में आपके लिए पहले ही किए जा चुके हैं)।

अपने ऐप में google-services प्लगइन जोड़ें

google-services प्लगइन Firebase का उपयोग करने के लिए आपके एप्लिकेशन को कॉन्फ़िगर करने के लिए google-services.json फ़ाइल का उपयोग करता है। google-services प्लगइन निर्भरता और प्लगइन स्वयं को क्रमशः प्रोजेक्ट और ऐप स्तर बिल्ड फ़ाइलों में जोड़ा जाना चाहिए। निम्नलिखित प्रविष्टियों की पुष्टि करें:

बिल्ड.ग्रेडल

buildscript {
  ...
  dependencies {
    ...
    classpath 'com.google.gms:google-services:4.3.8'
  }
}

ऐप/बिल्ड.ग्रेडल

plugins {
  ...
  id: 'com.google.gms.google-services'
}

निर्भरता जोड़ें

FCM और FIAM को निम्नलिखित निर्भरता की आवश्यकता होती है। इन निर्भरताओं को पहले से ही ऐप स्तर की बिल्ड फ़ाइल में जोड़ा जाना चाहिए। पुष्टि करें कि निम्नलिखित निर्भरताएँ जोड़ी गई हैं:

ऐप/बिल्ड.ग्रेडल

dependencies {
  ...
  implementation platform('com.google.firebase:firebase-bom:28.4.2')
  implementation 'com.google.firebase:firebase-analytics'
  implementation 'com.google.firebase:firebase-messaging'
  implementation 'com.google.firebase:firebase-inappmessaging-display'
}

अपने प्रोजेक्ट को ग्रेडल फाइलों के साथ सिंक करें

यह सुनिश्चित करने के लिए कि आपके ऐप के लिए सभी निर्भरताएं उपलब्ध हैं, आपको इस बिंदु पर अपने प्रोजेक्ट को ग्रेडल फाइलों के साथ सिंक करना चाहिए। Android Studio टूलबार से File > Sync Project with Gradle Files चुनें।

4. लॉग पहचानकर्ता

ऐप मैसेजिंग में फायरबेस क्लाउड मैसेजिंग और फायरबेस दोनों ऐप को मैसेज भेजने के लिए आइडेंटिफायर का इस्तेमाल करते हैं। FCM एक पंजीकरण टोकन का उपयोग करता है और FIAM एक इंस्टॉलेशन आईडी का उपयोग करता है।

  1. MainActivity.kt में संदेश भेजने के लिए आवश्यक पहचानकर्ताओं को लॉग करने के लिए TODO को नीचे दिए गए कोड से बदलें:
FirebaseMessaging.getInstance().token.addOnCompleteListener { regTokenTask ->
   if (regTokenTask.isSuccessful) {
       Log.d(TAG, "FCM registration token: ${regTokenTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve registration token",
           regTokenTask.exception)
   }
}
FirebaseInstallations.getInstance().id.addOnCompleteListener { installationIdTask ->
   if (installationIdTask.isSuccessful) {
       Log.d(TAG, "Firebase Installations ID: ${installationIdTask.result}")
   } else {
       Log.e(TAG, "Unable to retrieve installations ID",
           installationIdTask.exception)
   }
}
  1. अपने Android डिवाइस को कनेक्ट करें, और रन पर क्लिक करें ( निष्पादित.png ) एंड्रॉइड स्टूडियो टूलबार में। लॉग आइडेंटिफायर बटन पर टैप करने से FCM रजिस्ट्रेशन टोकन और फायरबेस इंस्टॉलेशन आईडी लॉगकैट में लॉग हो जाएगा। आउटपुट इस तरह दिखना चाहिए:
D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
  FCM registration token: emMc5LART6GV7...r0Q

5. परीक्षण एफसीएम संदेश भेजें

FCM संदेशों को Firebase कंसोल और FCM REST API दोनों से भेजा जा सकता है। इस कोडलैब में हम एक FCM सूचना संदेश तैयार करेंगे और उसे अपने डिवाइस पर भेजेंगे। अधिसूचना संदेश वे हैं जो सिस्टम के अधिसूचना क्षेत्र में प्रदर्शित होते हैं। इसके द्वारा परीक्षण FCM संदेश भेजें:

  1. सुनिश्चित करें कि ऐप बैकग्राउंड में है (होम स्क्रीन पर जाएं)
  2. फायरबेस कंसोल पर जाएं और बाएं नेविगेशन में क्लाउड मैसेजिंग का चयन करें
  3. अपना पहला संदेश भेजें चुनें
  4. संदेश के लिए शीर्षक और मुख्य भाग जोड़ें, फिर परीक्षण संदेश भेजें पर क्लिक करें

207ced65f5245ada.png

  1. FCM पंजीकरण टोकन जोड़ें, फिर परीक्षण पर क्लिक करें

f3556c6a8a6453fe.png

  1. डिवाइस पर डिस्प्ले नोटिफिकेशन देखें
  2. नोटिफिकेशन पर टैप करने से ऐप खुल जाता है

6. परीक्षण FIAM संदेश भेजें

विभिन्न प्रकार के उपयोगकर्ता ईवेंट के परिणामस्वरूप ऐप मैसेजिंग में फायरबेस को ट्रिगर किया जा सकता है। परीक्षण संदेश इन ऐप संदेश को ट्रिगर करने के लिए ऐप ओपन इवेंट का उपयोग करता है। एक परीक्षण FIAM संदेश भेजें:

  1. सुनिश्चित करें कि ऐप बैकग्राउंड में है (होम स्क्रीन पर जाएं)
  2. फायरबेस कंसोल पर जाएं और बाएं नेविगेशन में इन-ऐप मैसेजिंग चुनें
  3. अपना पहला अभियान बनाएं चुनें
  4. शीर्ष बैनर अभियान का चयन करें और संदेश का शीर्षक और मुख्य भाग दर्ज करें
  5. डिवाइस पर टेस्ट पर क्लिक करें

69f6ea5efff240d1.png

  1. इंस्टॉलेशन आईडी जोड़ें और टेस्ट पर क्लिक करें

24b101edfab47144.png

  1. ऐप फिर से खोलें
  2. ऐप संदेश में देखें

7. बधाई

बधाई हो, आपने FCM और FIAM दोनों संदेश सफलतापूर्वक भेजे हैं। अब आप जानते हैं कि अपने उपयोगकर्ताओं के साथ कैसे जुड़ना है, चाहे वे अग्रभूमि में आपके ऐप का उपयोग कर रहे हों या आपका ऐप पृष्ठभूमि में हो।

अग्रिम पठन

आगे क्या होगा

  • अपने स्वयं के Android ऐप में उपयोगकर्ताओं को संदेश भेजें।

संदर्भ दस्तावेज़