बैकग्राउंड में चल रहे ऐप्लिकेशन को टेस्ट मैसेज भेजें

FCM का इस्तेमाल शुरू करने के लिए, सबसे आसान यूज़ केस बनाएं: सूचना कंपोज़र से डेवलपमेंट डिवाइस पर सूचना का टेस्ट मैसेज भेजें. ऐसा तब करें, जब डिवाइस पर ऐप्लिकेशन बैकग्राउंड में हो. इस पेज पर, सेटअप से लेकर पुष्टि तक, इस सुविधा को चालू करने के सभी चरणों की सूची दी गई है. अगर आपने FCM के लिए Android क्लाइंट ऐप्लिकेशन सेट अप किया है, तो हो सकता है कि इसमें वे चरण भी शामिल हों जिन्हें आपने पहले ही पूरा कर लिया हो.

एसडीके टूल सेट अप करना

इस सेक्शन में उन टास्क के बारे में बताया गया है जिन्हें आपने शायद पहले ही पूरा कर लिया हो. ऐसा तब होता है, जब आपने अपने ऐप्लिकेशन के लिए Firebase की अन्य सुविधाएं पहले ही चालू कर ली हों.

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

• Android Studio को इंस्टॉल करें या उसे नए वर्शन में अपडेट करें.

• पक्का करें कि आपका प्रोजेक्ट इन ज़रूरी शर्तों को पूरा करता हो. ध्यान दें कि कुछ प्रॉडक्ट के लिए, ये ज़रूरी शर्तें ज़्यादा सख्त हो सकती हैं:

  • एपीआई लेवल 21 (Lollipop) या उसके बाद के वर्शन को टारगेट करता हो
  • Android 5.0 या इसके बाद वाले वर्शन का इस्तेमाल करता हो
  • Jetpack (AndroidX) का इस्तेमाल करता हो. इसमें वर्शन से जुड़ी ये ज़रूरी शर्तें शामिल हैं:
    • com.android.tools.build:gradle v7.3.0 या उसके बाद के वर्शन
    • compileSdkVersion 28 या उसके बाद

• अपने ऐप्लिकेशन को चलाने के लिए, किसी फ़िज़िकल डिवाइस को सेट अप करें या एम्युलेटर का इस्तेमाल करें.
  ध्यान दें कि Google Play services पर निर्भर रहने वाले Firebase SDK टूल के लिए, डिवाइस या एम्युलेटर पर Google Play services इंस्टॉल होना ज़रूरी है.

• अपने Google खाते का इस्तेमाल करके, Firebase में साइन इन करें.

अगर आपके पास पहले से कोई Android प्रोजेक्ट नहीं है और आपको सिर्फ़ Firebase प्रॉडक्ट आज़माना है, तो हमारे क्विकस्टार्ट सैंपल में से कोई एक डाउनलोड करें.

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

अपने Android ऐप्लिकेशन में Firebase जोड़ने से पहले, आपको एक Firebase प्रोजेक्ट बनाना होगा, ताकि उसे अपने Android ऐप्लिकेशन से कनेक्ट किया जा सके. Firebase प्रोजेक्ट के बारे में ज़्यादा जानने के लिए, Firebase प्रोजेक्ट के बारे में जानें पर जाएं.

अपने ऐप्लिकेशन को Firebase के साथ रजिस्टर करना

अपने Android ऐप्लिकेशन में Firebase का इस्तेमाल करने के लिए, आपको अपने ऐप्लिकेशन को Firebase प्रोजेक्ट में रजिस्टर करना होगा. ऐप्लिकेशन को रजिस्टर करने को अक्सर, अपने प्रोजेक्ट में ऐप्लिकेशन "जोड़ना" कहा जाता है.

1. Firebase कंसोल पर जाएं.

2. सेटअप वर्कफ़्लो लॉन्च करने के लिए, प्रोजेक्ट की खास जानकारी वाले पेज के बीच में मौजूद Android आइकॉन (plat_android) या ऐप्लिकेशन जोड़ें पर क्लिक करें.

3. Android पैकेज का नाम फ़ील्ड में, अपने ऐप्लिकेशन के पैकेज का नाम डालें.

   पैकेज का नाम क्या होता है और यह कहां मिलता है?

   • पैकेज का नाम, डिवाइस और Google Play Store पर आपके ऐप्लिकेशन की खास तौर से पहचान करता है.

   • पैकेज के नाम को अक्सर ऐप्लिकेशन आईडी कहा जाता है.

   • अपने ऐप्लिकेशन के पैकेज का नाम, मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल में ढूंढें. आम तौर पर, यह app/build.gradle (उदाहरण के लिए पैकेज का नाम: com.yourcompany.yourproject) होता है.

   • ध्यान दें कि पैकेज के नाम की वैल्यू केस-सेंसिटिव होती है. साथ ही, Firebase Android ऐप्लिकेशन को आपके Firebase प्रोजेक्ट में रजिस्टर करने के बाद, इसके लिए इस वैल्यू को बदला नहीं जा सकता.

