1. शुरू करने से पहले
इस कोडलैब में, आपको उपयोगकर्ताओं से जुड़ने की सुविधा जोड़ने का तरीका पता है. भले ही, वे फ़ोरग्राउंड में आपके ऐप्लिकेशन का इस्तेमाल कर रहे हों या आपके ऐप्लिकेशन को बैकग्राउंड में इस्तेमाल किया जा रहा हो.
ज़रूरी शर्तें
कोई नहीं
आपको इनके बारे में जानकारी मिलेगी
- अपने Android ऐप्लिकेशन में Firebase जोड़ना
- FCM और FIAM डिपेंडेंसी जोड़ना
- अपने ऐप्लिकेशन पर परीक्षण FCM संदेश भेजें
- अपने ऐप्लिकेशन पर टेस्ट एफ़आईएएम मैसेज भेजें
आपको इन चीज़ों की ज़रूरत होगी
- Android Studio 4.1
- Android डिवाइस या एम्युलेटर
2. शुरू करें
सैंपल कोड पाएं
कमांड लाइन से GitHub रिपॉज़िटरी का क्लोन बनाएं:
स्टार्टर ऐप्लिकेशन को इंपोर्ट करें
Android Studio से, codelab-fcm-and-fiam डायरेक्ट्री ( 
) चुनें. यह पिछले चरण में क्लोन किया गया होगा (फ़ाइल > खोलें > .../codelab-fcm-and-fiam).
अब Android Studio में FcmAndFiam प्रोजेक्ट खुल जाएगा. अगर आपको किसी google-services.json फ़ाइल के मौजूद न होने के बारे में चेतावनी दिखती है, तो चिंता न करें. इसे अगले चरण में जोड़ा जाएगा.
3. Firebase कंसोल प्रोजेक्ट बनाएं
प्रोजेक्ट में Firebase जोड़ना
- Firebase कंसोल पर जाएं.
- प्रोजेक्ट जोड़ें चुनें.
- प्रोजेक्ट का नाम चुनें या डालें.
- Firebase कंसोल में, सेटअप करने के बाकी चरण पूरे करें. इसके बाद, प्रोजेक्ट बनाएं पर क्लिक करें. अगर Google के किसी मौजूदा प्रोजेक्ट का इस्तेमाल किया जा रहा है, तो Firebase जोड़ें.
- अपने नए प्रोजेक्ट की खास जानकारी वाली स्क्रीन पर, सेटअप का वर्कफ़्लो लॉन्च करने के लिए Android आइकॉन पर क्लिक करें.
- कोडलैब के पैकेज का नाम डालें:
com.google.firebase.codelab.fcmandfiam
अपने ऐप्लिकेशन में google-services.json फ़ाइल जोड़ना
पैकेज का नाम जोड़ने के बाद, Firebase में Android कॉन्फ़िगरेशन वाली फ़ाइल पाने के लिए, ऐप्लिकेशन रजिस्टर करें और फिर google-services.json पर क्लिक करें. इसके बाद, अपने प्रोजेक्ट की app डायरेक्ट्री में google-services.json फ़ाइल को कॉपी करें. फ़ाइल डाउनलोड होने के बाद, कंसोल में दिखाए गए अगले चरणों पर जाने के लिए, अभी नहीं पर क्लिक करें. इन चरणों को बिल्ड-Android-स्टार्ट प्रोजेक्ट में आपके लिए पहले ही कर दिया गया है.
अपने ऐप्लिकेशन में Google की सेवाओं के लिए प्लगिन जोड़ना
Google-सेवाएं प्लग इन आपके ऐप्लिकेशन को Firebase का इस्तेमाल करने के लिए कॉन्फ़िगर करने के लिए google-services.json फ़ाइल का इस्तेमाल करता है. Google-services प्लगिन डिपेंडेंसी और प्लगिन को पहले से ही प्रोजेक्ट लेवल और ऐप्लिकेशन लेवल की बिल्ड फ़ाइलों में पहले से जोड़ा जाना चाहिए. इन एंट्री की पुष्टि करें:
बिल्ड.ग्रेडल
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'
}
Grele फ़ाइलों के साथ प्रोजेक्ट सिंक करना
यह पक्का करने के लिए कि आपके ऐप्लिकेशन पर सभी डिपेंडेंसी उपलब्ध हों, आपको इस समय अपने प्रोजेक्ट को Gradle फ़ाइलों के साथ सिंक करना चाहिए. फ़ाइल > चुनें Android Studio के टूलबार से, Gradle फ़ाइलों के साथ प्रोजेक्ट सिंक करें.
4. लॉग आइडेंटिफ़ायर
'Firebase क्लाउड से मैसेज' और 'Firebase इन-ऐप्लिकेशन मैसेज', दोनों ही ऐप्लिकेशन को मैसेज भेजने के लिए आइडेंटिफ़ायर का इस्तेमाल करते हैं. FCM रजिस्ट्रेशन टोकन का इस्तेमाल करता है और FIAM, इंस्टॉलेशन आईडी का इस्तेमाल करता है.
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)
}
}
- अपना Android डिवाइस कनेक्ट करें और Android Studio टूलबार में Run (
) पर क्लिक करें. लॉग आइडेंटिफ़ायर बटन पर टैप करने से, FCM रजिस्ट्रेशन टोकन और Firebase इंस्टॉलेशन आईडी को लॉगकैट में लॉग कर दिया जाएगा. आउटपुट कुछ ऐसा दिखना चाहिए:
D/FcmAndFiam: Firebase Installations ID: emMc5...AsJfb
FCM registration token: emMc5LART6GV7...r0Q
5. परीक्षण FCM संदेश भेजें
FCM मैसेज, Firebase कंसोल और FCM REST API, दोनों से भेजे जा सकते हैं. इस कोडलैब में, हम एक FCM सूचना मैसेज लिखेंगे और उसे अपने डिवाइस पर भेजेंगे. सूचना मैसेज वे होते हैं जो सिस्टम के सूचना वाली जगह पर दिखाए जाते हैं. इसके द्वारा एक परीक्षण FCM संदेश भेजें:
- पक्का करें कि ऐप्लिकेशन बैकग्राउंड में काम कर रहा हो (होम स्क्रीन पर जाएं)
- Firebase कंसोल पर जाएं और बाएं नेविगेशन में क्लाउड से मैसेज चुनें
- अपना पहला मैसेज भेजें को चुनें
- मैसेज के लिए टाइटल और मुख्य हिस्सा जोड़ें. इसके बाद, टेस्ट मैसेज भेजें पर क्लिक करें
- FCM पंजीकरण टोकन जोड़ें, फिर जांच करें पर क्लिक करें
- डिवाइस पर डिसप्ले की सूचना देखें
- सूचना पर टैप करने से ऐप्लिकेशन खुल जाता है
6. टेस्ट एफ़आईएएम मैसेज भेजें
Firebase इन-ऐप्लिकेशन मैसेज, कई तरह के उपयोगकर्ता इवेंट की वजह से ट्रिगर हो सकता है. टेस्ट मैसेज, ऐप्लिकेशन खोलने पर दिखने वाले इवेंट का इस्तेमाल करके, ऐप्लिकेशन में मैसेज को ट्रिगर करता है. इसके ज़रिए एक टेस्ट एफ़आईएएम मैसेज भेजें:
- पक्का करें कि ऐप्लिकेशन बैकग्राउंड में काम कर रहा हो (होम स्क्रीन पर जाएं)
- Firebase कंसोल पर जाएं और बाएं नेविगेशन में, इन-ऐप्लिकेशन मैसेज चुनें
- अपना पहला कैंपेन बनाएं चुनें
- टॉप बैनर कैंपेन चुनें और मैसेज का टाइटल और मुख्य हिस्सा डालें
- डिवाइस पर टेस्ट करें पर क्लिक करें
- इंस्टॉलेशन आईडी जोड़ें और जांच करें पर क्लिक करें
- ऐप्लिकेशन को फिर से खोलें
- ऐप्लिकेशन के मैसेज में देखें
7. बधाई
बधाई हो, आपने FCM और FIAM दोनों मैसेज भेज दिए हैं. अब आपको पता है कि अपने उपयोगकर्ताओं से कैसे जुड़ें. भले ही, वे फ़ोरग्राउंड में आपके ऐप्लिकेशन का इस्तेमाल कर रहे हों या आपका ऐप्लिकेशन बैकग्राउंड में चल रहा हो.
आगे पढ़ें
आगे क्या करना है
- अपने Android ऐप्लिकेशन का इस्तेमाल करने वाले लोगों को मैसेज भेजें.