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

Firebase डाइनैमिक लिंक बिल्डर एपीआई की मदद से, छोटे या लंबे डाइनैमिक लिंक बनाए जा सकते हैं. यह एपीआई लंबा डाइनैमिक लिंक या डाइनैमिक लिंक वाला ऑब्जेक्ट स्वीकार करता है पैरामीटर की मदद से सेट किया जाता है और नीचे दिए गए उदाहरणों की तरह यूआरएल दिखाता है:

https://example.com/link/WXYZ
https://example.page.link/WXYZ

Firebase और डाइनैमिक लिंक SDK टूल सेट अप करना

अपने Android ऐप्लिकेशन में डाइनैमिक लिंक बनाने से पहले, आपको Firebase SDK टूल. अगर आपका ऐप्लिकेशन डाइनैमिक लिंक पाने के लिए सेट अप किया गया है, तो आपने पहले ही ने इन चरणों को पूरा कर लिया है और आप इस सेक्शन को छोड़ सकते हैं.

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

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

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

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

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

   क्या आपको Kotlin से जुड़े लाइब्रेरी मॉड्यूल की तलाश है? इतने समय में शुरू होगा अक्टूबर 2023 (Firebase BoM 32.5.0) में, Kotlin और Java डेवलपर, दोनों मुख्य लाइब्रेरी मॉड्यूल पर निर्भर करते हैं (जानकारी के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले सवाल).
3. Firebase कंसोल में, डाइनैमिक लिंक सेक्शन खोलें.

4. अगर आपने पहले से सेवा की शर्तें स्वीकार नहीं की हैं और कोई डोमेन सेट कर लिया है आपके डाइनैमिक लिंक के लिए, प्रॉम्प्ट मिलने पर यह काम करें.

   अगर आपके पास पहले से ही डाइनैमिक लिंक डोमेन है, तो उस पर ध्यान दें. आपको ये काम करने होंगे प्रोग्राम बनाकर डाइनैमिक लिंक बनाते समय, आपको डाइनैमिक लिंक डोमेन उपलब्ध कराना चाहिए.

   

5. सुझाव: अपने डीप लिंक में इस्तेमाल किए जा सकने वाले यूआरएल पैटर्न तय करें और फ़ॉलबैक लिंक. ऐसा करके, आप अनधिकृत पक्षों को ऐसे डाइनैमिक लिंक बनाना जो आपके डोमेन से उन साइटों पर रीडायरेक्ट करते हों जिन पर आपका कंट्रोल नहीं है. खास तौर पर अनुमति दें यूआरएल पैटर्न.

Firebase कंसोल का इस्तेमाल करना

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

पैरामीटर से डाइनैमिक लिंक बनाना

डायनामिक लिंक बनाने के लिए, इसकी मदद से एक नया DynamicLink ऑब्जेक्ट बनाएं बिल्डर, जिसमें बिल्डर तरीकों के साथ डाइनैमिक लिंक पैरामीटर तय होते हैं. इसके बाद, कॉल करें buildDynamicLink या buildShortDynamicLink.

नीचे दिए गए छोटे से उदाहरण से एक लंबा डाइनैमिक लिंक बन जाता है, जो https://www.example.com/, जो Android पर आपके Android ऐप्लिकेशन के साथ खुलता है iOS पर com.example.ios ऐप्लिकेशन के लिए:

val dynamicLink = Firebase.dynamicLinks.dynamicLink {
    link = Uri.parse("https://www.example.com/")
    domainUriPrefix = "https://example.page.link"
    // Open links with this app on Android
    androidParameters { }
    // Open links with com.example.ios on iOS
    iosParameters("com.example.ios") { }
}

val dynamicLinkUri = dynamicLink.uri
MainActivity.kt

DynamicLink dynamicLink = FirebaseDynamicLinks.getInstance().createDynamicLink()
        .setLink(Uri.parse("https://www.example.com/"))
        .setDomainUriPrefix("https://example.page.link")
        // Open links with this app on Android
        .setAndroidParameters(new DynamicLink.AndroidParameters.Builder().build())
        // Open links with com.example.ios on iOS
        .setIosParameters(new DynamicLink.IosParameters.Builder("com.example.ios").build())
        .buildDynamicLink();

Uri dynamicLinkUri = dynamicLink.getUri();
MainActivity.java

छोटा डाइनैमिक लिंक बनाने के लिए, उसी तरीके से DynamicLink बनाएं और फिर buildShortDynamicLink पर कॉल करें. छोटा लिंक बनाने के लिए, नेटवर्क कॉल का अनुरोध किया है, इसलिए सीधे लिंक को लौटाने के बजाय, buildShortDynamicLink एक Task दिखाता है, जो अनुरोध पूरा होने पर यह छोटा लिंक दिखेगा. उदाहरण के लिए:

val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync {
    link = Uri.parse("https://www.example.com/")
    domainUriPrefix = "https://example.page.link"
    // Set parameters
    // ...
}.addOnSuccessListener { (shortLink, flowchartLink) ->
    // You'll need to import com.google.firebase.dynamiclinks.component1 and
    // com.google.firebase.dynamiclinks.component2

    // Short link created
    processShortLink(shortLink, flowchartLink)
}.addOnFailureListener {
    // Error
    // ...
}
MainActivity.kt

Task<ShortDynamicLink> shortLinkTask = FirebaseDynamicLinks.getInstance().createDynamicLink()
        .setLink(Uri.parse("https://www.example.com/"))
        .setDomainUriPrefix("https://example.page.link")
        // Set parameters
        // ...
        .buildShortDynamicLink()
        .addOnCompleteListener(this, new OnCompleteListener<ShortDynamicLink>() {
            @Override
            public void onComplete(@NonNull Task<ShortDynamicLink> task) {
                if (task.isSuccessful()) {
                    // Short link created
                    Uri shortLink = task.getResult().getShortLink();
                    Uri flowchartLink = task.getResult().getPreviewLink();
                } else {
                    // Error
                    // ...
                }
            }
        });