4. (ज़रूरी नहीं) ऐप्लिकेशन की अन्य जानकारी डालें: ऐप्लिकेशन का निकनेम और डीबग साइनिंग सर्टिफ़िकेट SHA-1.

   Firebase में ऐप्लिकेशन के निकनेम और डीबग साइनिंग सर्टिफ़िकेट SHA-1 का इस्तेमाल कैसे किया जाता है?

   • ऐप्लिकेशन का निकनेम: यह एक इंटरनल आइडेंटिफ़ायर होता है, जो सिर्फ़ Firebase कंसोल में दिखता है

   • डीबग साइनिंग सर्टिफ़िकेट SHA-1: Firebase Authentication को SHA-1 हैश की ज़रूरत होती है. ऐसा तब होता है, जब Google खाते से साइन इन करने की सुविधा या फ़ोन नंबर से साइन इन करने की सुविधा का इस्तेमाल किया जा रहा हो. साथ ही, Firebase Dynamic Links को भी इसकी ज़रूरत होती है.

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

Firebase कॉन्फ़िगरेशन फ़ाइल जोड़ना

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

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

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

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

   • Firebase कॉन्फ़िगरेशन फ़ाइल में, आपके प्रोजेक्ट और ऐप्लिकेशन के लिए यूनीक आइडेंटिफ़ायर होते हैं. हालांकि, ये आइडेंटिफ़ायर गोपनीय नहीं होते. इस कॉन्फ़िगरेशन फ़ाइल के बारे में ज़्यादा जानने के लिए, Firebase प्रोजेक्ट के बारे में जानकारी पर जाएं.

   • Firebase कॉन्फ़िगरेशन फ़ाइल को किसी भी समय फिर से डाउनलोड किया जा सकता है.

   • पक्का करें कि कॉन्फ़िगरेशन फ़ाइल के नाम में (2) जैसे अतिरिक्त वर्ण न जोड़े गए हों.

2. google-services.jsonकॉन्फ़िगरेशन फ़ाइल में मौजूद वैल्यू को Firebase SDK टूल के लिए ऐक्सेस करने लायक बनाने के लिए, आपको Google services Gradle प्लगिन (google-services) की ज़रूरत होगी.

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

      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.3" 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.3' apply false
      }

   2. अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) Gradle फ़ाइल (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) में, Google services plugin जोड़ें:

      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 टूल जोड़ना

1. अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle) में, Android के लिए Firebase Cloud Messaging लाइब्रेरी की डिपेंडेंसी जोड़ें. हमारा सुझाव है कि लाइब्रेरी के वर्शन को कंट्रोल करने के लिए, Firebase Android BoM का इस्तेमाल करें.

   Firebase Cloud Messaging का बेहतर तरीके से इस्तेमाल करने के लिए, हमारा सुझाव है कि आप अपने Firebase प्रोजेक्ट में Google Analytics चालू करें. साथ ही, अपने ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल जोड़ें.

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:34.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:25.0.0")
       implementation("com.google.firebase:firebase-analytics:23.0.0")
   }

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

   क्या आपको invoke-custom के साथ काम करने की सुविधा और डिसुगरिंग चालू करने के बारे में, बिल्ड फ़ेल होने की सूचना मिल रही है? इस समस्या को ठीक करने का तरीका यहां बताया गया है.

   Android Gradle प्लग इन (AGP) v4.2 या इससे पहले के वर्शन का इस्तेमाल करने वाले Gradle बिल्ड को Java 8 के साथ काम करने की सुविधा चालू करनी होगी. ऐसा न करने पर, Firebase SDK टूल को जोड़ते समय इन Android प्रोजेक्ट में बिल्ड फ़ेल हो जाता है.

   बिल्ड फ़ेल होने की इस समस्या को ठीक करने के लिए, इनमें से कोई एक विकल्प आज़माएं:

   • गड़बड़ी के मैसेज में दिए गए compileOptions को अपने ऐप्लिकेशन-लेवल build.gradle.kts या build.gradle फ़ाइल में जोड़ें.
   • अपने Android प्रोजेक्ट के लिए, minSdk को 26 या उससे ज़्यादा पर सेट करें.

   अक्सर पूछे जाने वाले इस सवाल में, बिल्ड फ़ेल होने के बारे में ज़्यादा जानें.

रजिस्ट्रेशन टोकन ऐक्सेस करना

