ईमेल लिंक से साइन इन करने की सुविधा को Firebase डाइनैमिक लिंक (Android) से माइग्रेट करना

पहले, ईमेल लिंक से पुष्टि करने के लिए Firebase Dynamic Links का इस्तेमाल किया जाता था. हालांकि, यह सुविधा 25 अगस्त, 2025 से बंद हो जाएगी. हमने Firebase Authentication के Android SDK के 23.2.0 या इसके बाद के वर्शन और Firebase BoM के 33.9.0 या इसके बाद के वर्शन में, एक दूसरा विकल्प पब्लिश किया है. अगर आपका ऐप्लिकेशन, पुराने स्टाइल के लिंक का इस्तेमाल करता है और आपको अपने ऐप्लिकेशन को माइग्रेट करने के लिए कोई दूसरा तरीका इस्तेमाल करना है, तो Firebase Hosting पर आधारित नए सिस्टम का इस्तेमाल करने के लिए, Android में ईमेल लिंक का इस्तेमाल करके Firebase से पुष्टि करने का तरीका देखें.

इसके अलावा, अगर Firebase Authentication Android SDK के 20.0.0 से पहले के वर्शन (या Firebase BoM के 26.0.0 से पहले के वर्शन) का इस्तेमाल किया जा रहा है, ताकि Firebase Authentication के साथ OAuth फ़्लो मैनेज किए जा सकें, तो आपको Authentication SDK या BoM के सबसे नए वर्शन (Authentication का 20.0.0 या इसके बाद का वर्शन या BoM का 26.0.0 या इसके बाद का वर्शन) पर अपडेट करना होगा. ऐसा करने पर ही, Firebase Authentication में OAuth फ़्लो को मैनेज किया जा सकेगा.

अपने जुड़े हुए Firebase Dynamic Links डोमेन को Firebase Hosting डोमेन पर माइग्रेट करें

अब से, Firebase Dynamic Links डोमेन के बजाय, Firebase Authentication आपके प्रोजेक्ट के लिए Firebase Hosting के डिफ़ॉल्ट डोमेन का इस्तेमाल करेगा. इससे मोबाइल ऐप्लिकेशन में, ईमेल लिंक और अन्य आउट-ऑफ़-बैंड लिंक वाली कार्रवाइयों के लिए लिंक बनाए जा सकेंगे. इसका मतलब है कि आपके ऐप्लिकेशन को भी अपडेट करना होगा, ताकि वह इस डिफ़ॉल्ट डोमेन को आपके मोबाइल ऐप्लिकेशन के ईमेल से पुष्टि करने वाले लिंक के लिए, उससे जुड़ा डोमेन के तौर पर इस्तेमाल कर सके.

अपने मोबाइल ऐप्लिकेशन के लिंक को अपडेट करने के लिए, Android में ईमेल लिंक का इस्तेमाल करके Firebase से पुष्टि करने का तरीका में दिए गए निर्देशों का पालन करें. इससे, Firebase Hosting के नए Firebase Hosting डिफ़ॉल्ट डोमेन का इस्तेमाल किया जा सकेगा. यह डोमेन, अपने-आप उपलब्ध हो जाता है.

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

अगर आपको अपने किसी कस्टम Firebase Hosting डोमेन या अपने कस्टम Firebase Dynamic Links डोमेन को, अपने नए जुड़े डोमेन के तौर पर इस्तेमाल करना है, तो उस डोमेन के हिसाब से दिए गए चरणों का पालन करें जिसे आपको इस्तेमाल करना है. ध्यान दें कि अगले सेक्शन में दिए गए निर्देशों को पूरा करने के बाद, आपके Firebase Dynamic Links कस्टम डोमेन पर डीप लिंकिंग की सुविधा हटा दी जाएगी. ईमेल लिंक बनाने के लिए, सिर्फ़ डोमेन ही बचा रहेगा.

1. अपने Android ऐप्लिकेशन को, आपके Firebase Hosting लिंक को मैनेज करने के लिए कॉन्फ़िगर करना

   1. अपने Android ऐप्लिकेशन से इन लिंक को मैनेज करने के लिए, अपने ऐप्लिकेशन का पैकेज नेम, Firebase कंसोल प्रोजेक्ट सेटिंग में बताना होगा. इसके अलावा, ऐप्लिकेशन के सर्टिफ़िकेट का SHA-1 और SHA-256 भी देना होगा.

   2. अगर आपको इन Firebase Hosting लिंक को किसी खास गतिविधि पर रीडायरेक्ट करना है, तो आपको अपनी AndroidManifest.xml फ़ाइल में, इंटेंट फ़िल्टर कॉन्फ़िगर करना होगा. इंटेंट फ़िल्टर को, आपके डोमेन के Firebase Hosting लिंक को कैप्चर करना चाहिए. AndroidManifest.xml में:

      <intent-filter android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.BROWSABLE" />
        <category android:name="android.intent.category.DEFAULT" />
        <data
          android:scheme="https"
          android:host="PROJECT_ID.firebaseapp.com or a custom hosting domain"
          android:pathPrefix="/__/auth/links" />
      </intent-filter>
      

   जब उपयोगकर्ता, "/__/auth/links" पाथ और आपके बताए गए स्कीम और होस्ट के साथ कोई होस्टिंग लिंक खोलेंगे, तो आपका ऐप्लिकेशन, लिंक को मैनेज करने के लिए इस इंटेंट फ़िल्टर के साथ गतिविधि शुरू करेगा.

   अहम जानकारी: रोलबैक को आसानी से पूरा करने के लिए, हमारा सुझाव है कि Firebase Hosting लिंक वाले समाधान को आज़माते समय, Firebase Dynamic Links को मैनेज करने वाले अपने मौजूदा इंटेंट फ़िल्टर को बनाए रखें. Firebase Dynamic Links समाधान, 25 अगस्त, 2025 तक उपलब्ध रहेगा.