MainActivity.java

डिफ़ॉल्ट रूप से, 17 वर्णों के लिंक के सफ़िक्स के साथ छोटे डाइनैमिक लिंक जनरेट होते हैं किसी मान्य डाइनैमिक लिंक का अनुमान लगाने की संभावना को काफ़ी कम कर दें. अगर, इसके लिए कोई नुकसान नहीं होता, क्योंकि कोई व्यक्ति छोटे लिंक का सही अनुमान लगाता है, ऐसा हो सकता है कि आप ऐसे सफ़िक्स जनरेट करना पसंद करें जो सिर्फ़ तब तक ज़रूरी हों यूनीक है, जो ShortDynamicLink.Suffix.SHORT को पास करके ऐसा किया जा सकता है buildShortDynamicLink तरीके से:

val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync(ShortDynamicLink.Suffix.SHORT) {
    // Set parameters
    // ...
}
MainActivity.kt

Task<ShortDynamicLink> shortLinkTask = FirebaseDynamicLinks.getInstance().createDynamicLink()
        // ...
        .buildShortDynamicLink(ShortDynamicLink.Suffix.SHORT);
        // ...
MainActivity.java

डाइनैमिक लिंक पैरामीटर

आप डाइनैमिक लिंक बनाने के लिए, डाइनैमिक लिंक बिल्डर एपीआई का इस्तेमाल करके, इनमें से किसी भी इस्तेमाल किए जा सकने वाले पैरामीटर हैं. एपीआई का संदर्भ देखें.

नीचे दिए गए उदाहरण में कई सामान्य पैरामीटर के साथ एक डाइनैमिक लिंक बनाया गया है सेट:

val dynamicLink = Firebase.dynamicLinks.dynamicLink { // or Firebase.dynamicLinks.shortLinkAsync
    link = Uri.parse("https://www.example.com/")
    domainUriPrefix = "https://example.page.link"
    androidParameters("com.example.android") {
        minimumVersion = 125
    }
    iosParameters("com.example.ios") {
        appStoreId = "123456789"
        minimumVersion = "1.0.1"
    }
    googleAnalyticsParameters {
        source = "orkut"
        medium = "social"
        campaign = "example-promo"
    }
    itunesConnectAnalyticsParameters {
        providerToken = "123456"
        campaignToken = "example-promo"
    }
    socialMetaTagParameters {
        title = "Example of a Dynamic Link"
        description = "This link works whether the app is installed or not!"
    }
}
MainActivity.kt

DynamicLink dynamicLink = FirebaseDynamicLinks.getInstance().createDynamicLink()
        .setLink(Uri.parse("https://www.example.com/"))
        .setDomainUriPrefix("https://example.page.link")
        .setAndroidParameters(
                new DynamicLink.AndroidParameters.Builder("com.example.android")
                        .setMinimumVersion(125)
                        .build())
        .setIosParameters(
                new DynamicLink.IosParameters.Builder("com.example.ios")
                        .setAppStoreId("123456789")
                        .setMinimumVersion("1.0.1")
                        .build())
        .setGoogleAnalyticsParameters(
                new DynamicLink.GoogleAnalyticsParameters.Builder()
                        .setSource("orkut")
                        .setMedium("social")
                        .setCampaign("example-promo")
                        .build())
        .setItunesConnectAnalyticsParameters(
                new DynamicLink.ItunesConnectAnalyticsParameters.Builder()
                        .setProviderToken("123456")
                        .setCampaignToken("example-promo")
                        .build())
        .setSocialMetaTagParameters(
                new DynamicLink.SocialMetaTagParameters.Builder()
                        .setTitle("Example of a Dynamic Link")
                        .setDescription("This link works whether the app is installed or not!")
                        .build())
        .buildDynamicLink();  // Or buildShortDynamicLink()
MainActivity.java

इन तरीकों का इस्तेमाल करके, डाइनैमिक लिंक पैरामीटर को सेट किया जा सकता है:

https://example.com/link
https://example.page.link

लंबे डाइनैमिक लिंक को छोटा करना

लंबे डायनामिक लिंक को छोटा करने के लिए दूसरे बिल्डर के साथ पैरामीटर सेट करने के बजाय setLongLink तरीका:

val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync {
    longLink = Uri.parse(
        "https://example.page.link/?link=" +
            "https://www.example.com/&apn=com.example.android&ibn=com.example.ios",
    )
}.addOnSuccessListener { (shortLink, flowChartLink) ->
    // You'll need to import com.google.firebase.dynamiclinks.component1 and
    // com.google.firebase.dynamiclinks.component2

    // Short link created
    processShortLink(shortLink, flowChartLink)
}.addOnFailureListener {
    // Error
    // ...
}
MainActivity.kt

Task<ShortDynamicLink> shortLinkTask = FirebaseDynamicLinks.getInstance().createDynamicLink()
        .setLongLink(Uri.parse("https://example.page.link/?link=https://www.example.com/&apn=com.example.android&ibn=com.example.ios"))
        .buildShortDynamicLink()
        .addOnCompleteListener(this, new OnCompleteListener<ShortDynamicLink>() {
            @Override
            public void onComplete(@NonNull Task<ShortDynamicLink> task) {
                if (task.isSuccessful()) {
                    // Short link created
                    Uri shortLink = task.getResult().getShortLink();
                    Uri flowchartLink = task.getResult().getPreviewLink();
                } else {
                    // Error
                    // ...
                }
            }
        });
MainActivity.java