उपयोगकर्ताओं को मैसेज भेजने के लिए, FCM और FIAM का इस्तेमाल करना

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

इस कोडलैब में, आपको यह जानकारी मिलेगी कि उपयोगकर्ताओं को अपने ऐप्लिकेशन से कैसे जोड़ा जाए. भले ही, वे आपके ऐप्लिकेशन का इस्तेमाल फ़ोरग्राउंड में कर रहे हों या बैकग्राउंड में.

ज़रूरी शर्तें

कोई नहीं

आपको क्या सीखने को मिलेगा

• अपने Android ऐप्लिकेशन में Firebase जोड़ना
• FCM और FIAM डिपेंडेंसी जोड़ना
• अपने ऐप्लिकेशन पर टेस्ट FCM मैसेज भेजना
• अपने ऐप्लिकेशन पर टेस्ट FIAM मैसेज भेजना

आपको इन चीज़ों की ज़रूरत होगी

• Android Studio 4.1
• Android डिवाइस या एम्युलेटर

2. शुरू करें

सैंपल कोड पाना

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

स्टार्टर ऐप्लिकेशन इंपोर्ट करना

Android Studio में, codelab-fcm-and-fiam डायरेक्ट्री ( ) चुनें. यह वही डायरेक्ट्री होगी जिसे आपने पिछले चरण में क्लोन किया था (File > Open > .../codelab-fcm-and-fiam).

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

3. Firebase का इस्तेमाल करने के लिए, Firebase प्रोजेक्ट और ऐप्लिकेशन सेट अप करना

Firebase प्रोजेक्ट बनाना

1. अपने Google खाते का इस्तेमाल करके, Firebase कंसोल में साइन इन करें.
2. नया प्रोजेक्ट बनाने के लिए बटन पर क्लिक करें. इसके बाद, प्रोजेक्ट का नाम डालें. उदाहरण के लिए, Send messages codelab.
3. जारी रखें पर क्लिक करें.
4. अगर आपसे कहा जाए, तो Firebase की शर्तें पढ़ें और स्वीकार करें. इसके बाद, जारी रखें पर क्लिक करें.
5. (ज़रूरी नहीं) Firebase कंसोल में एआई की मदद पाने की सुविधा चालू करें. इसे "Firebase में Gemini" कहा जाता है.
6. इस कोडलैब के लिए, आपको Firebase के प्रॉडक्ट का बेहतर तरीके से इस्तेमाल करने के लिए Google Analytics की ज़रूरत होगी. इसलिए, Google Analytics के विकल्प के लिए टॉगल चालू रखें. Google Analytics को सेट अप करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.
7. प्रोजेक्ट बनाएं पर क्लिक करें. इसके बाद, प्रोजेक्ट के प्रोविज़न होने का इंतज़ार करें. इसके बाद, जारी रखें पर क्लिक करें.

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

1. अपने नए प्रोजेक्ट की खास जानकारी वाली स्क्रीन पर, Android आइकॉन पर क्लिक करके सेटअप वर्कफ़्लो लॉन्च करें.
2. कोड लैब के पैकेज का नाम डालें: com.google.firebase.codelab.fcmandfiam
3. पैकेज का नाम जोड़ने के बाद, ऐप्लिकेशन रजिस्टर करें और फिर google-services.json डाउनलोड करें पर क्लिक करें. इससे आपको Firebase Android कॉन्फ़िगरेशन फ़ाइल मिल जाएगी. इसके बाद, google-services.json फ़ाइल को अपने प्रोजेक्ट की app डायरेक्ट्री में कॉपी करें. फ़ाइल डाउनलोड होने के बाद, कंसोल में दिखाए गए अगले चरणों के लिए छोड़ें पर क्लिक करें. ये चरण, build-android-start प्रोजेक्ट में पहले ही पूरे कर लिए गए हैं.
4. अपने ऐप्लिकेशन में google-services प्लगिन जोड़ें**
   google-services प्लगिन, google-services.json फ़ाइल का इस्तेमाल करके आपके ऐप्लिकेशन को Firebase का इस्तेमाल करने के लिए कॉन्फ़िगर करता है. google-services प्लगिन की डिपेंडेंसी और प्लगिन को प्रोजेक्ट और ऐप्लिकेशन लेवल की बिल्ड फ़ाइलों में पहले से ही जोड़ा जाना चाहिए. इन एंट्री की पुष्टि करें:build.gradle

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

   app/build.gradle

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