किसी डिवाइस पर मैसेज भेजने के लिए, आपको उस डिवाइस का रजिस्ट्रेशन टोकन पता होना चाहिए. इस ट्यूटोरियल को पूरा करने के लिए, आपको सूचनाओं वाली कंसोल में मौजूद फ़ील्ड में टोकन डालना होगा. इसलिए, टोकन पाने के बाद, उसे कॉपी करना या सुरक्षित तरीके से सेव करना न भूलें.

आपके ऐप्लिकेशन के पहली बार शुरू होने पर, FCM SDK, क्लाइंट ऐप्लिकेशन इंस्टेंस के लिए रजिस्ट्रेशन टोकन जनरेट करता है. अगर आपको किसी एक डिवाइस को टारगेट करना है या डिवाइस ग्रुप बनाने हैं, तो आपको इस टोकन को ऐक्सेस करना होगा. इसके लिए, FirebaseMessagingService को बढ़ाएं और onNewToken को बदलें. शुरुआत में टोकन रोटेट किया जा सकता है. इसलिए, हमारा सुझाव है कि आप रजिस्ट्रेशन का नया अपडेट किया गया टोकन पाएं.

रजिस्ट्रेशन टोकन में इन वजहों से बदलाव हो सकता है:

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

मौजूदा रजिस्ट्रेशन टोकन वापस पाना

जब आपको मौजूदा टोकन वापस पाना हो, तब FirebaseMessaging.getInstance().getToken() को कॉल करें:

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()
})

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 कॉलबैक ट्रिगर होता है.

/**
 * 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)
}
MyFirebaseMessagingService.kt

/**
 * 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);
}
MyFirebaseMessagingService.java

टोकन मिलने के बाद, उसे अपने ऐप्लिकेशन सर्वर पर भेजा जा सकता है. साथ ही, अपनी पसंद के तरीके से उसे सेव किया जा सकता है.

टेस्ट के तौर पर सूचना वाला मैसेज भेजना

1. टारगेट डिवाइस पर ऐप्लिकेशन इंस्टॉल करें और उसे चलाएं. Apple डिवाइसों पर, आपको रिमोट सूचनाएं पाने की अनुमति देने का अनुरोध स्वीकार करना होगा.

2. पक्का करें कि डिवाइस पर ऐप्लिकेशन बैकग्राउंड में चल रहा हो.

3. Firebase कंसोल में, मैसेजिंग पेज खोलें.

4. अगर यह आपका पहला मैसेज है, तो अपना पहला कैंपेन बनाएं को चुनें.

   1. Firebase सूचना वाले मैसेज चुनें. इसके बाद, बनाएं चुनें.

5. इसके अलावा, कैंपेन टैब पर जाकर, नया कैंपेन और फिर सूचनाएं चुनें.

6. मैसेज का टेक्स्ट डालें. अन्य सभी फ़ील्ड में जानकारी देना ज़रूरी नहीं है.

7. दाएं पैनल में मौजूद, टेस्ट मैसेज भेजें को चुनें.

8. FCM रजिस्ट्रेशन टोकन जोड़ें लेबल वाले फ़ील्ड में, वह रजिस्ट्रेशन टोकन डालें जो आपको इस गाइड के पिछले सेक्शन में मिला था.

9. जांचें को चुनें.

जांच करें को चुनने के बाद, टारगेट किए गए क्लाइंट डिवाइस (बैकग्राउंड में ऐप्लिकेशन के साथ) को सूचना मिलनी चाहिए.

अपने ऐप्लिकेशन पर मैसेज डिलीवर होने की जानकारी पाने के लिए, FCM रिपोर्टिंग डैशबोर्ड देखें. यह डैशबोर्ड, Apple और Android डिवाइसों पर भेजे गए और खोले गए मैसेज की संख्या रिकॉर्ड करता है. साथ ही, Android ऐप्लिकेशन के लिए "इंप्रेशन" (उपयोगकर्ताओं को दिखने वाली सूचनाएं) का डेटा भी रिकॉर्ड करता है.

अगले चरण

फ़ोरग्राउंड किए गए ऐप्लिकेशन को मैसेज भेजना

जब आपका ऐप्लिकेशन बैकग्राउंड में चल रहा हो, तब सूचना वाले मैसेज भेजने के बाद, फ़ोरग्राउंड में चल रहे ऐप्लिकेशन को मैसेज भेजने के लिए, Android ऐप्लिकेशन में मैसेज पाना लेख पढ़ें.

सूचना वाले मैसेज से आगे बढ़ें

सूचना वाले मैसेज से आगे बढ़कर, अपने ऐप्लिकेशन में अन्य बेहतर सुविधाएं जोड़ने के लिए, यह लेख पढ़ें:

• Android ऐप्लिकेशन में मैसेज पाना
• एक से ज़्यादा डिवाइसों पर मैसेज भेजना