Navigation 3 में, मेटाडेटा का इस्तेमाल करके लाइब्रेरी के अलग-अलग कॉम्पोनेंट के बीच कोई भी जानकारी शेयर की जा सकती है. जैसे, NavEntry, Scene, और NavDisplay. मेटाडेटा, Map<String, Any> होता है.
हालांकि, लाइब्रेरी अतिरिक्त ऐब्स्ट्रैक्शन उपलब्ध कराती है, ताकि मेटाडेटा को पढ़ना और लिखना आसान और ज़्यादा टाइप-सेफ़ हो सके.
NavEntry का मेटाडेटा जोड़ें
अगर आपका ऐप्लिकेशन सीधे तौर पर NavEntry इंस्टेंस बनाता है, तो metadata कंस्ट्रक्टर पैरामीटर का इस्तेमाल करके, एंट्री के लिए मेटाडेटा दें:
when (key) { is Home -> NavEntry(key, metadata = mapOf("key" to "value")) {} }
अगर आपका ऐप्लिकेशन entryProvider डीएसएल का इस्तेमाल करता है, तो आपको entry फ़ंक्शन के metadata पैरामीटर की मदद से मेटाडेटा देना होगा. इस फ़ंक्शन के दो ओवरलोड हैं: पहला, जो सीधे तौर पर मैप लेता है और दूसरा, जो लैम्ब्डा लेता है. यह लैम्ब्डा, एंट्री की कुंजी को आर्ग्युमेंट के तौर पर पास करता है:
entry<Home>(metadata = mapOf("key" to "value")) { /* ... */ } entry<Conversation>(metadata = { key: Conversation -> mapOf("key" to "value: ${key.id})") }) { /* ... */ }
Scene का मेटाडेटा जोड़ें
डिफ़ॉल्ट रूप से, Scene.metadata, कस्टम गेटर का इस्तेमाल करता है. यह अपनी entries प्रॉपर्टी में आखिरी एंट्री का metadata दिखाता है. अगर यह null है, तो खाली मैप दिखाता है. Scene इंटरफ़ेस को लागू करते समय, ज़रूरत के हिसाब से इस डिफ़ॉल्ट ऐक्शन और सेटिंग को बदला जा सकता है.
मेटाडेटा डीएसएल का इस्तेमाल करना
लाइब्रेरी के 1.1.0-beta01 रिलीज़ में पेश किया गया मेटाडेटा डोमेन-स्पेसिफ़िक लैंग्वेज (डीएसएल), मेटाडेटा को सेव करने के लिए इस्तेमाल किए जाने वाले Map<String, Any> को बनाने के लिए, टाइप-सेफ़ बिल्डर उपलब्ध कराता है.
मेटाडेटा कुंजियों के बारे में जानकारी
डीएसएल, NavMetadataKey इंटरफ़ेस का इस्तेमाल करता है, ताकि मेटाडेटा कुंजी से जुड़ी वैल्यू का टाइप एक जैसा रहे.
मेटाडेटा कुंजियों को तय करने का तरीका यह है कि उन्हें क्लास के नेस्ट किए गए ऑब्जेक्ट के तौर पर शामिल किया जाए. इसके अलावा, फ़ंक्शन या कंपोज़ेबल के मामले में, उनसे जुड़ा कोई ऑब्जेक्ट शामिल किया जाए, जो उन कुंजियों से जुड़ी वैल्यू को पढ़ेगा:
// For classes such as scene strategies or nav entry decorators, you can define the keys // as nested object. class MySceneStrategy<T : Any> : SceneStrategy<T> { // ... object MyStringMetadataKey : NavMetadataKey<String> } // An example from NavDisplay. // Because NavDisplay is a function, the metadata keys are defined in an object with the same name. public object NavDisplay { public object TransitionKey : NavMetadataKey<AnimatedContentTransitionScope<Scene<*>>.() -> ContentTransform> }
डीएसएल का इस्तेमाल करके मेटाडेटा बनाना
मेटाडेटा मैप बनाने के लिए, metadata फ़ंक्शन का इस्तेमाल करें. यह फ़ंक्शन, लैम्ब्डा पैरामीटर लेता है. इस लैम्डा में, put फ़ंक्शन का इस्तेमाल करके, NavMetadataKey और उससे जुड़ी वैल्यू का इस्तेमाल करके मैप में एंट्री जोड़ें.
entry<Home>( metadata = metadata { put(NavDisplay.TransitionKey) { fadeIn() togetherWith fadeOut() } // An additional benefit of the metadata DSL is the ability to use conditional logic if (condition) { put(MySceneStrategy.MyStringMetadataKey, "Hello, world!") } } ) { // ... }
मेटाडेटा कुंजियों का इस्तेमाल करके मेटाडेटा पढ़ना
मेटाडेटा डीएसएल, NavMetadataKey की मदद से मेटाडेटा को आसानी से पढ़ने के लिए फ़ंक्शन भी उपलब्ध कराता है.
// import androidx.navigation3.runtime.contains // import androidx.navigation3.runtime.get val hasMyString: Boolean = metadata.contains(MySceneStrategy.MyStringMetadataKey) val myString: String? = metadata[MySceneStrategy.MyStringMetadataKey]