डिपेंडेंसी जोड़ना

FCM और FIAM के लिए, यहां दी गई डिपेंडेंसी ज़रूरी हैं. ये डिपेंडेंसी, ऐप्लिकेशन लेवल की बिल्ड फ़ाइल में पहले से ही जोड़ी जानी चाहिए. पुष्टि करें कि ये डिपेंडेंसी जोड़ी गई हैं:

app/build.gradle

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'
}

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

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

4. लॉग आइडेंटिफ़ायर

Firebase Cloud Messaging और Firebase In App Messaging, दोनों ही ऐप्लिकेशन को मैसेज भेजने के लिए आइडेंटिफ़ायर का इस्तेमाल करते हैं. 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)
   }
}

2. अपने Android डिवाइस को कनेक्ट करें. इसके बाद, Android Studio टूलबार में मौजूद चलाएं ( ) पर क्लिक करें. लॉग आइडेंटिफ़ायर बटन पर टैप करने से, FCM रजिस्ट्रेशन टोकन और Firebase Installations आईडी को logcat में लॉग किया जाएगा. आउटपुट ऐसा दिखना चाहिए:

D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
  FCM registration token: emMc5LART6GV7...r0Q

5. टेस्ट FCM मैसेज भेजना

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

1. पक्का करें कि ऐप्लिकेशन बैकग्राउंड में चल रहा हो (होम स्क्रीन पर जाएं)
2. Firebase कंसोल पर जाएं और बाईं ओर मौजूद नेविगेशन में Cloud Messaging को चुनें
3. पहला मैसेज भेजें को चुनें
4. मैसेज के लिए टाइटल और मुख्य हिस्सा जोड़ें. इसके बाद, टेस्ट मैसेज भेजें पर क्लिक करें

5. FCM रजिस्ट्रेशन टोकन जोड़ें. इसके बाद, जांच करें पर क्लिक करें

6. डिवाइस पर सूचना दिखना
7. सूचना पर टैप करने से ऐप्लिकेशन खुल जाता है

6. टेस्ट के तौर पर FIAM मैसेज भेजना

Firebase In App Messaging को कई तरह के उपयोगकर्ता इवेंट के आधार पर ट्रिगर किया जा सकता है. जांच के लिए इस्तेमाल किए जाने वाले मैसेज में, ऐप्लिकेशन खोलने के इवेंट का इस्तेमाल किया जाता है. इससे ऐप्लिकेशन में दिखने वाला मैसेज ट्रिगर होता है. टेस्ट के तौर पर, एफआईएम मैसेज भेजने के लिए:

1. पक्का करें कि ऐप्लिकेशन बैकग्राउंड में चल रहा हो (होम स्क्रीन पर जाएं)
2. Firebase कंसोल पर जाएं और बाईं ओर मौजूद नेविगेशन में जाकर, ऐप्लिकेशन में दिखने वाले मैसेज की सुविधा चुनें
3. अपना पहला कैंपेन बनाएं को चुनें
4. सबसे ऊपर मौजूद बैनर कैंपेन चुनें और मैसेज का टाइटल और मुख्य हिस्सा डालें
5. डिवाइस पर टेस्ट करें पर क्लिक करें

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

7. ऐप्लिकेशन को फिर से खोलें
8. ऐप्लिकेशन में दिखने वाले मैसेज को देखें

7. बधाई

बधाई हो, आपने FCM और FIAM, दोनों मैसेज भेज दिए हैं. अब आपको पता है कि उपयोगकर्ताओं से कैसे जुड़ा जाए. भले ही, वे आपके ऐप्लिकेशन का इस्तेमाल फ़ोरग्राउंड में कर रहे हों या बैकग्राउंड में.

इस बारे में और पढ़ें

• Firebase क्लाउड से मैसेज भेजने की सुविधा से जुड़े दस्तावेज़
• Firebase In-App Messaging के दस्तावेज़

आगे क्या करना है

• अपने Android ऐप्लिकेशन में मौजूद उपयोगकर्ताओं को मैसेज भेजें.

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

• Firebase क्लाउड से मैसेज भेजने की सुविधा
• Firebase In-App Messaging