FCM का इस्तेमाल शुरू करने के लिए, इस्तेमाल का सबसे आसान उदाहरण बनाएं: किसी इसके बाद, डेवलपमेंट डिवाइस पर नोटिफ़िकेशन कंपोज़र जब ऐप्लिकेशन डिवाइस में बैकग्राउंड में चल रहा हो. इस पेज पर, सेटअप करने से लेकर पुष्टि करने तक के सभी चरणों की जानकारी दी गई है. — इसमें वे चरण भी शामिल हो सकते हैं जिन्हें आपने पहले ही पूरा कर लिया था. ऐसा होने पर, Android क्लाइंट ऐप्लिकेशन सेट अप किया हो FCM के लिए.
SDK टूल सेट अप करें
इस सेक्शन में उन टास्क के बारे में बताया गया है जिन्हें आपने पहले ही चालू कर दिया था. Firebase की अन्य सुविधाएं उपलब्ध हैं.
शुरू करने से पहले
Android Studio को इंस्टॉल या अपडेट करें सबसे नए वर्शन का इस्तेमाल करें.
पक्का करें कि आपका प्रोजेक्ट इन ज़रूरी शर्तों को पूरा करता हो (ध्यान रखें कि कुछ प्रॉडक्ट शर्तों को सख्ती से लागू किया जा सकता है):
- टारगेट एपीआई लेवल 19 (KitKat) या उससे ज़्यादा
- जो Android 4.4 या इसके बाद वाले वर्शन का इस्तेमाल करते हों
- इस्तेमाल
Jetpack (AndroidX),
जिसमें इन वर्शन की ज़रूरी शर्तों को पूरा करना भी शामिल है:
com.android.tools.build:gradle
v7.3.0 या उसके बाद का वर्शनcompileSdkVersion
28 या उसके बाद
फ़िज़िकल डिवाइस सेट अप करें या emulator से आपका ऐप्लिकेशन चलाएं.
ध्यान दें कि Google Play पर निर्भर Firebase SDK टूल सेवाओं के लिए डिवाइस का होना ज़रूरी है या एम्युलेटर पर, Google Play services को इंस्टॉल किया गया हो.अपने Google खाते का इस्तेमाल करके Firebase में साइन इन करें जोड़ें.
अगर आपके पास पहले से कोई Android प्रोजेक्ट नहीं है और आपको सिर्फ़ Firebase का इस्तेमाल करना है, तो प्रॉडक्ट के लिए, आप हमारे क्विकस्टार्ट सैंपल में से एक डाउनलोड कर सकते हैं.
Firebase प्रोजेक्ट बनाना
Firebase को अपने Android ऐप्लिकेशन में जोड़ने से पहले, आपको एक Firebase बनाना होगा प्रोजेक्ट पर काम करता है. इस लिंक पर जाएँ ज़्यादा जानने के लिए, Firebase प्रोजेक्ट को समझना Firebase प्रोजेक्ट.
अपने ऐप्लिकेशन को Firebase के साथ रजिस्टर करना
अपने Android ऐप्लिकेशन में Firebase का इस्तेमाल करने के लिए, आपको अपने ऐप्लिकेशन को Firebase प्रोजेक्ट. अपने ऐप्लिकेशन को रजिस्टर करने को अक्सर "जोड़ना" कहा जाता है आपका ऐप्लिकेशन प्रोजेक्ट.
Firebase कंसोल पर जाएं.
प्रोजेक्ट की खास जानकारी देने वाले पेज के बीच में, Android आइकॉन पर क्लिक करें (
) या सेटअप वर्कफ़्लो लॉन्च करने के लिए ऐप्लिकेशन जोड़ें.Android पैकेज का नाम फ़ील्ड में, अपने ऐप्लिकेशन के पैकेज का नाम डालें.
(ज़रूरी नहीं) ऐप्लिकेशन के बारे में अन्य जानकारी डालें: ऐप्लिकेशन का कोई दूसरा नाम और SHA-1 के हस्ताक्षर वाले सर्टिफ़िकेट को डीबग करें.
ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.
Firebase कॉन्फ़िगरेशन फ़ाइल जोड़ना
Android डिवाइस के लिए Firebase कॉन्फ़िगरेशन फ़ाइल डाउनलोड करें और फिर जोड़ें (
) को आपके ऐप्लिकेशन में:google-services.json अपने Firebase Android को पाने के लिए google-services.json डाउनलोड करें पर क्लिक करें कॉन्फ़िगरेशन फ़ाइल है.
अपनी कॉन्फ़िगरेशन फ़ाइल को, मॉड्यूल (app-level) रूट डायरेक्ट्री में ले जाएं आपका ऐप्लिकेशन.
अपनी
कॉन्फ़िगरेशन फ़ाइल में मौजूद वैल्यू को ऐक्सेस करने के लिए और Firebase SDK टूल का इस्तेमाल करना है, तो आपको Google सेवाओं के Gradle प्लग इन (google-services.json google-services
).आपकी रूट-लेवल (प्रोजेक्ट-लेवल) की Gradle फ़ाइल में (
<project>/build.gradle.kts
या<project>/build.gradle
), जोड़ें एक डिपेंडेंसी के तौर पर Google की सेवाओं के लिए प्लगिन:Kotlin
plugins { id("com.android.application") version "7.3.0" apply false // ... // Add the dependency for the Google services Gradle plugin id("com.google.gms.google-services") version "4.4.2" apply false }
Groovy
plugins { id 'com.android.application' version '7.3.0' apply false // ... // Add the dependency for the Google services Gradle plugin id 'com.google.gms.google-services' version '4.4.2' apply false }
आपके मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल में (आम तौर पर
<project>/<app-module>/build.gradle.kts
या<project>/<app-module>/build.gradle
), Google सेवाओं का प्लगिन जोड़ें:Kotlin
plugins { id("com.android.application") // Add the Google services Gradle plugin id("com.google.gms.google-services") // ... }
Groovy
plugins { id 'com.android.application' // Add the Google services Gradle plugin id 'com.google.gms.google-services' // ... }
अपने ऐप्लिकेशन में Firebase SDK टूल जोड़ना
आपके मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल में (आम तौर पर
<project>/<app-module>/build.gradle.kts
या<project>/<app-module>/build.gradle
), Android के लिए Firebase Cloud Messaging लाइब्रेरी के लिए डिपेंडेंसी जोड़ें. हमारा सुझाव है कि Firebase Android BoM लाइब्रेरी के वर्शन को कंट्रोल करने के लिए.Firebase Cloud Messaging के साथ बेहतर अनुभव के लिए, हमारा सुझाव है कि Google Analytics को चालू किया जा रहा है जोड़ना होगा. साथ ही, अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल जोड़ना होगा.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.2.0")) // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-messaging") implementation("com.google.firebase:firebase-analytics") }
Firebase Android BoM का इस्तेमाल करने पर, आपका ऐप्लिकेशन हमेशा Firebase Android लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल करेगा.
(वैकल्पिक) BoM का इस्तेमाल करके, बिना Firebase लाइब्रेरी डिपेंडेंसी जोड़ें
अगर आपको Firebase BoM का इस्तेमाल नहीं करना है, तो आपको Firebase लाइब्रेरी का हर वर्शन बताना होगा इसकी डिपेंडेंसी लाइन में.
ध्यान दें कि अगर आप अपने ऐप्लिकेशन में कई Firebase लाइब्रेरी का इस्तेमाल करते हैं, तो हम लाइब्रेरी वर्शन को मैनेज करने के लिए, BoM का इस्तेमाल करने की सलाह दी जाती है. इससे यह पक्का होता है कि सभी वर्शन साथ काम करता है.
dependencies { // Add the dependencies for the Firebase Cloud Messaging and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-messaging:24.0.1") implementation("com.google.firebase:firebase-analytics:22.1.0") }
अपने Android प्रोजेक्ट को Gradle फ़ाइलों के साथ सिंक करें.
रजिस्ट्रेशन टोकन ऐक्सेस करना
किसी डिवाइस पर मैसेज भेजने के लिए, आपको यह पता होना चाहिए कि उस डिवाइस रजिस्ट्रेशन टोकन. क्योंकि आपको टोकन को इस ट्यूटोरियल को पूरा करने के लिए, सूचना कंसोल की जांच करें. इसके लिए, टोकन को कॉपी करना न भूलें या आपके पास उसे वापस लाने के बाद, उसे सुरक्षित तरीके से सेव करने की सुविधा होती है.
आपके ऐप्लिकेशन के शुरुआती चालू होने पर, FCM SDK टूल एक रजिस्ट्रेशन जनरेट करता है
क्लाइंट ऐप्लिकेशन इंस्टेंस के लिए टोकन. अगर आपको किसी एक डिवाइस को टारगेट करना है या
डिवाइस ग्रुप बना सकते हैं, तो आपको
FirebaseMessagingService
और ओवरराइड onNewToken
.
इस सेक्शन में, टोकन को फिर से पाने और बदलावों को मॉनिटर करने का तरीका बताया गया है उस टोकन के लिए इस्तेमाल किया जा सकता है. क्योंकि टोकन को इनीशियल के बाद घुमाया जा सकता है तो हमारा सुझाव है कि आप हाल ही में अपडेट किया गया रजिस्ट्रेशन फिर से पाएं टोकन.
रजिस्ट्रेशन टोकन तब बदल सकता है, जब:
- ऐप्लिकेशन को नए डिवाइस पर वापस लाया गया
- जब उपयोगकर्ता ऐप्लिकेशन को अनइंस्टॉल करता है/फिर से इंस्टॉल करता है
- उपयोगकर्ता, ऐप्लिकेशन का डेटा मिटाता है.
मौजूदा रजिस्ट्रेशन टोकन वापस पाएं
जब आपको मौजूदा टोकन वापस पाना हो, तो कॉल करें
FirebaseMessaging.getInstance().getToken()
:
Kotlin+KTX
FirebaseMessaging.getInstance().token.addOnCompleteListener(OnCompleteListener { task -> if (!task.isSuccessful) { Log.w(TAG, "Fetching FCM registration token failed", task.exception) return@OnCompleteListener } // Get new FCM registration token val token = task.result // Log and toast val msg = getString(R.string.msg_token_fmt, token) Log.d(TAG, msg) Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show() })
Java
FirebaseMessaging.getInstance().getToken() .addOnCompleteListener(new OnCompleteListener<String>() { @Override public void onComplete(@NonNull Task<String> task) { if (!task.isSuccessful()) { Log.w(TAG, "Fetching FCM registration token failed", task.getException()); return; } // Get new FCM registration token String token = task.getResult(); // Log and toast String msg = getString(R.string.msg_token_fmt, token); Log.d(TAG, msg); Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show(); } });
टोकन जनरेट करने की प्रोसेस पर नज़र रखें
जब भी कोई नया टोकन जनरेट होता है, तब onNewToken
कॉलबैक ट्रिगर होता है.
Kotlin+KTX
/** * Called if the FCM registration token is updated. This may occur if the security of * the previous token had been compromised. Note that this is called when the * FCM registration token is initially generated so this is where you would retrieve the token. */ override fun onNewToken(token: String) { Log.d(TAG, "Refreshed token: $token") // If you want to send messages to this application instance or // manage this apps subscriptions on the server side, send the // FCM registration token to your app server. sendRegistrationToServer(token) }
Java
/** * There are two scenarios when onNewToken is called: * 1) When a new token is generated on initial app startup * 2) Whenever an existing token is changed * Under #2, there are three scenarios when the existing token is changed: * A) App is restored to a new device * B) User uninstalls/reinstalls the app * C) User clears app data */ @Override public void onNewToken(@NonNull String token) { Log.d(TAG, "Refreshed token: " + token); // If you want to send messages to this application instance or // manage this apps subscriptions on the server side, send the // FCM registration token to your app server. sendRegistrationToServer(token); }
टोकन पाने के बाद, उसे अपने ऐप्लिकेशन सर्वर और स्टोर पर भेजें अपने पसंदीदा तरीके से उसे अपडेट करें.
परीक्षण सूचना संदेश भेजें
टारगेट डिवाइस पर ऐप्लिकेशन इंस्टॉल करें और चलाएं. Apple डिवाइसों पर, इन चीज़ों की ज़रूरत होगी रिमोट नोटिफ़िकेशन पाने के लिए अनुमति के अनुरोध को स्वीकार करें.
पक्का करें कि ऐप्लिकेशन, डिवाइस के बैकग्राउंड में चल रहा हो.
Firebase कंसोल में, मैसेज सेवा वाला पेज खोलें.
अगर यह आपका पहला मैसेज है, तो अपना पहला मैसेज बनाएं चुनें कैंपेन बनाएं.
- Firebase सूचना मैसेज चुनें और बनाएं चुनें.
या फिर, कैंपेन टैब पर नया कैंपेन चुनें और फिर सूचनाएं पर क्लिक करें.
मैसेज का टेक्स्ट डालें. अन्य सभी फ़ील्ड ज़रूरी नहीं हैं.
दाएं पैनल से, टेस्ट मैसेज भेजें को चुनें.
FCM रजिस्ट्रेशन टोकन जोड़ें लेबल वाले फ़ील्ड में रजिस्ट्रेशन डालें इस गाइड के पिछले सेक्शन में मिला टोकन.
जांचें को चुनें.
जांच करें चुनने के बाद, टारगेट किया गया क्लाइंट डिवाइस (जिसमें ऐप्लिकेशन बैकग्राउंड) पर सूचना भेजनी चाहिए.
अपने ऐप्लिकेशन पर मैसेज डिलीवरी की अहम जानकारी के लिए, इसे देखें FCM रिपोर्टिंग डैशबोर्ड, जो Apple और Android डिवाइसों पर, भेजे गए और खोले गए मैसेज की संख्या "इंप्रेशन" का डेटा (उपयोगकर्ताओं की देखी गई सूचनाएं) Android ऐप्लिकेशन के लिए.
अगले चरण
फ़ोरग्राउंड में चलने वाले ऐप्लिकेशन पर मैसेज भेजें
अपने ऐप्लिकेशन के इस्तेमाल में होने के दौरान, सूचना वाले मैसेज भेजने के बाद बैकग्राउंड, देखें Android ऐप्लिकेशन में मैसेज पाना फ़ोरग्राउंड वाले ऐप्लिकेशन पर भेजना शुरू करने के लिए.
सूचना वाले मैसेज के अलावा अन्य सुविधाएं भी पाएं
सूचना वाले मैसेज के अलावा, अपनी ऐप्लिकेशन, देखें: