Android पर Firebase डाइनैमिक लिंक पाना

आपने जो Firebase Dynamic Links बनाया है उसे पाने के लिए, आपको अपने ऐप्लिकेशन में Dynamic Links SDK टूल शामिल करना होगा. साथ ही, Dynamic Link में पास किया गया डेटा पाने के लिए, ऐप्लिकेशन लोड होने पर FirebaseDynamicLinks.getDynamicLink() तरीके को कॉल करना होगा.

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

    अपना ऐप्लिकेशन रजिस्टर करते समय, SHA-1 साइनिंग पासकोड डालें. अगर आपने ऐप्लिकेशन लिंक का इस्तेमाल किया है, तो अपनी SHA-256 पासकोड भी डालें.

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

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

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.6.0"))

    // Add the dependencies for the Dynamic Links and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-dynamic-links'
    implementation 'com.google.firebase:firebase-analytics'
}

    Firebase Android BoM का इस्तेमाल करने पर, आपका ऐप्लिकेशन हमेशा Firebase की Android लाइब्रेरी के काम करने वाले वर्शन का इस्तेमाल करेगा.

    (विकल्प)  BoM का इस्तेमाल किए बिना, Firebase लाइब्रेरी की डिपेंडेंसी जोड़ें

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

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

    dependencies {
    // Add the dependencies for the Dynamic Links and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-dynamic-links:22.1.0'
    implementation 'com.google.firebase:firebase-analytics:22.1.2'
}
    क्या आपको Kotlin के लिए कोई लाइब्रेरी मॉड्यूल चाहिए? अक्टूबर 2023 (Firebase BoM 32.5.0) से, Kotlin और Java, दोनों डेवलपर मुख्य लाइब्रेरी मॉड्यूल का इस्तेमाल कर सकते हैं. ज़्यादा जानकारी के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले सवाल देखें.
  3. Firebase कंसोल में, Dynamic Links सेक्शन खोलें. अगर आपसे सेवा की शर्तें स्वीकार करने के लिए कहा जाए, तो उन्हें स्वीकार करें.

सामान्य डीप लिंक की तरह ही, आपको उस गतिविधि में एक नया इंटेंट फ़िल्टर जोड़ना होगा जो आपके ऐप्लिकेशन के लिए डीप लिंक मैनेज करती है. इंटेंट फ़िल्टर को आपके डोमेन के डीप लिंक को पकड़ना चाहिए, क्योंकि अगर आपका ऐप्लिकेशन इंस्टॉल है, तो Dynamic Link आपके डोमेन पर रीडायरेक्ट करेगा. यह ज़रूरी है, ताकि आपका ऐप्लिकेशन, Play Store से इंस्टॉल/अपडेट होने के बाद, Dynamic Link डेटा पा सके. इसके लिए, उपयोगकर्ता को 'जारी रखें' बटन पर टैप करना होगा. AndroidManifest.xml में:

<intent-filter>
    <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.com"
        android:scheme="https"/>
</intent-filter>
AndroidManifest.xml

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

डीप लिंक पाने के लिए, getDynamicLink() तरीके को कॉल करें:

Kotlin+KTX

Firebase.dynamicLinks
    .getDynamicLink(intent)
    .addOnSuccessListener(this) { pendingDynamicLinkData: PendingDynamicLinkData? ->
        // Get deep link from result (may be null if no link is found)
        var deepLink: Uri? = null
        if (pendingDynamicLinkData != null) {
            deepLink = pendingDynamicLinkData.link
        }

        // Handle the deep link. For example, open the linked
        // content, or apply promotional credit to the user's
        // account.
        // ...
    }
    .addOnFailureListener(this) { e -> Log.w(TAG, "getDynamicLink:onFailure", e) }
MainActivity.kt

Java

FirebaseDynamicLinks.getInstance()
        .getDynamicLink(getIntent())
        .addOnSuccessListener(this, new OnSuccessListener<PendingDynamicLinkData>() {
            @Override
            public void onSuccess(PendingDynamicLinkData pendingDynamicLinkData) {
                // Get deep link from result (may be null if no link is found)
                Uri deepLink = null;
                if (pendingDynamicLinkData != null) {
                    deepLink = pendingDynamicLinkData.getLink();
                }


                // Handle the deep link. For example, open the linked
                // content, or apply promotional credit to the user's
                // account.
                // ...

                // ...
            }
        })
        .addOnFailureListener(this, new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                Log.w(TAG, "getDynamicLink:onFailure", e);
            }
        });

आपको हर उस गतिविधि में getDynamicLink() को कॉल करना होगा जिसे लिंक से लॉन्च किया जा सकता है. भले ही, लिंक getIntent().getData() का इस्तेमाल करके इंटेंट से उपलब्ध हो. getDynamicLink() को कॉल करने पर, लिंक वापस मिल जाता है और उस डेटा को मिटा दिया जाता है, ताकि आपका ऐप्लिकेशन उसे सिर्फ़ एक बार प्रोसेस कर सके.

आम तौर पर, getDynamicLink() को मुख्य गतिविधि में कॉल किया जाता है. साथ ही, लिंक से मैच करने वाले इंटेंट फ़िल्टर से शुरू की गई सभी गतिविधियों में भी कॉल किया जाता है.

