1.2.0 ভার্সন থেকে শুরু করে, Navigation 3, DeepLinkRequest এবং
DeepLinkMatcher ক্লাস ব্যবহার করে আপনার অ্যাপের
ডেস্টিনেশনে ডিপ লিঙ্কিং কাজ করে।
আপনার অ্যাপে ডিপ লিঙ্ক কাজ করানোর জন্য, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
- আপনার
AndroidManifest.xml-এ ইনটেন্ট ফিল্টার নির্ধারণ করুন, যাতে আপনার অ্যাপ কোন URI হ্যান্ডেল করতে পারবে তা নির্দিষ্ট করা যায়। - আপনার নেভিগেশন কী-তে ইনকামিং অনুরোধ ম্যাপ করতে,
DeepLinkMatcherইনস্ট্যান্স তৈরি করুন। - আপনার অ্যাক্টিভিটির
onCreateবাonNewIntentপদ্ধতিতে আগত অনুরোধ ম্যাচ করুন এবং সেই অনুযায়ী আপনার ব্যাক স্ট্যাক আপডেট করুন।
DeepLinkRequest তৈরি করুন
DeepLinkRequest চিহ্নটি ইনকামিং ডিপ লিঙ্ককে বোঝায়। এতে অতিরিক্ত
তথ্য সহ একটি DeepLinkUri এবং ঐচ্ছিক RequestExtras আছে, যেমন ইনটেন্ট অ্যাকশন বা MIME
টাইপ।
// Create a request with a String URI val request = DeepLinkRequest(uri = "https://www.example.com/home") // Create a request from a DeepLinkUri val deepLinkUri = DeepLinkUri("https://www.example.com/home") val requestFromUri = DeepLinkRequest(uri = deepLinkUri) // Create a request with a URI and action val requestWithAction = DeepLinkRequest( uri = "https://www.example.com/home", extras = DeepLinkRequest.actionExtra("android.intent.action.VIEW") ) // Create a request with URI, action and mimeType val requestWithMimeType = DeepLinkRequest( uri = "https://www.example.com/image", extras = requestExtras { put(DeepLinkRequest.ActionExtrasKey, "android.intent.action.VIEW") put(DeepLinkRequest.Companion.MimeTypeExtrasKey, "image/png") } )
DeepLinkRequest অতিরিক্ত তথ্য দিন
ডিপ লিঙ্ক সম্পর্কিত অতিরিক্ত তথ্য স্টোর করতে, RequestExtras ক্লাস ব্যবহার করুন। এক্সট্রা টাইপ-সেফকে ডিফাইন ও ইনস্ট্যানশিয়েট করতে,
লাইব্রেরি RequestExtrasKey ইন্টারফেস ও
requestExtras DSL প্রদান করে।
এছাড়াও, লাইব্রেরি দুটি অতিরিক্ত কী ও সংশ্লিষ্ট হেল্পার প্রদান করে:
MimeTypeExtrasKey: MIME-এর ধরনStringসেভ করতে ব্যবহৃত হয়।ActionExtrasKey(শুধুমাত্র Android-এর জন্য):Intent-এর অ্যাকশনStringসেভ করতে ব্যবহার করা হয়।
val extras: RequestExtras = requestExtras { put(DeepLinkRequest.Companion.MimeTypeExtrasKey, "application/json") put(DeepLinkRequest.ActionExtrasKey, Intent.ACTION_VIEW) } // Access typed values using the get operator val mimeType: String? = extras[DeepLinkRequest.Companion.MimeTypeExtrasKey] val action: String? = extras[DeepLinkRequest.ActionExtrasKey] // Create extras using helper functions and combine them val mimeTypeExtras: RequestExtras = DeepLinkRequest.mimeTypeExtra("application/json") val combinedExtras: RequestExtras = extras + DeepLinkRequest.actionExtra(Intent.ACTION_VIEW)
আপনার নিজস্ব কাস্টম এক্সট্রা ডিফাইন করতে, টাইপ করা জেনেরিক সহ RequestExtrasKey
ইন্টারফেস প্রয়োগ করুন:
// Define a custom typed key: object CampaignIdExtrasKey : RequestExtrasKey<String> val customExtras: RequestExtras = requestExtras { put(CampaignIdExtrasKey, "123") } val campaignId: String? = customExtras[CampaignIdExtrasKey]
এছাড়াও, আপনি খালি ইনস্ট্যান্স তৈরি করতে emptyRequestExtras() ব্যবহার করতে পারেন অথবা
+ (plus) ও - (minus) অপারেটর ব্যবহার করে এক্সট্রা একত্রিত করতে পারেন।
Intent থেকে DeepLinkRequest তৈরি করা
Android-এ, আপনি Intent থেকে সরাসরি DeepLinkRequest তৈরি করতে পারবেন। এইভাবে তৈরি করা হলে, DeepLinkRequest এইভাবে তৈরি হয়:
uriটি ইনটেন্টেরdataফিল্ড থেকে কপি করা হয়েছে।- নাল না হলে, সংশ্লিষ্ট ইনটেন্ট ফিল্ড থেকে MIME-এর ধরন ও অ্যাকশন এক্সট্রা সেট করা হয়।
- নন-নাল ভ্যালু সহ সব
intent.extrasDeepLinkRequest.IntentExtrasKey-এSavedStateহিসেবে সেভ করা হয়। extrasপ্যারামিটার ব্যবহার করে প্রদান করা যেকোনও অতিরিক্ত এক্সট্রা যোগ করা হয়।
object CampaignIdExtrasKey : RequestExtrasKey<String> val intent = Intent(Intent.ACTION_VIEW).apply { data = Uri.parse("https://www.example.com/item/42") type = "application/json" putExtra("user_id", "123") } val request = DeepLinkRequest( intent = intent, extras = requestExtras { put(CampaignIdExtrasKey, "spring_promo") } ) // The resulting DeepLinkRequest contains: val uri = request.uri // "https://www.example.com/item/42" val action = request.extras[DeepLinkRequest.ActionExtrasKey] // "android.intent.action.VIEW" val mimeType = request.extras[DeepLinkRequest.Companion.MimeTypeExtrasKey] // "application/json" val intentExtras: SavedState? = request.extras[DeepLinkRequest.IntentExtrasKey] val userId: String? = intentExtras?.read { getStringOrNull("user_id") } // "123" val campaignId: String? = request.extras[CampaignIdExtrasKey] // "spring_promo"
DeepLinkMatcher ইনস্ট্যান্স তৈরি করুন
DeepLinkMatcher ইনকামিং DeepLinkRequest ইনস্ট্যান্সকে
নেভিগেশন কী-তে ম্যাপ করে যা আপনার অ্যাপের ব্যাক স্ট্যাকে যোগ করা যেতে পারে। নেভিগেশন ৩
তিনটি বিল্ট-ইন ম্যাচিং প্রদান করে: UriDeepLinkMatcher প্যাটার্ন-ভিত্তিক URI ম্যাচিংয়ের
জন্য, StaticKeyDeepLinkMatcher সাধারণ লিঙ্কের জন্য এবং
BackStackMatcher সিন্থেটিক ব্যাক স্ট্যাক তৈরি করার জন্য। এছাড়াও, লাইব্রেরি বিল্ট-ইন
ম্যাচার দ্বারা কভার করা হয়নি এমন ব্যবহারের ক্ষেত্রে কাস্টম ম্যাচিং
সাপোর্ট করে।
আরও তথ্যের জন্য, DeepLinkMatchers তৈরি করুন দেখুন।
ইনটেন্ট ফিল্টার যোগ করা
আপনার অ্যাক্টিভিটি শুরু করার জন্য ডিপ লিঙ্ক চালু করতে, আপনার অ্যাপের AndroidManifest.xml-এ আপনাকে অবশ্যই ম্যাচ করা
<intent-filter> এলিমেন্ট নির্ধারণ করতে হবে। আরও
তথ্যের জন্য, ইনকামিং লিঙ্কের জন্য ইনটেন্ট ফিল্টার যোগ করুন দেখুন।
ইনকামিং অনুরোধ ম্যাচ করা
আপনার DeepLinkMatcher ইনস্ট্যান্স তৈরি করার পরে, আপনার অ্যাক্টিভিটিতে
আগত অনুরোধ ম্যাচ করতে পারবেন।
আগত অনুরোধের সাথে মেলাতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:
- আপনার
DeepLinkMatcherইনস্ট্যান্স ইনস্ট্যানশিয়েট করুন। - আপনার সব
DeepLinkMatcherইনস্ট্যান্স কোলেট করুন, তা স্পষ্টভাবে হোক বা মাল্টিবাইন্ডিং ব্যবহার করে হোক। - ইনকামিং
IntentথেকেDeepLinkRequestতৈরি করো। - সব ম্যাচারের সাথে অনুরোধ ম্যাচ করুন এবং সেরা ম্যাচ খুঁজে নিন।
- ম্যাচের ফলাফল থেকে ব্যাক স্ট্যাক তৈরি করুন।
// 1. Instantiate your DeepLinkMatcher instances. val homeMatcher = StaticKeyDeepLinkMatcher(HomeKey, listOf(DeepLinkMatcher.actionFilter(Intent.ACTION_VIEW))) val userProfileMatcher = UriDeepLinkMatcher( DeepLinkUri("www.example.com/users/{id}"), serializer<UserProfileKey>() ).withBackStack { matchResult -> listOf(HomeKey, matchResult.key) } val telMatcher = TelDeepLinkMatcher() // 2. Collate all of your DeepLinkMatcher instances. // Note: Collating matchers with different generic types requires wildcards, // erasing the specific generic types. val deepLinkMatchers: List<DeepLinkMatcher<*, *>> = listOf( homeMatcher, userProfileMatcher, telMatcher ) class MainActivity : ComponentActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) // ... // 3. Create a DeepLinkRequest from the incoming Intent val request = DeepLinkRequest(intent = intent) // 4. Match the request against all matchers and find the best match. // Because DeepLinkMatcher.MatchResult implements Comparable, you can // use maxOrNull() to find the best match. val matchResult = deepLinkMatchers .mapNotNull { it.match(request) } // List<DeepLinkMatcher.MatchResult<*>> .maxOrNull() // DeepLinkMatcher.MatchResult<*>? // 5. Create the back stack from the match result (or fall back to a default). val backStack: List<NavKey> = when (matchResult) { // If no match is found, use the default back stack (e.g., HomeKey) null -> listOf(HomeKey) // If a BackStackMatchResult is found, use the back stack from the result is BackStackMatchResult<*, *> -> { // Because star-projected matchers erase the key type, cast the back stack to List<NavKey>. @Suppress("UNCHECKED_CAST") matchResult.backStack as List<NavKey> } // Otherwise, use the key from the match result to make a single-item back stack else -> listOf(matchResult.key as NavKey) } } }