डाइनैमिक लिंक से ऐप्लिकेशन लिंक और यूनिवर्सल लिंक पर माइग्रेट करना

माइग्रेट करने से जुड़ी इस गाइड में, ऐप्लिकेशन लिंक और यूनिवर्सल लिंक इस्तेमाल करने के बारे में बताया गया है. साथ ही, ऐप्लिकेशन-साइट असोसिएशन फ़ाइलों को होस्ट करने के लिए, Firebase होस्टिंग का इस्तेमाल करने के बारे में भी बताया गया है. हालांकि, Firebase होस्टिंग का इस्तेमाल करना ज़रूरी नहीं है.

इस माइग्रेशन से, Firebase डाइनैमिक लिंक की ये सुविधाएं बदल जाती हैं:

सुविधा Firebase डाइनैमिक लिंक ऐप्लिकेशन लिंक / यूनिवर्सल लिंक
एक ही लिंक पर क्लिक करके, उपयोगकर्ताओं को उनके डिवाइस के हिसाब से सही स्टोर पर ले जाएं ★
डीप लिंकिंग बाकी है सुविधा का इस्तेमाल करके, उपयोगकर्ताओं को आपका ऐप्लिकेशन डाउनलोड और इंस्टॉल करने के बाद भी, उनकी यात्रा जारी रखने की सुविधा दें ★
अपने ऐप्लिकेशन में डीप-लिंक किए गए कॉन्टेंट का इस्तेमाल करके, उपयोगकर्ताओं को काम का अनुभव दें. ऐसा तब करें, जब ऐप्लिकेशन पहले से इंस्टॉल हो
डाइनैमिक लिंक पर क्लिक करने से जुड़े इवेंट का Analytics डेटा उपलब्ध कराना
छोटे लिंक वाले यूआरएल बनाने की सुविधा देना

अगर आपको माइग्रेशन के लिए, Firebase डाइनैमिक लिंक की अन्य सुविधाओं की ज़रूरत है, जो इस गाइड में नहीं बताई गई हैं, तो डाइनैमिक लिंक बंद होने के बारे में अक्सर पूछे जाने वाले सवाल दस्तावेज़ में माइग्रेशन के अन्य तरीके देखें.

मान लें कि आपके पास Firebase डाइनैमिक लिंक है, जो इस तरह दिखता है:

डाइनैमिक लिंक का उदाहरण
लिंक का नाम Example.com में आपका स्वागत है
डीप लिंक https://example.web.app/welcome
Android ऐप्लिकेशन com.example.android
Apple ऐप्लिकेशन com.example.ios
लंबा डाइनैमिक लिंक https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos
छोटा डाइनैमिक लिंक https://example.page.link/m9Mm

माइग्रेट करने से जुड़ी इस गाइड का मकसद, Firebase डाइनैमिक लिंक को इस तरह से बदलना है:

https://example.page.link/m9Mm

ऐप्लिकेशन लिंक / यूनिवर्सल लिंक वाले डीप लिंक के साथ, जो इस तरह दिखते हैं:

https://your-project-domain.web.app/welcome

ध्यान दें कि ऐप्लिकेशन लिंक / यूनिवर्सल लिंक डीप लिंक, आपके उपयोगकर्ताओं को ये सुविधाएं देगा:

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

हालांकि, ऐप्लिकेशन लिंक / यूनिवर्सल लिंक डीप लिंक, आपके उपयोगकर्ताओं को ये सुविधाएं नहीं देंगे (जो Firebase डाइनैमिक लिंक पहले देते थे):

  • उपयोगकर्ताओं को उनके डिवाइस के हिसाब से सही स्टोर पर ले जाना, ताकि वे आपका ऐप्लिकेशन डाउनलोड और इंस्टॉल कर सकें
  • ऐप्लिकेशन को डाउनलोड, इंस्टॉल, और पहली बार खोलने के बाद, उपयोगकर्ता को उसकी गतिविधि जारी रखने की सुविधा देना