आंकड़े रिकॉर्ड करना

यहां दिए गए इवेंट, Google Analytics में अपने-आप ट्रैक हो सकते हैं और Firebase कंसोल में दिखाए जा सकते हैं.

  • dynamic_link_app_open
  • dynamic_link_first_open
  • dynamic_link_app_update

इन इवेंट को रजिस्टर करने के लिए, आपको डीप लिंक को फिर से पाने से पहले Google Analytics को कॉन्फ़िगर करना होगा. यह देखें कि ये शर्तें पूरी हों:

  • अपने ऐप्लिकेशन के एंट्री पॉइंट में FirebaseDynamicLinks.getDynamicLink() को कॉल करें:
    • लॉन्चर से की गई गतिविधियां. उदाहरण के लिए: action="android.intent.action.MAIN", category="android.intent.category.LAUNCHER".
    • गतिविधि के एंट्री पॉइंट. उदाहरण के लिए: onStart(), onCreate().
    • डीप लिंक गतिविधियां.
  • Google Analytics को सेट अप और इस्तेमाल करने के लिए:
    • Google Analytics डिपेंडेंसी शामिल करें. आम तौर पर, यह google-services Gradle प्लग इन की मदद से अपने-आप जुड़ जाता है.
    • अपने ऐप्लिकेशन में google-services.json कॉन्फ़िगरेशन फ़ाइल शामिल करें.
    • FirebaseDynamicLinks.getDynamicLink() को कॉल करने से पहले, FirebaseAnalytics.getInstance() को कॉल करें.

Android 6.0 (एपीआई लेवल 23) और उसके बाद के वर्शन पर, Dynamic Links को मैनेज करने के लिए अपने ऐप्लिकेशन को सेट अप किया जा सकता है. ऐसा तब किया जा सकता है, जब आपका ऐप्लिकेशन पहले से इंस्टॉल हो और आपने Android ऐप्लिकेशन के लिंक का इस्तेमाल किया हो.

पक्का करें कि आपने Firebase कंसोल में, अपने प्रोजेक्ट में अपने ऐप्लिकेशन के लिए SHA256 सर्टिफ़िकेट फ़िंगरप्रिंट जोड़ा हो. Dynamic Links, आपके Dynamic Links डोमेन के लिए, ऐप्लिकेशन लिंक की वेबसाइट असोसिएशन सेट अप करेगा.

Dynamic Link को मैनेज करने वाली गतिविधि में, अपने-आप पुष्टि होने वाला इंटेंट फ़िल्टर जोड़ें. इसके लिए, Firebase कंसोल में मौजूद डोमेन के तौर पर, अपने प्रोजेक्ट के Dynamic Links डोमेन को होस्ट के तौर पर सेट करें. AndroidManifest.xml में:

<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.com/link" android:scheme="http"/>
    <data android:host="example.com/link" android:scheme="https"/>
</intent-filter>

ध्यान दें कि android:host को आपके Dynamic Links डोमेन पर सेट किया जाना चाहिए, न कि आपके डीप लिंक के डोमेन पर.

ऐप्लिकेशन लिंक के काम करने के लिए, आपके मेनिफ़ेस्ट में मौजूद सभी autoVerify इंटेंट फ़िल्टर रजिस्टर होने चाहिए. Firebase, आपके Dynamic Links डोमेन के लिए इसे अपने-आप मैनेज करता है. हालांकि, आपके पास इसे देखने का विकल्प है. इसके लिए, अपने Dynamic Links डोमेन पर होस्ट की गई assetlinks.json फ़ाइल खोलें: 

https://YOUR_DOMAIN/.well-known/assetlinks.json
आपके सभी Firebase ऐप्लिकेशन के पैकेज के नाम शामिल होने चाहिए.

Dynamic Links अब सीधे आपके ऐप्लिकेशन पर भेजा जाएगा. आपके पास डीप लिंक और Dynamic Link का अन्य डेटा पाने का विकल्प होगा. इसके लिए, आपको उस गतिविधि में getDynamicLink() को कॉल करना होगा जिसमें आपने ऐप्लिकेशन लिंक के लिए इंटेंट फ़िल्टर जोड़ा है. इस बारे में ज़्यादा जानकारी के लिए, डीप लिंक मैनेज करना लेख पढ़ें.

ध्यान दें: ऐप्लिकेशन लिंक के ज़रिए ऐप्लिकेशन को खोलने पर, उपयोगकर्ता सीधे ऐप्लिकेशन पर पहुंच जाता है. इसलिए, डाइनैमिक लिंक में, ऐप्लिकेशन के लिए ज़रूरी कम से कम वर्शन का इस्तेमाल नहीं किया जा सकता. इसलिए, ऐप्लिकेशन खुलने के बाद, आपको डाइनैमिक लिंक के कम से कम वर्शन ( getminimumappversion) की तुलना PackageInfo.versionCode से करनी होगी. साथ ही, ज़रूरत पड़ने पर getUpdateAppIntent का इस्तेमाल करके, उपयोगकर्ता को ऐप्लिकेशन अपग्रेड करने के लिए रीडायरेक्ट करना होगा.