2. नए लिंक का इस्तेमाल करने के लिए, अपने प्रोजेक्ट को कॉन्फ़िगर करना

   जब नए डोमेन के लिंक को मैनेज करने के लिए तैयार हों, तब Firebase Admin SDK का इस्तेमाल करके, यह अपडेट करें कि आपको ईमेल लिंक कैसे जनरेट करने हैं. साथ ही, हमारे बैकएंड को निर्देश दें कि वह नए Firebase Hosting डोमेन का इस्तेमाल करके लिंक जनरेट करे.

   import { getAuth } from 'firebase-admin/auth';
   
   const updateEmailAuthDomain = async () => {
     const updateRequest = {
       mobileLinksConfig: {
         domain: 'HOSTING_DOMAIN',
       },
     };
   
     const projectConfigManager = getAuth().projectConfigManager();
   
     try {
       const response = await projectConfigManager.updateProjectConfig(updateRequest);
       // Updated project config
       console.log('Project configuration updated successfully:', response);
     } catch (error) {
       console.error('Error updating the project:', error);
     }
   };
   

   अहम जानकारी: बैकअप समाधान को लागू करने और उसकी जांच करने के दौरान, Firebase Dynamic Links पर रोलबैक करने के लिए, आपको डोमेन को वापस FIREBASE_DYNAMIC_LINK पर सेट करना चाहिए. Firebase Dynamic Links समाधान, 25 अगस्त, 2025 तक उपलब्ध रहेगा.

3. ईमेल लिंक भेजना और उसे रिडीम करना

   साइन-इन करने के लिए, ईमेल लिंक को पहले की तरह भेजें. जब असली उपयोगकर्ता लिंक पर क्लिक करेगा, तो उसे ऐप्लिकेशन पर रीडायरेक्ट कर दिया जाएगा. हालांकि, ऐसा तब होगा, जब ऐप्लिकेशन इंस्टॉल हो. इसके बाद, वह साइन-इन की प्रोसेस पूरी कर पाएगा.

मोबाइल लिंक को पसंद के मुताबिक बनाना

आपके पास कस्टम Firebase Hosting डोमेन का इस्तेमाल करने या कस्टम Firebase Dynamic Links डोमेन को फिर से इस्तेमाल करने का विकल्प होता है. ऐसा करके, उसे अपने नए मोबाइल लिंक के डोमेन के तौर पर इस्तेमाल किया जा सकता है.

कस्टम Firebase Hosting डोमेन का इस्तेमाल करना

1. कस्टम डोमेन सेट अप करने के लिए, Firebase Hosting गाइड में दिए गए निर्देशों का पालन करें.
2. अपने Android ऐप्लिकेशन को, आपके Firebase Hosting लिंक को मैनेज करने के लिए कॉन्फ़िगर करें. (ऊपर दिए गए पिछले सेक्शन में दिए गए निर्देश).
3. उपयोगकर्ता के ईमेल पते पर, पुष्टि करने का लिंक भेजें. इसके लिए, ActionCodeSettings ऑब्जेक्ट को अपडेट करें. इसमें, कस्टम डोमेन को linkDomain के तौर पर शामिल करें.

कस्टम Firebase Dynamic Links डोमेन को फिर से इस्तेमाल करना

1. आपके पास Firebase Dynamic Links के किसी भी डोमेन को, कस्टम डोमेन के तौर पर फिर से इस्तेमाल करने का विकल्प होता है. हालांकि, Firebase Dynamic Links की किसी भी सुविधा के लिए अब सहायता नहीं मिलेगी. उदाहरण के लिए, अगर उपयोगकर्ता के डिवाइस पर ऐप्लिकेशन इंस्टॉल नहीं है, तो उसे ऐप्लिकेशन स्टोर पर रीडायरेक्ट नहीं किया जा सकता.
2. अपने Android ऐप्लिकेशन को, आपके Firebase Hosting लिंक को मैनेज करने के लिए कॉन्फ़िगर करें (ऊपर दिए गए पिछले सेक्शन में दिए गए निर्देश).
3. उपयोगकर्ता के ईमेल पते पर, पुष्टि करने का लिंक भेजें. इसके लिए, ActionCodeSettings ऑब्जेक्ट को अपडेट करें. इसमें, कस्टम डोमेन को linkDomain के तौर पर शामिल करें.