ऊपर दी गई टेबल में, Firebase डाइनैमिक लिंक की तुलना में, इन ऐप्लिकेशन लिंक / यूनिवर्सल लिंक के काम करने के तरीके और सुविधाओं में अंतर बताया गया है.

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

Firebase डाइनैमिक लिंक, अपने बुनियादी सेटअप में Android पर ऐप्लिकेशन लिंक और iOS पर यूनिवर्सल लिंक का इस्तेमाल करता है. इससे, ऐप्लिकेशन इंस्टॉल होने के बाद डीप-लिंकिंग की सुविधा मिलती है.

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

माइग्रेशन की प्रोसेस पूरी करने के लिए, आपको यह जानकारी देनी होगी:

  • वे Firebase डाइनैमिक लिंक जिन्हें आपको माइग्रेट करना है
  • आपके डाइनैमिक लिंक में शामिल डीप-लिंक यूआरएल पैरामीटर
  • वह डोमेन जिसका इस्तेमाल आपको Firebase डाइनैमिक लिंक के पिछले डोमेन को बदलने के लिए करना है (अगर लागू हो)

अपने मौजूदा लिंक मेटाडेटा को एक्सपोर्ट करने और ऊपर दी गई जानकारी पाने के लिए, डाइनैमिक लिंक मेटाडेटा एक्सपोर्ट करने की गाइड का इस्तेमाल किया जा सकता है.

माइग्रेशन के चरणों की खास जानकारी

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

  2. अपने होस्टिंग डोमेन पर, ऐप्लिकेशन लिंक / यूनिवर्सल लिंक की कॉन्फ़िगरेशन फ़ाइलें बनाएं और होस्ट करें.

  3. अपने Firebase डाइनैमिक लिंक में इस्तेमाल किए गए डीप-लिंक स्कीमा से मैच करने वाले नए ऐप्लिकेशन लिंक / यूनिवर्सल लिंक बनाएं.

  4. डीप-लिंक पाने के लिए, अपने Android / iOS ऐप्लिकेशन और ऐप्लिकेशन कोड को अपडेट करें.

  5. ऐप्लिकेशन लिंक / यूनिवर्सल लिंक इंटिग्रेशन की जांच करना.

  6. पब्लिश या शेयर किए गए Firebase डाइनैमिक लिंक को ऐप्लिकेशन लिंक और यूनिवर्सल लिंक से बदलें.

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

कोई डोमेन चुनना

सबसे पहले, वह डोमेन चुनें जिसका इस्तेमाल आपको ऐप्लिकेशन लिंक / यूनिवर्सल लिंक के लिए करना है. यह वह डोमेन होगा जिसका इस्तेमाल उन नए लिंक के लिए किया जाएगा जिन्हें आपको अपने उपयोगकर्ताओं के साथ शेयर करना है.

Firebase Hosting का इस्तेमाल करने पर, your-project-domain.web.app या your-project-domain.firebaseapp.com फ़ॉर्मैट वाले प्रोजेक्ट सबडोमेन बिना किसी शुल्क के अपने-आप उपलब्ध हो जाते हैं. आपके पास Firebase होस्टिंग के साथ या उसके बिना, कस्टम डोमेन का इस्तेमाल करने का विकल्प भी होता है. इससे, ऐप्लिकेशन लिंक / यूनिवर्सल लिंक की कॉन्फ़िगरेशन फ़ाइलों को भी होस्ट किया जा सकता है.

Firebase होस्टिंग सेट अप करना

इसके बाद, आपको Firebase होस्टिंग इंस्टेंस को सेट अप और कॉन्फ़िगर करना होगा.

Firebase होस्टिंग इंस्टेंस सेट अप करने के बाद, आपके पास your-project-domain.web.app जैसा डोमेन होगा. इसके अलावा, अगर आपको पसंद हो, तो आपके पास कस्टम डोमेन भी हो सकता है.

ऐप्लिकेशन लिंक इस्तेमाल करने के लिए, आपको एक कॉन्फ़िगरेशन फ़ाइल होस्ट करनी होगी. इससे आपके लिंक में इस्तेमाल किए गए डोमेन और आपके ऐप्लिकेशन के बीच सुरक्षित कनेक्शन बनाने में मदद मिलती है. ऐप्लिकेशन लिंक के लिए, यह assetlinks.json फ़ाइल होती है.

assetlinks.json फ़ाइल बनाने और उसे होस्ट करने का तरीका

assetlinks.json फ़ाइल की मदद से, हम उन ऐप्लिकेशन की सूची उपलब्ध करा सकते हैं जिन्हें अनुमति मिली हुई है. ये ऐप्लिकेशन, उस वेब डोमेन के कॉन्टेंट को मैनेज कर सकते हैं जिसका इस्तेमाल हम अपने ऐप्लिकेशन के लिंक के लिए करेंगे. assetlinks.json फ़ाइल को वेब डोमेन के रूट में, इस पाथ के तहत होस्ट करना होगा: /.well-known.

इस कॉन्फ़िगरेशन को पूरा करने के लिए, यहां दिया गया तरीका अपनाएं:

  1. Firebase होस्टिंग की रूट डायरेक्ट्री में, सार्वजनिक फ़ोल्डर के अंदर .well-known फ़ोल्डर बनाएं.

  2. .well-known फ़ोल्डर में assetlinks.json नाम की एक फ़ाइल बनाएं.

  3. यहां दिए गए कॉन्टेंट को अपनी assetlinks.json फ़ाइल में कॉपी करें. साथ ही, यहां दिए गए हर फ़ील्ड का मतलब ध्यान से समझें:

    [{
      "relation": ["delegate_permission/common.handle_all_urls"],
      "target": {
        "namespace": "android_app",
        "package_name": "com.example.android",
        "sha256_cert_fingerprints":
          ["01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF:01:23:45:67:89:AB:CD:EF"]
      }
    }]
    
    • namespace - उस ऐप्लिकेशन का नाम जिसे आपको उपलब्ध कराना है
    • package_name - यह ऐप्लिकेशन की build.gradle फ़ाइल में बताए गए applicationId को दिखाता है
    • sha256_cert_fingerprints - यह उस कीस्टोर फ़ाइल का SHA256 फ़िंगरप्रिंट होता है जिसका इस्तेमाल, ऐप्लिकेशन पर हस्ताक्षर करने के लिए किया जाता है.

    Android Studio में इस्तेमाल की जाने वाली debug.keystore फ़ाइल का इस्तेमाल करके, डीबग करने के लिए sha256_cert_fingerprints रिकॉर्ड जनरेट किया जा सकता है. आपको यह फ़ाइल Mac और Linux पर /Users/<username>/.android/debug.keystore और Windows पर C:\Users\<username>\.android\debug.keystore में मिलेगी.

    इस कीस्टोर से, keytool का इस्तेमाल करके SHA256 वैल्यू फ़ेच की जा सकती है.

    इस चरण को पूरा करने के बारे में ज़्यादा निर्देश पाने के लिए, ऐप्लिकेशन लिंक के दस्तावेज़ का यह सेक्शन देखें.

    इसके अलावा, Android Studio में ऐप्लिकेशन लिंक असिस्टेंट का इस्तेमाल करके भी assetlinks.json फ़ाइल का कॉन्टेंट जनरेट किया जा सकता है. साथ ही, ऐप्लिकेशन लिंक मैनेज करने के लिए, अपने ऐप्लिकेशन को कॉन्फ़िगर किया जा सकता है.

  4. होस्टिंग के लिए फ़ाइल को इंडेक्स करने के लिए, अपनी firebase.json फ़ाइल को अपडेट करें.

    "headers": [
      {
        "source": "/.well-known/assetlinks.json",
        "headers": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ]
      }
    ]
    
  5. अब हमारे पास assetlinks.json फ़ाइल मौजूद है. बदलावों को होस्ट करने के लिए, firebase deploy चलाएं.

    ध्यान दें कि ऊपर दिए गए डिप्लॉय कमांड को चलाने के लिए, आपके पास Firebase CLI इंस्टॉल होना चाहिए.

    firebase deploy --only hosting
    
  6. https://your-project-domain.web.app/.well-known/assetlinks.json पर जाकर, assetlinks.json फ़ाइल की पुष्टि करें

