शुरू करना

Navigation 3 का इस्तेमाल शुरू करने के लिए, अपने प्रोजेक्ट में लाइब्रेरी के साथ-साथ, काम करने वाली सभी लाइब्रेरी जोड़ें. नीचे दी गई टेबल की मदद से तय करें कि कौनसी लाइब्रेरी जोड़नी हैं.

कलाकृतियां

नाम

यह क्या करता है

आर्टफ़ैक्ट

Navigation 3 की रनटाइम लाइब्रेरी

Core Navigation 3 API. इसमें NavEntry, EntryProvider और उससे जुड़ा डीएसएल शामिल है.

androidx.navigation3:navigation3-runtime

Navigation 3 यूज़र इंटरफ़ेस (यूआई) लाइब्रेरी

कॉन्टेंट दिखाने के लिए क्लास उपलब्ध कराता है. इनमें NavDisplay और Scene शामिल हैं.

androidx.navigation3:navigation3-ui

नेविगेशन 3 के लिए ViewModel का लाइफ़साइकल

इससे ViewModels को बैक स्टैक में मौजूद एंट्री के दायरे में रखा जा सकता है.

androidx.lifecycle:lifecycle-viewmodel-navigation3

स्नैपशॉट बिल्ड में उपलब्ध है

नेविगेशन 3 के लिए, मटीरियल 3 के अडैप्टिव लेआउट

NavDisplay के साथ इस्तेमाल करने के लिए, अडैप्टिव लेआउट (SceneStrategies, Scenes, और मेटाडेटा की परिभाषाएं) उपलब्ध कराता है.

androidx.compose.material3.adaptive:adaptive-navigation3

स्नैपशॉट बिल्ड में उपलब्ध है

KotlinX सीरियलाइज़ेशन

नेविगेशन बटन को क्रम से लगाने की अनुमति देता है.

प्लग इन: org.jetbrains.kotlin.plugin.serialization

लाइब्रेरी:

org.jetbrains.kotlinx:kotlinx-serialization-core

org.jetbrains.kotlinx:kotlinx-serialization-json

प्रोजेक्ट सेटअप करना

अपने मौजूदा प्रोजेक्ट में Navigation 3 लाइब्रेरी जोड़ने के लिए, अपने libs.versions.toml में यह जोड़ें:

[versions]
nav3Core = "1.0.0-alpha01"
nav3Material = "1.0.0-SNAPSHOT"
nav3Lifecycle = "1.0.0-alpha01"
kotlinSerialization = "2.1.21"
kotlinxSerializationCore = "1.8.1"

[libraries]
# Core Navigation 3 libraries
androidx-navigation3-runtime = { module = "androidx.navigation3:navigation3-runtime", version.ref = "nav3Core" }
androidx-navigation3-ui = { module = "androidx.navigation3:navigation3-ui", version.ref = "nav3Core" }

# Optional add-on libraries
androidx-material3-navigation3 = { group = "androidx.compose.material3.adaptive", name = "adaptive-navigation3", version.ref = "nav3Material" }
androidx-lifecycle-viewmodel-navigation3 = { module = "androidx.lifecycle:lifecycle-viewmodel-navigation3", version.ref = "nav3Lifecycle" }
kotlinx-serialization-core = { module = "org.jetbrains.kotlinx:kotlinx-serialization-core", version.ref = "kotlinxSerializationCore" }
kotlinx-serialization-json = { module = "org.jetbrains.kotlinx:kotlinx-serialization-json", version.ref = "kotlinxSerializationCore" }

[plugins]
# Optional plugins
jetbrains-kotlin-serialization = { id = "org.jetbrains.kotlin.plugin.serialization", version.ref = "kotlinSerialization"}

अपने ऐप्लिकेशन की बिल्ड फ़ाइल app/build.gradle.kts में यह कोड जोड़ें:

plugins {
    ...
    // Optional, provides the @Serialize annotation for autogeneration of Serializers.
    alias(libs.plugins.jetbrains.kotlin.serialization)
}

dependencies {
    ...
    implementation(libs.androidx.navigation3)
    implementation(libs.androidx.lifecycle.viewmodel.navigation3)
    implementation(libs.androidx.material3.navigation3)
    implementation(libs.kotlinx.serialization.core)
    implementation(libs.kotlinx.serialization.json)
}