इस चरण में, Firebase डाइनैमिक लिंक से डीप-लिंक फिर से बनाए जाएंगे. इसके लिए, सामान्य डीप-लिंक यूआरएल का इस्तेमाल किया जाएगा. ये यूआरएल, आपके ऐप्लिकेशन लिंक के लिए बनाए गए नए डोमेन से मैच होने चाहिए.

उदाहरण के लिए, मान लें कि आपके पास यह Firebase डाइनैमिक लिंक है:

डाइनैमिक लिंक का उदाहरण
लिंक का नाम Example.com में आपका स्वागत है
डीप लिंक https://example.web.app/welcome
Android ऐप्लिकेशन com.example.android
Apple ऐप्लिकेशन com.example.ios
लंबा डाइनैमिक लिंक https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos
छोटा डाइनैमिक लिंक https://example.page.link/m9Mm

इस मामले में, आपको डीप लिंक पैरामीटर को निकालना होगा - यानी कि https://example.web.app/welcome. अब इसे अपने ऐप्लिकेशन के लिए, ऐप्लिकेशन लिंक पैरामीटर के तौर पर इस्तेमाल किया जाएगा.

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

उदाहरण के लिए, Firebase डाइनैमिक लिंक के शॉर्ट-लिंक, डीप लिंक पैरामीटर, और माइग्रेट किए गए डीप लिंक की वैल्यू का यह सेट देखें:

शॉर्ट लिंक डीप लिंक पैरामीटर माइग्रेट किया गया डीप लिंक
yourapp.page.link/welcome https://example.com/welcome yourapp.web.app/welcome
yourapp.page.link/c7sn https://example.com/main/?p=23&t=1 yourapp.web.app/main/?p=23&t=1
yourapp.page.link/social https://example.com/friendinvite/?add=1 yourapp.web.app/friendinvite/?add=1

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

डोमेन चुनने, डीप-लिंकिंग स्कीमा चुनने, और Firebase डाइनैमिक लिंक को ऐप्लिकेशन लिंक पर माइग्रेट करने के बाद, आपको अपने Android ऐप्लिकेशन और ऐप्लिकेशन कोड को अपडेट करना होगा. इससे आपको नए डीप लिंक मिल पाएंगे.

हमारा सुझाव है कि आप ऐप्लिकेशन लिंक से जुड़ा पूरा दस्तावेज़ यहां पढ़ें या Android Studio की गाइड देखें. इससे आपको डीप लिंक मैनेज करने के लिए, अपने ऐप्लिकेशन को कॉन्फ़िगर करने में मदद मिलेगी. हालांकि, मुख्य चरणों में ये शामिल हैं:

  1. यह पहचान करना कि किन गतिविधियों को संबंधित डीप लिंक मैनेज करने चाहिए
  2. AndroidManifest.xml फ़ाइल में उन गतिविधियों के लिए इंटेंट फ़िल्टर जोड़ना
  3. अपनी गतिविधियों के ऐप्लिकेशन कोड में डीप लिंक पाना

मान लें कि आपको अपने कुछ डीप लिंक मैनेज करने के लिए, MainActivity का इस्तेमाल करना है. ऐसा करने के लिए, आपको अपनी AndroidManifest.xml फ़ाइल में MainActivity में यह इंटेंट फ़िल्टर जोड़ना होगा:

<activity android:name=".MainActivity"
   android:exported="true">
   <intent-filter>
       <action android:name="android.intent.action.MAIN" />
       <category android:name="android.intent.category.LAUNCHER" />
   </intent-filter>
   <intent-filter android:autoVerify="true">
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE" />
       <data android:host="example.web.app" android:scheme="http"
           android:pathPrefix="/welcome" />
       <data android:host="example.web.app" android:scheme="https"
           android:pathPrefix="/welcome" />
   </intent-filter>
</activity>

इस चरण में, यह बताया जा रहा है कि MainActivity, wxample.web.app डोमेन से डीप लिंक मैनेज करने का डेस्टिनेशन है. इसमें /welcome पाथ प्रीफ़िक्स भी शामिल है. ध्यान दें कि आपको android:autoVerify="true" एट्रिब्यूट भी तय करना होगा. इससे आपको अपने ऐप्लिकेशन को इस तरह के लिंक के लिए डिफ़ॉल्ट हैंडलर के तौर पर सेट करने की अनुमति मिलती है.

आखिर में, आपको डीप-लिंक डेटा को वापस पाने के लिए, अपनी MainActivity में कोड जोड़ना होगा. साथ ही, इसका इस्तेमाल करके अपने ऐप्लिकेशन में डीप लिंक का अनुभव देना होगा. यह उस लॉजिक की तरह है जिसे आपने Firebase डाइनैमिक लिंक के साथ इंटिग्रेट करते समय, अपने ऐप्लिकेशन में पहले से कोड किया हो.

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.main)

  val  data: Uri? = intent?.data

  val toast = Toast.makeText(this, data, duration)
  toast.show()
}

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

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

इसके अलावा, Android Studio में ऐप लिंक असिस्टेंट का इस्तेमाल करके भी, ऐप्लिकेशन लिंक के इंटिग्रेशन की जांच की जा सकती है. इसके अलावा, कॉन्फ़िगर किए गए ऐप्लिकेशन लिंक यूआरएल के लिए, इस निर्देश का इस्तेमाल करके यह पक्का किया जा सकता है कि वह सही ऐक्टिविटी को लॉन्च करे:

adb shell am start -a android.intent.action.VIEW -d <your_deep_link_url>

माइग्रेशन का आखिरी चरण, पब्लिश या शेयर किए गए Firebase डाइनैमिक लिंक को ऐप्लिकेशन लिंक से बदलना होगा. ऐसा वहां करें जहां भी संभव हो. साथ ही, आगे भी ऐप्लिकेशन लिंक का इस्तेमाल जारी रखें.

इस चरण को पूरा करने का तरीका इस बात पर निर्भर करेगा कि आपने Firebase डाइनैमिक लिंक कहां और कैसे पब्लिश किए हैं. हालांकि, यह ट्रैक करने के लिए कि कौनसे लिंक मौजूद हैं, अपने मौजूदा Firebase डाइनैमिक लिंक का लिंक मेटाडेटा एक्सपोर्ट किया जा सकता है. डाइनैमिक लिंक का मेटाडेटा एक्सपोर्ट करने की गाइड देखें.

यूनिवर्सल लिंक का इस्तेमाल करने के लिए, आपको एक कॉन्फ़िगरेशन फ़ाइल होस्ट करनी होगी. इससे आपके लिंक में इस्तेमाल किए गए डोमेन और आपके ऐप्लिकेशन के बीच सुरक्षित कनेक्शन बनाने में मदद मिलती है. यूनिवर्सल लिंक के लिए, यह apple-app-site-association फ़ाइल होती है. इसे एएएसए फ़ाइल भी कहा जाता है.

apple-app-site-association फ़ाइल बनाने और उसे होस्ट करने का तरीका

AASA फ़ाइल की मदद से, हमें अनुमति वाले उन ऐप्लिकेशन की सूची मिलती है जो उस वेब डोमेन के कॉन्टेंट को मैनेज कर सकते हैं जिसका इस्तेमाल हम यूनिवर्सल लिंक के लिए करेंगे. AASA फ़ाइल को वेब डोमेन के रूट में, इस पाथ के तहत होस्ट करना होगा: /.well-known.

इस कॉन्फ़िगरेशन को पूरा करने के लिए, यहां दिया गया तरीका अपनाएं:

  1. Firebase होस्टिंग की रूट डायरेक्ट्री में, सार्वजनिक फ़ोल्डर के अंदर ".well-known" फ़ोल्डर बनाएं.

  2. ".well-known" फ़ोल्डर में, "apple-app-site-association" नाम की फ़ाइल बनाएं.

  3. यहां दिए गए कॉन्टेंट को अपनी apple-app-site-association फ़ाइल में कॉपी करें. साथ ही, यहां दिए गए हर फ़ील्ड का मतलब ध्यान से समझें:

    {
      "applinks": {
        "apps": [],
        "details": [
          {
            "appID": "$TEAM_ID.com.firebase.UniversalLinks",
            "paths": [
              "NOT /_/*",
              "/*"
            ]
          }
        ]
      }
    }
    
    • $TEAM_ID.BundleId - ऐप्लिकेशन का पूरा नाम, जिसे लिंक मैनेज करने की अनुमति है
  4. होस्टिंग के लिए फ़ाइल को इंडेक्स करने के लिए, अपनी firebase.json फ़ाइल को अपडेट करें.

    "headers": [
      {
        "source": "/.well-known/apple-app-site-association",
        "headers": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ]
      }
    ]
    
  5. अब हमारे पास AASA फ़ाइल है. इसलिए, बदलावों को होस्ट करने के लिए, firebase deploy करें.

  6. https://your-project-domain.web.app/.well-known/app-app-site-association पर जाकर, AASA फ़ाइल की पुष्टि करें

इस चरण में, आपको Firebase डाइनैमिक लिंक से डीप-लिंक फिर से बनाने होंगे. इसके लिए, आपको यूनिवर्सल लिंक के लिए बनाए गए नए डोमेन से मैच करने वाले सामान्य डीप-लिंक यूआरएल का इस्तेमाल करना होगा.

उदाहरण के लिए, मान लें कि आपके पास यह Firebase डाइनैमिक लिंक है:

डाइनैमिक लिंक का उदाहरण
लिंक का नाम Example.com में आपका स्वागत है
डीप लिंक https://example.web.app/welcome
Android ऐप्लिकेशन com.example.android
Apple ऐप्लिकेशन com.example.ios
लंबा डाइनैमिक लिंक https://example.page.link/?link=https://example.web.app/welcome&apn=com.example.android&isi=123456789&ibi=com.example.iuos
छोटा डाइनैमिक लिंक https://example.page.link/m9Mm

इस मामले में, आपको डीप लिंक पैरामीटर निकालना होगा - यानी कि https://example.web.app/welcome. अब इसे अपने ऐप्लिकेशन के लिए यूनिवर्सल लिंक पैरामीटर के तौर पर इस्तेमाल किया जाएगा.

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

उदाहरण के लिए, Firebase डाइनैमिक लिंक के शॉर्ट-लिंक, डीप लिंक पैरामीटर, और माइग्रेट किए गए डीप लिंक की वैल्यू का यह सेट देखें:

शॉर्ट लिंक डीप लिंक पैरामीटर माइग्रेट किया गया डीप लिंक
yourapp.page.link/welcome https://example.com/welcome yourapp.web.app/welcome
yourapp.page.link/c7sn https://example.com/main/?p=23&t=1 yourapp.web.app/main/?p=23&t=1
yourapp.page.link/social https://example.com/friendinvite/?add=1 yourapp.web.app/friendinvite/?add=1

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

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

हमारा सुझाव है कि डीप लिंक मैनेज करने के लिए, अपने ऐप्लिकेशन को कॉन्फ़िगर करने के बारे में यूनिवर्सल लिंक का पूरा दस्तावेज़ यहां पढ़ें. हालांकि, मुख्य चरणों में ये शामिल हैं:

  1. अपने प्रोजेक्ट कॉन्फ़िगरेशन को अपडेट करें, ताकि आपका ऐप्लिकेशन नए बनाए गए डोमेन से डीप लिंक मैनेज कर सके

  2. अपने ऐप्लिकेशन कोड में डीप लिंक पाना

अपने प्रोजेक्ट कॉन्फ़िगरेशन को अपडेट करने के लिए, ताकि आपका ऐप्लिकेशन डीप लिंक को हैंडल कर सके, आपको xCode में अपने प्रोजेक्ट में एक और असोसिएटेड डोमेन जोड़ना होगा. यह डोमेन उस डोमेन के लिए होना चाहिए जिसका इस्तेमाल अब आपको अपनी apple-app-site-associate फ़ाइल को होस्ट करने के लिए करना है.

ऐसा करने के लिए:

  1. Xcode खोला जा रहा है
  2. फ़ाइल नेविगेटर में अपना प्रोजेक्ट चुनना
  3. प्रोजेक्ट की सेटिंग में जाकर, Signing & Capabilities टैब पर जाना
  4. नीचे की ओर स्क्रोल करके, 'जुड़े हुए डोमेन' सेक्शन पर जाएं
  5. + बटन पर क्लिक करके, अपने प्रोजेक्ट में "applinks:" फ़ॉर्मैट में अतिरिक्त डोमेन जोड़ें.

आखिर में, आपको अपने ऐप्लिकेशन कोड को अपडेट करना होगा, ताकि आने वाले डीप लिंक को रिसीव किया जा सके.

इसके लिए, सबसे पहले AppDelegate.swift फ़ाइल को अपडेट करें, ताकि वह यूनिवर्सल लिंक पर रिस्पॉन्स दे सके. इसके लिए, यह कोड जोड़ें:

func application(_ application: UIApplication, continue userActivity: NSUserActivity,
                 restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
  AppDelegate.showReceivedUrl(userActivity: userActivity);
  return true
}

static func showReceivedUrl(userActivity: NSUserActivity) {
  if userActivity.activityType == NSUserActivityTypeBrowsingWeb {
    let url = userActivity.webpageURL!
    print(url.absoluteString)
}

ऊपर दिया गया कोड, यूनिवर्सल लिंक के कॉलबैक के तरीके को बदल देता है. साथ ही, डीप लिंक का यूआरएल मौजूद होने पर उसे लॉग करता है.

अब हम SceneDelegate क्लास से भी उसी showReceivedUrl तरीके को कॉल करेंगे. ऐसा इसलिए, क्योंकि अगर उपयोगकर्ता के यूनिवर्सल लिंक पर क्लिक करने से पहले ही ऐप्लिकेशन खुला हुआ है, तो SceneDelegate में मौजूद यूनिवर्सल लिंक कॉलबैक को ही शुरू किया जाएगा.

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  AppDelegate.showReceivedUrl(userActivity: userActivity)
}

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

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

स्मार्ट ऐप्लिकेशन बैनर के साथ काम करना

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

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

माइग्रेशन का आखिरी चरण यह होगा कि जहां भी संभव हो, पब्लिश या शेयर किए गए Firebase डाइनैमिक लिंक को यूनिवर्सल लिंक से बदलें. साथ ही, आगे भी यूनिवर्सल लिंक का इस्तेमाल जारी रखें.

इस चरण को पूरा करने का तरीका इस बात पर निर्भर करता है कि आपने Firebase डाइनैमिक लिंक कहां और कैसे पब्लिश किए हैं.

माइग्रेट किए जाने वाले मौजूदा Firebase डाइनैमिक लिंक को ट्रैक करने में आपकी मदद करने के लिए, हम एक गाइड पब्लिश करेंगे. इसमें Firebase डाइनैमिक लिंक से शॉर्ट-लिंक का मेटा डेटा एक्सपोर्ट करने का तरीका बताया जाएगा. ज़्यादा अपडेट के लिए, कृपया डाइनैमिक लिंक बंद होने के बारे में अक्सर पूछे जाने वाले सवालों का दस्तावेज़ देखें.